Get a list of incoming short/long code messages

GET

/shortcode/incoming

Only available to users with a WinSMS Short/Long Code.
Get a list of all incoming short/long code messages received by the account.

Only the first 100 incoming short/long code 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/shortcode/incoming'

Response Example

200 - Example 1

{
    "resultsLimit": 100,
    "resultsOffset": 3400,
    "resultsTotalAvailable": 3402,
    "shortcodeMessages": [
        {
            "incomingApiMessageId": 58324,
            "messageText": "Win Big",
            "mobileNumber": "27444444444",
            "receiveTime": "201707252208"
        },
        {
            "incomingApiMessageId": 58336,
            "messageText": "Savings for me",
            "mobileNumber": "27555555555",
            "receiveTime": "201707270952"
        }
    ],
    "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

Transfer credits between main and sub accounts.

Get a list of incoming SMS messages