Skip to main content
GET
/
characters
/api/v1/characters
curl --request GET \
  --url https://api.venice.ai/api/v1/characters \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "adult": false,
      "createdAt": "2024-12-20T21:28:08.934Z",
      "description": "Alan Watts (6 January 1915 – 16 November 1973) was a British and American writer, speaker, and self-styled \"philosophical entertainer\", known for interpreting and popularizing Buddhist, Taoist, and Hindu philosophy for a Western audience.",
      "name": "Alan Watts",
      "shareUrl": "https://venice.ai/c/alan-watts",
      "photoUrl": "https://outerface.venice.ai/api/characters/2f460055-7595-4640-9cb6-c442c4c869b0/photo",
      "slug": "alan-watts",
      "stats": {
        "imports": 112
      },
      "tags": [
        "AlanWatts",
        "Philosophy",
        "Buddhism",
        "Taoist",
        "Hindu"
      ],
      "updatedAt": "2025-02-09T03:23:53.708Z",
      "webEnabled": true,
      "modelId": "venice-uncensored"
    }
  ],
  "object": "list"
}

​
Experimental Endpoint

This is an experimental endpoint and may be subject to change.

​
Postman Collection

For additional examples, please see this Postman Collection.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
categories

Filter by category names

Example:

"roleplay"

​
isAdult
enum<string>

Filter by adult content flag

Available options:
true,
false
Example:

"false"

​
isPro
enum<string>

Filter to only show characters using pro models

Available options:
true,
false
Example:

"false"

​
isWebEnabled
enum<string>

Filter to only show web-enabled characters

Available options:
true,
false
Example:

"true"

​
limit
integer
default:50

Number of characters to return (max: 100)

Required range: 0 < x <= 100
Example:

50

​
modelId

Filter by model ID(s)

Example:

"llama-3.3-70b"

​
offset
integer | null
default:0

Number of characters to skip for pagination

Required range: x >= 0
Example:

0

​
search
string

Search characters by name or description

Example:

"assistant"

​
tags

Filter by tag names

Example:

"helpful"

Response

OK

​
data
object[]
required
​
object
enum<string>
required
Available options:
list