BrainerceList Storefront Bot conversations
Lists Storefront Bot conversations, newest first.
AuthorizationBearer <token>
Admin API key (server-to-server). Issue via the dashboard at Settings → API keys. Plain-text key is shown once — store in a secret manager. Format: Authorization: Bearer brainerce_xxxxxxxxx.
In: header
Query Parameters
salesChannelId?string
Only conversations of this sales channel. Accepts the record ID or the vc_* connection ID.
page?integer
1-based page number.
Default
1Range
1 <= valuelimit?integer
Items per page. Default 20. Maximum 100.
Default
20Range
1 <= value <= 100curl -X GET "https://api.brainerce.com/api/v1/storefront-bot/conversations?salesChannelId=string&page=1&limit=20"{
"data": [
{
"id": "clx1a2b3c4d5e6f7g8h9",
"salesChannelId": "clx1a2b3c4d5e6f7g8h9",
"title": "Sizing question",
"locale": "en",
"customerName": "Dana Cohen",
"lastMessage": {
"role": "assistant",
"content": "Yes, that size is in stock.",
"createdAt": "2019-08-24T14:15:22Z"
},
"messageCount": 12,
"unread": true,
"lastActivityAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"signedIn": true,
"escalated": true
}
],
"meta": {
"page": 1,
"limit": 20,
"total": 137,
"totalPages": 7
}
}{
"statusCode": 401,
"code": "UNAUTHORIZED",
"message": "Invalid or expired credential",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations"
}{
"statusCode": 403,
"code": "INSUFFICIENT_SCOPE",
"message": "API key does not have the required scope: products:write",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations"
}{
"statusCode": 404,
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/storefront-bot/conversations"
}{
"statusCode": 429,
"code": "RATE_LIMITED",
"message": "Too many requests",
"details": {
"retryAfterSeconds": 12
},
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/store"
}