Get the message conversation for a phone number

GET

/conversations/:phoneNumber

GET

/conversations/:phoneNumber

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

1 {
2   "ok": true,
3   "data": {
4     "phoneNumber": "+14155552671",
5     "totalMessages": 3,
6     "messages": [
7       {
8         "messageId": "msg-20240115-093000-001",
9         "type": "text",
10         "from": "+14155552671",
11         "to": "+14155559876",
12         "groupId": null,
13         "text": "Hey, are we still on for the meeting today?",
14         "attachments": [],
15         "outbound": true,
16         "iMessageNumber": "+14155552671",
17         "timestamp": "2024-01-15T09:30:00Z",
18         "status": "delivered",
19         "error": null,
20         "createdAt": "2024-01-15T09:30:00Z"
21       }
22     ],
23     "dateFrom": "2024-01-01T00:00:00Z",
24     "dateTo": "2024-01-15T23:59:59Z"
25   },
26   "meta": {
27     "requestId": "550e8400-e29b-41d4-a716-446655440000",
28     "timestamp": "2026-07-10T06:00:00.000Z"
29   }
30 }

Returns paginated inbound and outbound message logs for a given phone number, optionally filtered by date range.

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

Query parameters

dateFromstringOptional

dateTostringOptional

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