Skip to main content
GET
/
api
/
v1
/
categories
List categories
curl --request GET \
  --url http://localhost:3000/api/v1/categories \
  --header 'Authorization: Bearer <token>'
{
  "categories": [
    {
      "id": "cat_business12",
      "name": "Business",
      "description": "General business news and updates."
    },
    {
      "id": "cat_tech123456",
      "name": "Technology",
      "description": "Technology sector news and innovations."
    }
  ],
  "pagination": {
    "count": 2,
    "next_cursor": null
  }
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Headers

Authorization
string
required

Bearer token for authentication

Query Parameters

limit
integer

Number of categories to return per page (default 25, max 100).

cursor
string

Opaque pagination cursor from a previous response.

fields
string

Comma-separated list of fields to include. Available fields: id, name, description.

Response

Categories retrieved successfully

categories
object[]
required
pagination
object