Skip to main content

List inbound messages

GET 
/api/v1/sms/inbound

Retrieve a list of SMS messages received by your HelloSMS account, newest first. Only SMS messages are listed; RCS replies and MMS never appear here (use List conversations to see every channel). This endpoint returns up to 1000 messages per page and supports pagination to handle large sets of messages, and allows you to filter by recipient number.

Request​

Query Parameters

    page integer

    Specify the page number of results you want to retrieve. Each page holds up to 1000 messages. If you don´t provide a page number, the API will return the first page by default.

    number string

    If your HelloSMS account has multiple inbound numbers, use this parameter to filter the results and show only messages received by a specific number. The value should match the to field in the response. A number that isn't on your account returns a 400 with number not found.

Responses​

The list of inbound SMS messages was successfully retrieved.