Get team insights
The written insights and ratings for your team in this match. Check status: ready means summary and ratings are included, not_generated means you should POST this URL, generating means a run is in progress and you should poll, failed means the last run failed, and unavailable means the match is not complete yet.
Authorization
apiKey Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.
In: header
Path Parameters
Match id.
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights"{ "data": { "status": "ready", "message": "Insights are up to date.", "stale": false, "recordedBy": "team", "summary": { "whatsWorking": [ "Paint touches created open threes." ], "focusAreas": [ "Live-ball turnovers came in transition." ], "suggestions": [ "Run the drag screen earlier in the shot clock." ] }, "ratings": { "shotMix": { "value": 42, "comment": "More of the offence came from the paint." }, "pointsPerShot": { "value": 42, "comment": "More of the offence came from the paint." }, "assistRate": { "value": 42, "comment": "More of the offence came from the paint." }, "turnovers": { "value": 42, "comment": "More of the offence came from the paint." }, "rebounds": { "value": 42, "comment": "More of the offence came from the paint." }, "defensiveImpact": { "value": 42, "comment": "More of the offence came from the paint." } }, "generatedAt": "2026-03-14T07:02:11.000Z" }, "error": null}List play-by-play events GET
Every tagged event in match order, with the match sheet used to attribute them. Use the box score if you only need totals.
Generate team insights POST
Writes the team insights and every rostered player’s insights for this match. Returns immediately with status generating; poll the GET until status is ready. Usually takes one to two minutes. Does nothing if insights are already up to date, unless regenerate is true. A match that is not complete returns status unavailable.