List Voices (Paginated)

FreshGET

GET https://api.creatify.ai/api/voices/paginated/

Retrieve voices with pagination support. Use this instead of the standard list endpoint when working with large voice libraries.

Query Parameters

Name	Type	Required	Description
page	integer	No	Page number (starts at 1). Defaults to 1
page_size	integer	No	Number of items per page. Defaults to 20
language	string	No	Filter by language code (e.g., en, es, fr)
gender	string	No	Filter by gender (male, female)

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key

Example Request

curl -X GET 'https://api.creatify.ai/api/voices/paginated/?page=1&page_size=10&language=en' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

{
  "count": 150,
  "page": 1,
  "page_size": 10,
  "results": [
    {
      "id": "voice-en-001",
      "name": "Sarah",
      "language": "en",
      "accent": "American",
      "gender": "female",
      "preview_url": "https://cdn.creatify.ai/voices/sarah-preview.mp3"
    }
  ]
}

Response Fields

Field	Type	Description
count	integer	Total number of voices matching the filter
page	integer	Current page number
page_size	integer	Items per page
results	array	Array of voice objects

Status Codes

Code	Description
200	Success
401	Unauthorized -- invalid API credentials
429	Rate limit exceeded
500	Internal server error

TIP

Use the language and gender filters to narrow results. This is more efficient than fetching all voices and filtering client-side.