GET
/api/v1/catalog/categoriesList active categories
Required scope:
categories:readBearer tokenEnvironments
- SANDBOX
- Authorized local or test environment; no public hosted Sandbox is currently offered.
- PRODUCTION
https://getsas.xyz/api/v1/catalog/categories
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <ACCESS_TOKEN> | Yes |
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| limit | query | integer | Reject invalid, out-of-range or repeated values. |
| before | query | string · date-time | Pass with before_id from meta.next_cursor. Preserve the complete timestamp including microseconds. |
| before_id | query | string · uuid | Required together with before; stable ordering uses created_at and id descending. |
Code examples
curl --request GET 'https://getsas.xyz/api/v1/catalog/categories' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'Response
200 A tenant-isolated page with the exact documented fields.
{
"description": "A tenant-isolated page with the exact documented fields.",
"headers": {
"RateLimit-Limit": {
"$ref": "#/components/headers/RateLimitLimit"
},
"RateLimit-Remaining": {
"$ref": "#/components/headers/RateLimitRemaining"
},
"RateLimit-Reset": {
"$ref": "#/components/headers/RateLimitReset"
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CategoryPage"
}
}
}
}Errors
| 400 | Invalid request |
| 401 | Missing or invalid access token |
| 403 | The route, scope and reviewed contract do not match an operation this token can use (unsupported_capability) |
| 404 | The record does not exist in the installation store (records of other stores are indistinguishable), or the Marketplace API is unavailable |
| 429 | Fixed-window request limit exceeded for this installation and route key |
| 500 | Internal API failure |
| 503 | Rate-limit service unavailable; request is rejected closed |