Skip to navigation
API Referencesms-number

List Sms Number Messages

View as Markdown

List the SMS a rented number has received, newest first. Configure the SMS_RECEIVED webhook to be notified instead of polling.

Authentication

x-api-keystring

API key generated from the dashboard (Settings → API Keys). Each key is limited to 8 requests per 1-second window.

Path parameters

idstringRequired>=1 character
SimJuno SMS number rental ID

Query parameters

limitintegerOptional1-100Defaults to 50

Response

Successful response
idstring
senderstring or null
bodystring
received_atstring
forward_statusenum

pending: being sent to the eSIM. sent: delivered to the eSIM. failed: could not be delivered. skipped: no eSIM was linked.

Allowed values:
forward_errorstring or null
forwarded_atstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error