List replicas

GET /v1/replicas

List replicas with pagination with optional filtering. Only Replicas that are public or belong to the authenticated user are returned.

Headers

Query parameters

  • Filters by the owner UUID of the Replicas

  • page_index integer

    Pagination: The page index to return

    Default value is 1.

  • page_size integer

    Pagination: The number of items per page

    Default value is 24.

  • slug string

    Filters by the replica's slug

  • tags array[string]

    Filters by tags associated to Replicas

    Values are AI, Academic, Arts, Blockchain, Business, Celebrity, Charity, Developer, Educator, Europe, Fashion, Finance, Food, Health & Fitness, History, Italian, Kids, Language, Law, Leadership, Lifestyle, Literature, Love, Military, Modelling, Motivation, Movies, Music, North America, Philosophy, Politics, Religion, Science, Self-Help, Sensay, Sports, Technology, Web, Wisdom, blockchain, engage2earn, female, investment, male, meme, miniapp, telegram, or web3.

  • sort string

    Sorts by name or popularity of Replicas in ascending order

    Values are name or popularity. Default value is name.

  • Filters by integration

    Values are telegram or discord.

Responses

  • 200 application/json

    List of Replicas

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • type string Required
    • items array[object] Required

      Array of replica items for the current page. Will be an empty array if no items exist.

      Hide items attributes Show items attributes object
      • uuid string | null Required

        The UUID of the Replica

      • name string | null Required

        The Name of the Replica

      • slug string | null Required

        The Slug of the Replica

      • profile_image string | null Required

        The URL of the profile image of the Replica

      • short_description string | null Required

        The description of the Replica

      • introduction string | null Required

        The introduction of the Replica

      • tags array[string] | null Required

        The Tags associated to the Replica

      • created_at string | null Required

        The date and time the Replica was created

      • owner_uuid string | null Required

        The UUID of the owner of the Replica

      • voice_enabled boolean Required

        Does replica have voice support

      • video_enabled boolean Required

        Does replica have video support

      • chat_history_count integer | null Required

        The number of completions of the Replica

      • system_message string Required

        The replica's tone, personality and behaviour

      • discord_integration object | null Required

        The Discord integration of the Replica

        Hide discord_integration attributes Show discord_integration attributes object | null
      • telegram_integration object | null Required

        The Telegram integration of the Replica

        Hide telegram_integration attributes Show telegram_integration attributes object | null
    • total integer Required

      The total number of replica items available across all pages

  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • A unique identifier of the event, useful for reporting

    • request_id string Required

      A unique identifier of the request, useful for reporting

  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • A unique identifier of the event, useful for reporting

    • request_id string Required

      A unique identifier of the request, useful for reporting

  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • request_id string Required

      A unique identifier of the request, useful for reporting

  • 415 application/json

    Unsupported Media Type

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • A unique identifier of the event, useful for reporting

    • request_id string Required

      A unique identifier of the request, useful for reporting

  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates the status of the request

    • error string Required

      A text representation of the error

    • A unique identifier of the event, useful for reporting

    • request_id string Required

      A unique identifier of the request, useful for reporting

    • The inner exception

      Hide inner_exception attributes Show inner_exception attributes object
GET /v1/replicas
curl \
 --request GET 'https://api.sensay.io/v1/replicas' \
 --header "X-ORGANIZATION-SECRET: $API_KEY" \
 --header "X-USER-ID: $API_KEY" \
 --header "X-API-Version: 2025-03-25"
Response examples (200)
{
  "success": true,
  "type": "string",
  "items": [
    {
      "name": "Example Replica",
      "slug": "copy",
      "tags": [
        "AI",
        "Technology"
      ],
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2023-10-01T12:00:00Z",
      "owner_uuid": "123e4567-e89b-12d3-a456-426614174001",
      "introduction": "This is an example replica",
      "profile_image": "http://example.com/image.png",
      "video_enabled": true,
      "voice_enabled": true,
      "system_message": "Descriptive, energetic, friendly",
      "short_description": "Celebrity",
      "chat_history_count": 5,
      "discord_integration": {
        "token": "MTk4NjIyNDgzNDcxOTI1MjQ4.Cl2FMQ.ZnCjm1XVW7vRze4b7Cq4se7kKWs",
        "is_active": true,
        "service_name": "test_discord_bot"
      },
      "telegram_integration": {
        "token": "7701101112:DASeKD32EQLL32113-ngfVUMkyzg",
        "service_name": "test_telegram_bot"
      }
    }
  ],
  "total": 100
}
Response examples (400)
{
  "success": true,
  "error": "string",
  "fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (401)
{
  "success": true,
  "error": "string",
  "fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (404)
{
  "success": true,
  "error": "string",
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (415)
{
  "success": true,
  "error": "string",
  "fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab"
}
Response examples (500)
{
  "success": true,
  "error": "string",
  "fingerprint": "14fceadd84e74ec499afe9b0f7952d6b",
  "request_id": "xyz1::reg1:reg1::ab3c4-1234567890123-0123456789ab",
  "inner_exception": {
    "name": "Server overheated",
    "cause": "Request too complicated",
    "stack": "Error: Server overheated due to an unexpected situation\n    at Object.eval (eval at <anonymous>...",
    "message": "The server overheated due to an unexpected situation"
  }
}