GET/v1/export/creators

Export Creators

Exports the creator-typed subset of your managed clients: connected client workspaces whose latest confirmed account type is "creator", each with its latest IMPRS score. Scoping is identical to the clients export. Only workspaces under your verified agency hierarchy are returned. Authorization is tied to the API key owner. The owning account must be on the Agency plan or above, and the key must carry the "read" scope.

Bearer token required. "read" scope. Minimum plan: Agency (the key owner is tier-checked directly).

Request
curl -X GET "https://api.amilere.com/v1/export/creators" \
  -H "Authorization: Bearer prism_YOUR_API_KEY"
Response (200 OK)
{
  "scope": {
    "workspaceId": "ws_agency_001",
    "workspaceName": "Northwind Agency"
  },
  "count": 1,
  "creators": [
    {
      "workspaceId": "ws_client_077",
      "name": "Maya Chen",
      "accountType": "creator",
      "prismScore": 559,
      "imprsScore": 559,
      "grade": "strong",
      "scoredAt": "2026-06-21T08:05:00Z"
    }
  ]
}

Error Codes

401

Unauthorized

Missing, malformed, expired, or revoked API key.

403

Forbidden

Key lacks the "read" scope, or the key owner is not on an Agency plan or above.

429

Rate Limited

Per-key rate limit exceeded. Honour the Retry-After header.