Skip to main content
GET
/
categories
Categories
curl --request GET \
  --url https://api.example.com/categories

​
Endpoints

GET /categories
GET /categories/:id-or-slug
Taxonomy scope:
  • Categories are available only at root (/categories) and apply to articles content.
  • Collection-specific taxonomy endpoints are not supported.

​
List query parameters

ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger10Items per page
searchstring-Search by name or slug
orderbystringnameSort by name, slug, id, date, created_at
orderstringdescasc or desc
_fieldsstring-Comma-separated attribute field filter

​
Example list request

curl "https://api.skayle.ai/v1/ORG_ID/categories?page=1&per_page=20&orderby=name&order=asc"

​
Example list response

{
  "data": [
    {
      "id": "cat_01HZX...",
      "type": "categories",
      "attributes": {
        "name": "Content Strategy",
        "slug": "content-strategy",
        "post_count": 18,
        "created_at": "2025-12-10T08:01:00.000Z",
        "updated_at": "2026-01-20T09:15:00.000Z"
      },
      "relationships": {
        "articles": {
          "data": null,
          "links": {
            "related": "/v1/ORG_ID/articles?categories=cat_01HZX..."
          }
        }
      },
      "links": {
        "self": "/v1/ORG_ID/categories/cat_01HZX..."
      }
    }
  ],
  "meta": {
    "total": 12,
    "per_page": 20,
    "page": 1
  }
}

​
Example single request

curl "https://api.skayle.ai/v1/ORG_ID/categories/content-strategy"

​
Single not found

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Category with id or slug \"content-strategy\" not found"
    }
  ]
}

​
Response field descriptions

FieldTypeDescription
data[].idstringCategory ID
data[].typestringResource type (categories)
data[].attributes.namestringCategory display name
data[].attributes.slugstringCategory slug
data[].attributes.post_countnumberPublished article count for this category
data[].attributes.created_atstringISO datetime
data[].attributes.updated_atstringISO datetime
data[].relationships.articlesobjectRelated filtered items feed
meta.totalnumberTotal categories
meta.per_pagenumberPage size
meta.pagenumberCurrent page

​
Filtering and pagination

  • search filters by category name/slug.
  • page and per_page control pagination.
  • orderby and order control sorting.

​
Error responses

  • 404 when single category ID/slug is not found.