Cobalt Docs
Api referenceCategories

List categories

Returns the spending category taxonomy for the user — both system-seeded categories and user-created ones.

GET
/categories

Authorization

bearerAuth
AuthorizationBearer <token>

Cobalt API key (prefix ck_live_). Issue from dashboard → Settings → API keys.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/categories"
{
  "categories": [
    {
      "excludeFromInsights": true,
      "groupId": "string",
      "hidden": true,
      "iconKey": "string",
      "id": "string",
      "name": "string",
      "systemKey": "string"
    }
  ],
  "groups": [
    {
      "id": "string",
      "name": "string",
      "systemKey": "string"
    }
  ]
}
{
  "code": "string",
  "error": "string"
}