Get all categories with their topics

Fetches all categories along with their associated topics, providing a hierarchical view of your taxonomy structure for easier management and navigation

GET /categories/all

Try it

Get all categories with their topics

cURL

curl --request GET \
  --url https://sdk.senso.ai/api/v1/categories/all \
  --header 'X-API-Key: <api-key>'

200

[
  {
    "category_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "topics": [
      {
        "topic_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "category_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "description": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
]

Authorizations

X-API-Key · string · header · required

API key authorization

Response

200

application/json

All categories with their topics successfully retrieved

category_id · string<uuid>

The unique identifier of the category

name · string

The name of the category

description · string

Description of the category's purpose or contents

created_at · string<date-time>

The timestamp when the category was created

updated_at · string<date-time>

The timestamp when the category was last updated

deleted_at · string<date-time> | null

The timestamp when the category was deleted, if applicable (null if not deleted)

topics · object[]

List of topics belonging to this category

Show child attributes

topics. topic_id · string<uuid>

The unique identifier of the topic

topics. category_id · string<uuid>

The unique identifier of the category this topic belongs to

topics. name · string

The name of the topic

topics. description · string

Description of the topic's purpose or contents

topics. created_at · string<date-time>

The timestamp when the topic was created

topics. updated_at · string<date-time>

The timestamp when the topic was last updated

topics. deleted_at · string<date-time> | null

The timestamp when the topic was deleted, if applicable (null if not deleted)