---
title: "List categories"
method: GET
path: "/v1/categories"
tags: ["Categories"]
---

# List categories

`GET /v1/categories`

## Request

- Base URL: `https://api.triqai.com`
- URL: `https://api.triqai.com/v1/categories`
- Auth: API key in header `X-API-Key`

## Response `200`

Category reference list

- CategoryListResponse
  - `success` true, required
  - `data` object, required
    - `categories` CategoryInfo[], required
      - `name` string, required
      - `type` 'income' | 'expense' | 'transfer', required
      - `level` 1 | 2 | 3, required
      - `parent` string, nullable, required
      - `description` string, required
      - `mcc` integer
      - `sic` integer
      - `naics` integer
    - `total` integer, required
  - `meta` CategoryListMeta, required
    - `generatedAt` string, date-time, required
    - `requestId` string, required
    - `version` string, required
    - `categoryVersion` string, required

## Other responses

- `401`: Authentication failed or missing credentials
- `403`: Authenticated but not authorized
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api.md) - [All operations](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api/revisions/da1b24723e53?raw)