Analytics
Get Analytics Refresh
Check refresh status for an analytics refresh request
GET
Use this endpoint to poll refresh progress after triggering
POST /analytics/targets/{id}/refresh.
Path Parameters
string
required
Refresh ID returned by the refresh endpoint.
Response
Returns the scoped refresh status payload fromsocial_analytics_refreshes.
string
Refresh ID.
string
Analytics target ID.
string
Current refresh status (
pending, processing, completed, failed).string | null
Workspace scope for refresh billing/context.
number
Credits charged for this refresh (
0 when free).boolean
Whether the free refresh window was used.
string
Refresh start timestamp.
string | null
Completion timestamp if finished.
string | null
Error message when status is
failed.Error Responses
400 missing_refresh_id- missing path parameter404 refresh_not_found- refresh ID not visible in authenticated key scope401/403- authentication failed or key lacks required scope access500- unexpected database lookup error
error_code field.