API ReferenceReference Data
Subcategories
List product subcategories or retrieve a single subcategory by ID
GET /api/v1/subcategories
Returns all active product subcategories. Requires the vouchers feature to be enabled.
Request
curl https://api.octopuscards.io/api/v1/subcategories \
-H "Authorization: Bearer <token>"No query parameters.
Response
[
{
"id": 1,
"name": "Steam"
},
{
"id": 2,
"name": "Free Fire"
}
]Response Fields
| Key | Type | Description |
|---|---|---|
id | integer | Unique subcategory identifier |
name | string | Subcategory name |
Only active subcategories are returned.
Errors
400 Bad Request - Vouchers feature is not enabled for your client.
{
"error": {
"name": "BadRequestError",
"code": "INVALID_FEATURE",
"message": "The requested feature is not enabled for this client"
}
}GET /api/v1/subcategories/:id
Returns a single subcategory by its ID. Requires the vouchers feature.
Request
curl https://api.octopuscards.io/api/v1/subcategories/1 \
-H "Authorization: Bearer <token>"Request Parameters
| Key | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Subcategory ID (path parameter) |
Response
{
"id": 1,
"name": "Steam"
}Response fields are identical to the list endpoint above.
Errors
400 Bad Request - Vouchers feature is not enabled for your client.
{
"error": {
"name": "BadRequestError",
"code": "INVALID_FEATURE",
"message": "The requested feature is not enabled for this client"
}
}