Skip to main content
GET
List the character assets of the calling principal
Returns the most recently created active Characters owned by the current account, newest first. Use the returned id in POST /v1/renders after the Character is ready.

Request parameters

GET /v1/characters has no path, query, or request-body parameters. Send Authorization: Bearer YOUR_API_KEY.

Response parameters

Returns 200 OK. The page is capped at 100 items and carries no cursor — there is no way to reach older Characters through this endpoint.

Examples

Authorizations

Authorization
string
header
required

Server-side SDK clients use a project API key. Remote MCP clients use an OAuth access token. Never expose a project API key in browser code.

Headers

X-Request-Id
string

Optional caller-supplied correlation ID, up to 128 characters. The service returns the effective value in the response header for tracing and support.

Required string length: 1 - 128
X-Viggle-Source
string

Optional source-channel label, up to 128 characters, used to attribute traffic to an SDK, integration, product surface, or internal workflow.

Required string length: 1 - 128

Response

The character assets owned by the calling principal.

An unpaginated page. At most 100 assets are returned, newest first, and there is no way to reach older ones.

data
object[]
required

Up to 100 active assets owned by the caller, ordered newest first.