Skip to navigation
API Referencenumbers

Get Messages

Get messages for a specific phone number.

Newest first. Pass the previous response’s nextCursor as cursor to walk older history without skipping or repeating records, even when several messages share a timestamp. before/after timestamp filters are still accepted.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

number_idstringRequired

Headers

X-Sub-Account-IdstringOptional

Query parameters

limitintegerOptional1-200Defaults to 50
beforedatetime or nullOptional
afterdatetime or nullOptional
cursorstring or nullOptional

Opaque cursor from a previous response’s nextCursor. Takes precedence over before/after.

Response

Successful Response
datalist of objects
hasMoreboolean
nextCursorstring or nullOptional

Errors

422
Unprocessable Entity Error