Skip to main content
GET https://api.humalike.com/v1/social-observability/repositories/Report/by-id/{id}
Every successful Analyze transcript call also stores its report. Use this endpoint to read one back later by id — for example, to render it in a dashboard after the agent’s conversation has moved on. Reports are owner-scoped: a report you don’t own reads as null, the same shape as a report that doesn’t exist. There is no way to enumerate other users’ reports.

​
Authorization

​
Authorization
string
required
Your bearer token: Bearer <token>. See Authentication.

​
Path parameters

​
id
string
required
The report’s id (a UUID). Reports are created by Analyze transcript.

​
Response

​
agent_name
string
The agent the report is about, exactly as you sent it on the original analyze request.
​
health_score
number
The report’s headline reading in [0, 1], denormalized for cheap listing. Matches report.health_score.
​
report
object
The full reception report — the exact body the original Analyze transcript call returned, including interactions, interaction_totals, per_user, findings, health_score, and summary.
A successful read returns 200 OK with either the report payload above or null when no report with that id exists for the calling user.
200 OK
{
  "agent_name": "support_bot",
  "health_score": 0.42,
  "report": {
    "health_score": 0.42,
    "summary": "Casey is showing repeat friction with the support_bot's stock responses...",
    "interactions": [],
    "interaction_totals": [],
    "per_user": [],
    "findings": []
  }
}
200 OK (not found or not owned)
null

​
Errors

StatusCodeWhen
401UNAUTHORIZEDThe bearer token is missing, invalid, or expired.
422VALIDATION_ERRORid is not a well-formed UUID.
An unknown id, and a well-formed id owned by a different user, both return 200 with null — there is no way to tell a missing report from one you do not own. A malformed id (not a UUID) is rejected with 422. See Errors for the envelope shape.

​
Example

curl https://api.humalike.com/v1/social-observability/repositories/Report/by-id/$REPORT_ID \
  -H "Authorization: Bearer $HUMALIKE_TOKEN"