Numbers

List messages

GET
/v1/numbers/{id}/messages

The SMS a number has received, newest first.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Query Parameters

limit?integer

How many to return

Range1 <= value <= 100
Default25
cursor?string

nextCursor from the previous page

refresh?string

Check the carrier for new messages before answering

Response Body

Success

application/json
  1. response

Success

data*array<>
nextCursor*|

Pass as cursor for the next page. null on the last page

total*integer

How many match across every page

Range0 <= value
curl -X GET "https://example.com/v1/numbers/num_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/messages"
{  "data": [    {      "id": "msg_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "numberId": "num_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "sender": "WhatsApp",      "body": "Your code is 428-113",      "receivedAt": "2026-10-07T11:04:31.000Z"    }  ],  "nextCursor": null,  "total": 1}