Get mappings for multiple agents in one request

POST

/agents/mappings/bulk

POST

/agents/mappings/bulk

$ curl -X POST https://api.messageblue.ai/agents/mappings/bulk \
>      -H "X-App-Id: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "ok": true,
3   "data": {
4     "agentNumbers": [
5       "+14155552671",
6       "+14155552672"
7     ],
8     "totalMappings": 2,
9     "mappings": [
10       {
11         "accountId": "acc_9f8b7c6d5e4a3b2c1d0e",
12         "userNumber": "+14155550123",
13         "agentNumber": "+14155552671",
14         "createdAt": 1689004800000,
15         "respondedAt": 1689091200000,
16         "lastRespondedAt": 1689177600000,
17         "receivedAt": 1689008400000,
18         "lastReceivedAt": 1689181200000,
19         "outbound": 150,
20         "inbound": 120,
21         "consecutiveCount": 5,
22         "lastWarningSentAt": 1689100000000
23       },
24       {
25         "accountId": "acc_1a2b3c4d5e6f7g8h9i0j",
26         "userNumber": "+14155550124",
27         "agentNumber": "+14155552672",
28         "createdAt": 1688900000000,
29         "respondedAt": 1688986400000,
30         "lastRespondedAt": 1689072800000,
31         "receivedAt": 1688903600000,
32         "lastReceivedAt": 1689076400000,
33         "outbound": 200,
34         "inbound": 180,
35         "consecutiveCount": 3,
36         "lastWarningSentAt": 1688990000000
37       }
38     ]
39   },
40   "meta": {
41     "requestId": "550e8400-e29b-41d4-a716-446655440000",
42     "timestamp": "2026-07-10T06:00:00.000Z"
43   }
44 }

Accepts a list of agent phone numbers and returns all their current mapping records in a single response.

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.

Request

This endpoint expects an object.

agentNumberslist of stringsOptional

Response

okboolean

dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error