List Custom Avatars (Paginated)

FreshGET

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

Retrieve custom avatars with pagination support.

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

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/personas/paginated/?page=1&page_size=10' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

{
  "count": 25,
  "page": 1,
  "page_size": 10,
  "results": [
    {
      "id": "persona-001",
      "name": "Company Spokesperson",
      "status": "active",
      "thumbnail": "https://cdn.creatify.ai/personas/persona-001-thumb.jpg",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Status Codes

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