GET
/v1/score/historyScore History
Returns historical PRISM Score data points over a configurable date range. Useful for building trend charts, tracking improvement over time, and calculating score deltas for client reports.
Bearer token required. Minimum plan: Pro.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_id | string | Optional | Workspace ID. Defaults to primary workspace. |
start_date | string (ISO 8601) | Optional | Start of date range. Default: 90 days ago. |
end_date | string (ISO 8601) | Optional | End of date range. Default: today. |
granularity | string | Optional | "daily", "weekly", or "monthly". Default: "weekly". |
Request
curl -X GET "https://api.onprism.io/v1/score/history?start_date=2026-01-01&granularity=weekly" \
-H "Authorization: Bearer YOUR_API_KEY"Response (200 OK)
{
"workspace_id": "ws_abc123",
"granularity": "weekly",
"data": [
{
"date": "2026-01-06",
"score": 48.1,
"pillars": { "presence": 42, "reach": 38, "impact": 55, "sentiment": 50, "momentum": 52 }
},
{
"date": "2026-01-13",
"score": 49.8,
"pillars": { "presence": 43, "reach": 40, "impact": 57, "sentiment": 51, "momentum": 54 }
},
{
"date": "2026-01-20",
"score": 52.3,
"pillars": { "presence": 45, "reach": 41, "impact": 60, "sentiment": 53, "momentum": 56 }
}
],
"delta": {
"score": "+4.2",
"period": "2026-01-06 to 2026-01-20"
}
}Error Codes
400
Invalid Date Range
start_date must be before end_date.
401
Unauthorized
Missing or invalid API key.
404
No Data
No score data exists for the specified range.