Queue snapshot for a single agent

GET

/queue/status/:phoneNumber

GET

/queue/status/:phoneNumber

$ curl https://api.messageblue.ai/queue/status/phoneNumber \
>      -H "X-App-Id: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "ok": true,
3   "data": {
4     "number": "+14155552671",
5     "ok": true,
6     "machineId": "macbook-pro-2023-01",
7     "lastSeenMs": 1689001234567,
8     "queue": {
9       "agentNumber": "+14155552671",
10       "machineId": "macbook-pro-2023-01",
11       "capturedAtMs": 1689001234567,
12       "limit": 200,
13       "truncated": false,
14       "summary": {
15         "total": 5,
16         "totalActive": 3,
17         "pending": 2,
18         "processing": 1,
19         "byType": {
20           "outbound_msg": 2,
21           "read_receipt": 1,
22           "stop_typing": 1,
23           "typing_indicator": 1
24         },
25         "busy": true,
26         "busyForMs": 4500
27       },
28       "jobs": [
29         {
30           "id": 101,
31           "jobId": "job-9f8b7c6d",
32           "type": "typing_indicator",
33           "status": "pending",
34           "to": "+14155551234",
35           "chatIdentifier": "chat-xyz-123",
36           "duration": 3000,
37           "textPreview": "Typing...",
38           "enqueuedAtMs": 1689001230000,
39           "waitingForMs": 4500
40         }
41       ]
42     }
43   },
44   "meta": {
45     "requestId": "550e8400-e29b-41d4-a716-446655440000",
46     "timestamp": "2026-07-10T06:00:00.000Z"
47   }
48 }

Requests a live snapshot of the specified agent’s SQLite job queue (typing, stop typing, read receipt jobs).

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Path parameters

phoneNumberstringRequired

Agent iMessage number (E.164).

Query parameters

limitintegerOptional<=1000Defaults to 200

includeTextbooleanOptionalDefaults to true

textPreviewLenintegerOptionalDefaults to 200

timeoutMsintegerOptional500-30000Defaults to 5000

Response

Queue snapshot

okboolean

dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error

504

Gateway Timeout Error