> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Influencers

> List influencers (consistent characters) and their reference images

Returns every influencer visible to the authenticated key scope.

An influencer is a consistent character: one or more reference images of a
person, reused to generate new images of that person. The response does not
distinguish how the character was created.

## Query Parameters

<ParamField query="limit" type="number" default="20">
  Number of influencers to return. Range: `1-50`.
</ParamField>

## Response

<ResponseField name="influencers" type="array">
  Influencer list, newest created first.

  <Expandable title="Influencer Object">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="reference_image_urls" type="string[]" />

    <ResponseField name="created_at" type="string" />

    <ResponseField name="updated_at" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="limit" type="number" />

<ResponseField name="has_more" type="boolean" />

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://www.genviral.io/api/partner/v1/influencers?limit=20' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Influencers retrieved",
    "data": {
      "influencers": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "name": "Maya",
          "reference_image_urls": [
            "https://cdn.example.com/maya.jpg"
          ],
          "created_at": "2026-08-24T12:00:00.000Z",
          "updated_at": "2026-08-24T12:00:00.000Z"
        }
      ],
      "limit": 20,
      "has_more": false
    }
  }
  ```
</ResponseExample>

## Error Responses

* `422 invalid_query` - query params failed validation
* `401` - authentication failed