Skip to main content
Issue reports flag specific calls for quality review. They are created on a per-call basis via POST /v1/calls/{call_id}/issue-reports and can also be filed automatically by call grading when it detects an issue pattern. This page documents the org-wide feed — use it to build dashboards and route issues to your QA workflow.

​
Endpoint

MethodPathDescription
GET/v1/issue-reportsList issue reports across all calls

​
Issue report object

{
  "id": 4321,
  "call_id": 987654321,
  "source": "user",
  "severity": "warning",
  "status": "open",
  "title": "Agent paused too long",
  "description": "Five-second silence before responding to the main question.",
  "reported_by_id": 7,
  "timestamp_seconds": 48,
  "detected_issue_ref": null,
  "metadata": {},
  "trace_id": "5f9a...",
  "created_at": "2026-04-20T18:25:11.002Z",
  "updated_at": "2026-04-20T18:25:11.002Z"
}
FieldTypeDescription
idintegerIssue report id
call_idintegerParent call
sourcestringuser (manually filed from the UI / API) or system (automatically filed — e.g. by call grading)
severitystringinfo, warning, or critical
statusstringopen, acknowledged, or resolved
titlestringShort description, 1–255 chars
descriptionstringFree-form body
reported_by_idinteger | nullUser id of the reporter. null when created by the system
timestamp_secondsinteger | nullOffset in seconds into the call the issue refers to
detected_issue_refstring | nullFree-form id set by grading to correlate recurring patterns
metadataobjectFree-form bag for your own app data
trace_idUUIDStable id for external linking
created_at, updated_attimestampISO 8601 UTC

​
List issue reports

curl 'https://api.thunderphone.com/v1/issue-reports?severity=critical' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

​
Query parameters

ParamTypeDescription
severitystringFilter: info, warning, critical
statusstringFilter: open, acknowledged, resolved
sourcestringFilter: user, system
agent_idintegerFilter to reports on calls handled by this agent
start_dateISO 8601Earliest created_at
end_dateISO 8601Latest created_at
limitintegerMax results (default 50, capped at 200)
offsetinteger
Returns 200 OK with an array of Issue report objects, sorted by created_at descending.

Call issue reports

File a report on a specific call.

Call grading

AI-detected issues automatically produce reports here.