GET /v1/projects/:projectId/influencers

GET/v1/projects/:projectId/influencers

Phase 1stable

Auth: Bearer
Scope: influencers:write

Returns influencers for the project, newest first. Soft-deleted (archived) influencers are excluded; there is no includeArchived flag. Results are cursor-paginated.

Path parameters

projectId
string (uuid)required
The project to list influencers for.

Query parameters

cursor
stringoptional
Opaque cursor from the previous page.
limit
integeroptionaldefault: 25
Page size, 1-100.
status
stringoptional
Filter by status.
One of: draft, pending, training, ready, failed

Request

terminal

curl "https://api.layers.com/v1/projects/{projectId}/influencers?limit=25" \
  -H "X-Api-Key: $LAYERS_API_KEY"

list-influencers.ts

const res = await fetch(
  `https://api.layers.com/v1/projects/${projectId}/influencers?limit=25`,
  { headers: { 'X-Api-Key': process.env.LAYERS_API_KEY! } },
);
const { items, nextCursor } = await res.json();

list_influencers.py

import os, httpx

r = httpx.get(
    f"https://api.layers.com/v1/projects/{project_id}/influencers",
    params={"limit": 25},
    headers={"X-Api-Key": os.environ["LAYERS_API_KEY"]},
)
data = r.json()

Responses

200Page of influencer list items.

{
  "items": [
    {
      "influencerId": "inf_01HXZ9...",
      "name": "Ava Chen",
      "gender": "female",
      "ageRange": "25-34",
      "status": "ready",
      "thumbnailUrl": "https://media.layers.com/.../ava-thumb.jpg",
      "createdAt": "2026-04-01T14:22:10Z"
    }
  ],
  "nextCursor": null
}

404Project not found or not visible to this key.

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Project not found.",
    "requestId": "req_..."
  }
}

Notes

List-item shape is slim. It includes influencerId, name, gender, ageRange, status, thumbnailUrl, createdAt. For full identity fields (personality, style, reference images), fetch GET /v1/influencers/:influencerId.
Soft-deleted rows are hidden. There is no flag to include them — delete is effectively terminal from the partner surface.

Errors

Code	When
`UNAUTHENTICATED`	Missing or invalid API key.
`FORBIDDEN_SCOPE`	Key lacks `influencers:write`.
`NOT_FOUND`	Project id doesn't belong to this org.
`VALIDATION`	Invalid `limit`, `cursor`, or `status`.