GET
/v1/audit/{audit_id}Get Audit Results
Retrieves the full results of a completed Brand Audit by its ID. Includes composite score, pillar breakdown, recommendations, and detailed metrics.
Bearer token required. Minimum plan: Pro.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
audit_id | string | Required | The audit ID returned from the Run Audit endpoint. |
Request
curl -X GET "https://api.onprism.io/v1/audit/aud_7f3k9x2m" \
-H "Authorization: Bearer YOUR_API_KEY"Response (200 OK)
{
"audit_id": "aud_7f3k9x2m",
"status": "completed",
"completed_at": "2026-02-24T12:04:32Z",
"score": 54.2,
"pillars": {
"presence": { "score": 48, "change": "+3", "grade": "yellow" },
"reach": { "score": 42, "change": "+5", "grade": "yellow" },
"impact": { "score": 62, "change": "+8", "grade": "green" },
"sentiment": { "score": 55, "change": "+2", "grade": "green" },
"momentum": { "score": 58, "change": "+6", "grade": "green" }
},
"recommendations": [
{ "priority": 1, "pillar": "reach", "action": "Expand to TikTok — this platform shows the highest growth potential for your industry.", "expected_impact": "+4 Reach" },
{ "priority": 2, "pillar": "presence", "action": "Increase posting frequency from 3/week to 5/week across existing platforms.", "expected_impact": "+3 Presence" }
],
"industry_benchmark": {
"your_score": 54.2,
"industry_average": 47.1,
"percentile": 72
}
}Error Codes
401
Unauthorized
Missing or invalid API key.
404
Not Found
No audit found with this ID.
425
Too Early
Audit is still processing. Try again later or use a webhook.