API Reference
API reference · Categories
GET
/categories
List Categories
Retrieve the template categories available to your account.
Authentication
This endpoint requires a bearer token. See Authentication and API Keys.
Headers
| Header | Required | Description |
|---|---|---|
| Authorization | required | Bearer <BEARER_TOKEN> |
Parameters
This endpoint takes no parameters.
Request body
Request body: None.
Request example
curl -X GET "https://toolkit.undersign.app/api/v1.1/categories" \ -H "Authorization: Bearer <BEARER_TOKEN>"
Response
A successful response returns the categories in data:
Successful response
{
"success": true,
"request_id": "...",
"timestamp": "...",
"data": []
}
Response fields
Each category record contains:
| Field | Description |
|---|---|
| category_id | Category identifier. |
| company_id | The company the category belongs to. |
| category_name | Category name. |
| category_sort_order | Sort order for the category. Categories are returned sorted by this value. |
Response status & error codes
| Code | Error code | Description |
|---|---|---|
200 OK |
- |
Categories retrieved, sorted by category_sort_order. |
429 |
RATE_LIMIT_EXCEEDED |
Exceeded 100 requests per minute. See Rate Limits. |
Implementation guidance
Use category_id to associate templates with their categories.