---
title: "Get all default and custom integration-level categories"
method: GET
path: "/categories"
tags: ["Category Personalization"]
---

# Get all default and custom integration-level categories

`GET /categories`

Fetch categories from Spade's database.

This endpoint returns a list containing Spade's default categories, plus any custom integration-level categories you've created.

To learn more about category personalization, please read the [Category Personalization Guide](https://docs.spade.com/reference/category-personalization-guide).

## Query parameters

- `include` string

## Response `200`

Successful operation

- MerchantCategory[] — An array of categories. Spade categories are returned first, followed by custom categories.
  - `id` string — A unique identifier for this category. This identifier will show up in enrichments as `counterparty[i].industry[-1].id`, where `i` is the index of this merchant in the counterparty list. Note that each counterparty's `industry` is a list containing its full category hierarchy (including parent categories); thus, this category will be the last one in the `industry` list.
  - `name` string — The category's name
  - `icon` string, url, nullable — The category's icon
  - `fullCategoryHierarchy` IndustryCategoryLevel[] — Array with increasingly specific category information.
    - `id` string
    - `name` string
    - `icon` string, url, nullable — Category icon.

## Other responses

- `403` — Unauthorized
- `500` — Unexpected Error

---

[API](https://skmtc.net/spade/apis/spade-api.md) · [All operations](https://skmtc.net/spade/apis/spade-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spade/spade-api/versions/a37c626f84de/schema)