---
title: "Get all categories for IPTC Media Topics"
method: GET
path: "/categories/iptc-media-topics"
tags: ["Categories"]
deprecated: true
---

# Get all categories for IPTC Media Topics

`GET /categories/iptc-media-topics`

## Request

- Base URL: `https://api.signal-ai.com`
- URL: `https://api.signal-ai.com/categories/iptc-media-topics`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.signal-ai.com/auth/token` scopes: `default`
- TypeScript: <https://skmtc.dev/signal-ai/apis/signal-ai-api/docs/categories/iptc-media-topics/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

## Response `200`

Returns all categories for IPTC Media Topics.

- CategoriesResponse
  - `categories` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `external-uri` string, required
    - `parent` string, uuid
    - `children` ResourceId[]
    - `beta` boolean: If provided and true, then the classification quality for this category is not guaranteed
    - `unavailable` boolean: If provided and true, the Signal platform does not currently recognise this category

---

[API](https://skmtc.dev/signal-ai/apis/signal-ai-api.md) - [All operations](https://skmtc.dev/signal-ai/apis/signal-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal-ai/apis/signal-ai-api/revisions/0ab7ff186291?raw)
