---
title: "Topics"
method: GET
path: "/v1/topics/all"
tags: ["v1"]
---

# Topics

`GET /v1/topics/all`

Search through all available Topics that exist within the Perigon Database.

## Query parameters

- `name` string
- `category` string
- `subcategory` string
- `page` integer
- `size` integer

## Response `200`

200 - Success

- TopicSearchResult — Topic search result
  - `total` integer, required
  - `data` TopicDto[], required
    - `id` integer, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
    - `name` string, nullable
    - `labels` TopicLabels
      - `category` string, nullable
      - `subcategory` string, nullable

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Invalid API Key
- `403` — 403 - Request Forbidden
- `429` — 429 - Too Many Requests
- `500` — 500 - Server Error

## Changes

- **2025-08-18** `a73a3b58ca66` — 1 breaking, 22 warning, 78 info
  - the `status` response's property type/format changed from `string`/`` to `integer`/`int32` for status `429`
  - removed the optional property `cause` from the response with the `400` status
  - removed the optional property `cause` from the response with the `401` status
  - removed the optional property `cause` from the response with the `403` status
  - …97 more
- **2025-08-04** `3eb8ae4622b8` — 2 breaking, 2 warning, 1 info
  - the response property `data/items/labels` became nullable for the status `200`
  - the `data/items/labels` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data/items/labels/category` from the response with the `200` status
  - removed the optional property `data/items/labels/subcategory` from the response with the `200` status
  - …1 more
- **2025-07-31** `556127fafa6a` — 1 info
  - api tag `Supplemental Endpoints` removed
- **2025-06-04** `52b02cb25532` — 1 info
  - api tag `Supplemental Endpoints` added
- **2025-05-08** `ae72ecd67fb1` — 2 info
  - the response property `data` became required for the status `200`
  - the response property `total` became required for the status `200`

[Change history](https://skmtc.dev/goperigon/apis/perigon-api/changes/v1/topics/all/get.md)

---

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