/v1/export/scoresExport Score History
Bulk-exports your raw IMPRS score-log history. The export is strictly scoped to your own tenant: your agency workspace plus every workspace whose parent is your agency (your connected clients). It can never return another tenant's private score data. Each row is labelled with the workspace it belongs to, never raw user IDs. Authorization is tied to the API key owner, not a session. 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).
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | Optional | Max rows to return, 1–1000. Default: 500. Newest first. |
since | string (ISO 8601) | Optional | Only return score logs recorded on or after this timestamp. |
curl -X GET "https://api.amilere.com/v1/export/scores?limit=500" \
-H "Authorization: Bearer prism_YOUR_API_KEY"{
"scope": {
"workspaceId": "ws_agency_001",
"workspaceName": "Northwind Agency",
"clientCount": 12
},
"count": 2,
"scores": [
{
"workspaceId": "ws_client_044",
"workspaceName": "Acme DTC",
"platform": "instagram",
"tier": "micro",
"followerCount": 45200,
"overallScore": 612.4,
"grade": "strong",
"part1Score": 58.1,
"part2Score": 64.0,
"formulaVersion": "v28",
"recordedAt": "2026-06-20T11:00:00Z"
},
{
"workspaceId": "ws_agency_001",
"workspaceName": "Northwind Agency",
"platform": "tiktok",
"tier": "macro",
"followerCount": 180400,
"overallScore": 705.0,
"grade": "elite",
"part1Score": 71.2,
"part2Score": 69.8,
"formulaVersion": "v28",
"recordedAt": "2026-06-19T09:30:00Z"
}
]
}Error Codes
Unauthorized
Missing, malformed, expired, or revoked API key.
Forbidden
Key lacks the "read" scope, or the key owner is not on an Agency plan or above.
Rate Limited
Per-key rate limit exceeded. Honour the Retry-After header.