Get a list of incoming SMS messages

GET

/sms/incoming

Get a list of all incoming SMS messages received by the account.

Only the first 100 incoming messages will be returned if no offset and limit parameters are specified.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://www.winsms.co.za/api/rest/v1/sms/incoming'

Response Example

200 - Example 1

{
    "incomingMessages": [
        {
            "incomingApiMessageId": 58324,
            "messageText": "Thank you for the holiday wishes. Stay safe",
            "mobileNumber": "27444444444",
            "outgoingApiMessageId": 2316,
            "receiveTime": "201707252208"
        },
        {
            "incomingApiMessageId": 58336,
            "messageText": "That is much appreciated. Happy holidays to you too",
            "mobileNumber": "27555555555",
            "outgoingApiMessageId": 2316,
            "receiveTime": "201707270952"
        }
    ],
    "resultsLimit": 100,
    "resultsOffset": 3400,
    "resultsTotalAvailable": 3402,
    "statusCode": 200,
    "timeStamp": "20170117054658978",
    "version": "1.0"
}

Request

Query Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠404Not found

🟠405Method Not Allowed

🟠422Unprocessable Entity

🔴500Internal Server Error

Modified at 2023-08-15 09:05:19

Get a list of incoming short/long code messages

Get a list of incoming opt-out SMS messages