Query parameters
-
Filter based on the from msisdn, can be either an array or comma separated list
-
Filter based on the ref of the message, can be empty to filter on messages without a reference
-
Filter based on whether the message has finished/completed
-
Return messages whose messageID is greater than or equal to this value
-
Return messages whose messageID is less than or equal to this value
-
Return message created on or after this time; default is 24 hours ago
-
Return message created on or before this time
-
Max number of messages to return (default 100, max 500)
-
Number of messages to skip (for pagination use)
-
Csv of sort field definitions, default is "-messageID" which means descending order of messageID, ie newest messages first
GET
/sms/inbound
curl \
-X GET https://sms.apicontrol.co.uk/v1/sms/inbound \
-H "Authorization: $API_KEY"
Response examples (200)
{
"data": [
{
"messageID": 7,
"from": "+447700900000",
"to": "+447700900999",
"body": "Test inbound message",
"ref": "Oxford main office",
"received_at": "1718893029.000"
}
],
"more_results": false
}
Response examples (401)
{
"status_code": 401,
"status_msg": "Unauthorized"
}