Skip to contentDevelopersPrezly website
Newsroom categories

List Newsroom Categories

Read the categories belonging to a newsroom and reuse their returned IDs.

Personal token scopes: sites:read. Your account must also have access to the requested data. Authentication

Read the guide

GET
/newsrooms/{newsroom_id}/categories

Get categories for a newsroom

Personal access tokens: sites:read. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length

Query Parameters

sort?string
Match[-+]?(\w+\.)*\w+

Response Body

OK

application/json
  1. response
categories?array<>
Example Request
curl -X GET 'https://api.prezly.com/v2/newsrooms/string/categories'
Example Response200
{  "categories": [    {      "id": 0,      "display_name": "string",      "display_description": "string",      "i18n": {        "[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2})?": {          "name": "string",          "description": "string",          "slug": "string",          "locale": {            "code": "en",            "name": "string",            "direction": "ltr",            "language_code": "en",            "native_name": "string"          }        }      },      "stories_number": 0    }  ]}