api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/issues/{issueId}Fetch the full detail for one AI-detected issue, including every flagged moment, the recordings behind it, and team comments.
Bearer Token (workspace token or website API key)
Workspace Tokens Need a Website Selector
Workspace API tokens can access every website in the workspace. Pass eitherwebsiteId or domain so Flowsery knows which website to query or mutate. Website API keys are already scoped to one website, so the selector can be omitted.Website Selector
| Parameter | Type | Description |
|---|---|---|
websiteId | string | Website ID to use with a workspace API token. Omit when authenticating with a website API key. |
domain | string | Website domain to use with a workspace API token when websiteId is not provided. Omit when authenticating with a website API key. |
Issue Identification
Pass the id returned by List issues as the issueId path parameter. A 404 is returned when the issue does not exist on the selected website. On a free trial, an issue outside the first 10 answers 403.The detail object contains every field from the List issues shape plus the arrays below.
Response Fields
| Parameter | Type | Description |
|---|---|---|
occurrences | array | Each AI-flagged moment: a description of what happened, the atSeconds offset in the recording, and the severity of that moment. |
sessions | array | The recordings behind the issue: the recordingId and the atSeconds offset where the issue happens. |
comments | array | Team comments on the issue: id, authorName, body, and createdAt. |
Example Request (Curl)
curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/issues/{issueId} \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": {
"id": "iss_64f1c2a9e8b4d90012ab34cd",
"websiteId": "cm8abc123",
"title": "Checkout button unresponsive on mobile Safari",
"description": "Tapping the checkout button produces no navigation or feedback. Visitors tap repeatedly and abandon the cart.",
"severity": "critical",
"status": "open",
"sessionsCount": 14,
"firstSeenAt": "2026-08-02T09:14:31.000Z",
"lastSeenAt": "2026-08-27T18:40:05.000Z",
"stepsToReplicate": [
"Open the store on an iPhone in Safari",
"Add any product to the cart",
"Tap the checkout button on the cart page"
],
"sampleRecordingId": "rec_9f8e7d6c5b4a",
"externalTicketProvider": "linear",
"externalTicketKey": "SHOP-142",
"externalTicketUrl": "https://linear.app/acme/issue/SHOP-142",
"occurrences": [
{
"description": "Visitor taps the checkout button five times with no response",
"atSeconds": 42,
"severity": "critical"
},
{
"description": "Rage clicks on the cart summary after the failed tap",
"atSeconds": 58,
"severity": "high"
}
],
"sessions": [
{ "recordingId": "rec_9f8e7d6c5b4a", "atSeconds": 42 },
{ "recordingId": "rec_0b1c2d3e4f5a", "atSeconds": 17 }
],
"comments": [
{
"id": "cmt_66a1b2c3d4e5",
"authorName": "Jane Cooper",
"body": "Reproduced on iOS 18.2, the tap handler never fires.",
"createdAt": "2026-08-15T10:22:41.000Z"
}
]
}
}