---
title: "Get custom category"
method: GET
path: "/signal/custom_categories/{id}"
tags: ["signal"]
---

# Get custom category

`GET /signal/custom_categories/{id}`

Retrieve a single custom category with its example phrases.

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Custom category

- SignalCustomCategoryResponse
  - `success` boolean, required
  - `item` SignalCustomCategory, required
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `icon` string, nullable
    - `enabled` boolean — Whether the category is included in scoring.
    - `status` 'pending' | 'embedding' | 'ready' | 'needs_more_examples' | 'failed'
    - `embed_error` string, nullable — Error message when `status` is `failed`.
    - `embedded_at` string, date-time, nullable
    - `scenario_count` integer
    - `embedding_model_version` string, nullable
    - `overlaps` SignalCustomCategoryOverlapsItems[] — Calibration warnings where this category was confused with another.
    - `scenarios` SignalScenario[]
      - `id` integer
      - `text` string
      - `embedded` boolean — Whether this example has finished embedding.

## Other responses

- `404` — Category not found

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)