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 either <code>websiteId</code> or <code>domain</code> 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.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": "flid_abc123",
"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"
}
]
}
}