Inbound messages
List inbound messages
Returns inbound SMS and MMS received on your organization's numbers,
newest first, with cursor pagination. The next-page token is returned in
meta.next_cursor and is null on the last page.
Requires the messages:read scope.
AuthorizationBearer <token>
Authenticate by sending your API key as a bearer token:
Authorization: Bearer am_live_.... Every request is automatically
scoped to the organization that owns the key and to the scopes granted
to that key.
In: header
Query Parameters
cursor?string
limit?integer
Default
20Range
1 <= value <= 100from?string
to?string
phone_number_id?string
Format
uuidchannel?string
Value in
"sms" | "mms"opt_out?boolean
since?string
Format
date-timeResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/inbound-messages"{
"success": true,
"data": [
{
"id": "5a1b2c3d-4e5f-6789-abcd-ef0123456789",
"org_id": "0190a1b2-c3d4-e5f6-a7b8-c9d0e1f2a3b4",
"phone_number_id": "7c1f0a2d-9e8b-4c3a-9d2e-1f0a2b3c4d5e",
"from": "+15554443333",
"to": "+15551112222",
"body": "STOP",
"channel": "sms",
"media_urls": [],
"segment_count": 1,
"opt_out": {
"detected": true,
"keyword": "STOP"
},
"bandwidth_message_id": "bw-1700000001-def",
"bandwidth_received_at": "2026-04-26T12:01:00Z",
"received_at": "2026-04-26T12:01:00.123Z"
}
],
"meta": {
"total": 0,
"limit": 20,
"offset": 0,
"next_cursor": null
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "authentication failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "missing required scope",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "VALIDATION_FAILED",
"message": "validation failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM",
"details": {
"to": "must be E.164",
"body": "must be 1..1600 chars"
}
}
}