List messages

GET

https://api.getdial.ai/api/v1/messages

GET

/api/v1/messages

$ curl https://api.getdial.ai/api/v1/messages \
>      -H "Authorization: Bearer <token>"

1 {
2   "messages": [
3     {
4       "id": "string",
5       "phoneNumberId": "string",
6       "from": "+14155550123",
7       "to": "+14155559876",
8       "body": "string",
9       "direction": "inbound",
10       "channel": "sms",
11       "service": "imessage",
12       "status": "delivered",
13       "statusError": null,
14       "media": [
15         {
16           "id": "a3f9c2d41e8b4f0a9c6d2e7b5a1f8c30",
17           "url": "https://getdial.ai/public-media/a3f9c2d41e8b4f0a9c6d2e7b5a1f8c30.jpg",
18           "contentType": "image/jpeg",
19           "originalUrl": "https://your-cdn.example.com/summary.png"
20         }
21       ],
22       "replyToId": null,
23       "reaction": null,
24       "createdAt": "2024-01-15T09:30:00Z"
25     }
26   ]
27 }

Returns up to 100 of the most recent messages on the account's numbers.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Query parameters

numberIdstringOptional

Filter to a single phone number.

directionenumOptional

Allowed values:

sincedatetimeOptional

Only messages created after this timestamp.

Response

Messages, newest first.

messageslist of objects

Errors

401

Unauthorized Error