Return a single category by its ID, scoped to your partner. Useful for confirming a category's name and description before referencing it in a send.
Endpoint and headers
Header | Value | Purpose |
|---|---|---|
X-INS-AUTH-KEY | API token, format INS.{id}.{secret} | Authentication |
Request parameter
Below is the parameter required for this request.
Parameter | Description | Data type | Required |
|---|---|---|---|
id | The integer ID of the category. | Integer | Yes |
Sample response
Below is a sample response for this request.
{
"id": 3,
"name": "order_confirmation",
"description": "Post-purchase confirmations",
"created_at": "2026-06-29T10:00:00Z"
}Keep in mind
A non-positive ID returns 400 invalid_id.
An ID that does not exist for the partner returns 404 not_found.
For all error codes, refer to the Error Codes.