# List available song categories

Returns a paginated list of song categories available to the tenant. Categories are used to organize and filter the music catalogue (e.g. genres, moods, or classification groups).

This endpoint is typically used to populate filters, dropdowns, or navigation elements in the catalogue UI.

Endpoint: GET /tenants/categories
Version: 1.0.0
Security: api-key

## Query parameters:

  - `page` (integer)

  - `size` (integer)

## Response 200 fields (application/json):

  - `content` (array)
    Page content

  - `content.id` (string)
    Category ULID

  - `content.name` (string)
    Category name (e.g. genre)

  - `content.type` (string)
    Category type
    Enum: "main", "secondary"

  - `number` (integer)

  - `size` (integer)
    Example: 10

  - `totalElements` (integer)
    Example: 42

  - `totalPages` (integer)
    Example: 5

## Response 400 fields (application/json):

  - `errorCode` (string)

  - `error` (string)
    e.g. Validation Failed

  - `title` (string)
    e.g. Invalid Parameter

  - `message` (string)

  - `details` (string,null)

  - `validationErrors` (object)

## Response 402 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)

## Response 404 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)

## Response 500 fields (application/json):

  - `errorCode` (string)

  - `title` (string)

  - `message` (string)

  - `ref` (string,null)

  - `validationErrors` (object)