Brands

List the brands of your organization and choose which one an endpoint works in.

Every job runs inside a brand, exactly as in the Pixii app. Most organizations have one brand; agencies and large catalogs have several. Use this endpoint to list them, then pass brand_id to any endpoint to choose the brand it works in. Omit brand_id and Pixii uses your default brand, the oldest one in your organization.

Endpoint

GET /v2/api/brands

Response fields

Field	Type	Description
`brands[].brand_id`	number	The id to pass as `brand_id`.
`brands[].name`	string	The brand name shown in the Pixii app.
`brands[].is_default`	boolean	`true` on the brand used when a request has no `brand_id`.
`brands[].created_at`	string	ISO 8601 timestamp of when the brand was created. Oldest first.

A request with a brand_id that is not one of these ids fails with 404 and BRAND_NOT_FOUND. Every job response reports the brand_id it runs in.

Errors

Code	HTTP	Description
`UNAUTHORIZED`	401	Missing or invalid API key

List brands

curl https://api.pixii.ai/v2/api/brands \
-H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

import requests

response = requests.get(
"https://api.pixii.ai/v2/api/brands",
headers={"Authorization": "Bearer pk_live_xxxxxxxxxxxx"},
)

Response json

{

"success": true,
"data": {
"brands": [
{
"brand_id": 42,
"name": "Acme Kitchen",
"is_default": true,
"created_at": "2026-03-12T09:14:05Z"
},
{
"brand_id": 57,
"name": "Acme Outdoor",
"is_default": false,
"created_at": "2026-07-01T16:40:22Z"
}
]
},
"error": null
}

Error response json

{

"success": false,
"data": null,
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"detail": null
}
}

See the errors reference for the full list of error codes and how to handle them.