Skip to main content
POST
/
v1
/
groups
/
all
List All Groups
curl --request POST \
  --url https://api.thehyperstack.com/v1/groups/all \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 123,
  "page_size": 123
}
'
{
  "success": true,
  "total": 2,
  "page": 1,
  "page_size": 100,
  "groups": [
    {
      "title": "Cloud Certification",
      "group_id": "GcI6H5b66a3v",
      "description": "Awarded to cloud engineers who complete the certification program.",
      "website": "https://example.com/cloud",
      "group_code": "CC-2024"
    },
    {
      "title": "Security Fundamentals",
      "group_id": "Zvw1xPIqF7J7",
      "description": "Security basics course completion certificate.",
      "website": "",
      "group_code": "SF-2024"
    }
  ]
}

​
Description

This endpoint allows you to retrieve all credential groups belonging to your organization, with support for pagination.
Legacy endpoint: GET /v1/group/all is also supported for backward compatibility.

​
Headers

​
Authorization
string
required
Bearer YOUR_API_TOKEN — obtainable from Hyperstack Dashboard → Settings → API Access

​
Body Parameters

​
page
number
required
The page number for pagination (default is 1).
​
page_size
number
required
The number of groups to return per page (default is 100).

​
Success Response Fields

​
success
boolean
Indicates whether the request was successful.
​
total
number
Total number of credential groups in your organization.
​
groups
array[object]
Array of credential group objects. Each object contains:
  • title — group title
  • group_id — unique key of the group
  • description — group description
  • website — associated URL
  • group_code — short code for the group
​
page
number
Current page number.
​
page_size
number
Number of groups returned per page.

​
Responses

{
  "success": true,
  "total": 2,
  "page": 1,
  "page_size": 100,
  "groups": [
    {
      "title": "Cloud Certification",
      "group_id": "GcI6H5b66a3v",
      "description": "Awarded to cloud engineers who complete the certification program.",
      "website": "https://example.com/cloud",
      "group_code": "CC-2024"
    },
    {
      "title": "Security Fundamentals",
      "group_id": "Zvw1xPIqF7J7",
      "description": "Security basics course completion certificate.",
      "website": "",
      "group_code": "SF-2024"
    }
  ]
}

curl -X POST "https://api.thehyperstack.com/v1/groups/all" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "page_size": 100
  }'
Last modified on February 22, 2026