API ReferenceCategories

Get Material Category

Returns a single material category by ID, including nested subcategories.

Requires scope: categories:read

Authentication

API_KEYstring
API Key authentication via header

Path parameters

idUUIDRequired
Category ID.

Response

This endpoint returns an object.
idUUID
Unique identifier for the category.
namestring
Display name of the category.
subCategorieslist of objects
Immediate child categories nested under this category.
typestringOptional
Category type classification.
parentIdUUIDOptional

ID of the parent category, if this is a sub-category.

updatedAtdatetimeOptional
ISO 8601 timestamp when the record was last updated.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Rate Limit Error