RCS - Incoming

Get incoming RCS messages

Each message will only be returned once. Once called, the message has been marked as read from our side and cannot be retrieved again using this method.

get/v4/rcs/incoming/messages

Request

  • Base URL: https://api.inmobile.com
  • URL: https://api.inmobile.com/v4/rcs/incoming/messages
  • Auth: one of:
    • HTTP basic
    • API key in query parameter apikey

Query parameters

limitinteger

How many records to return (must be between 1 and 250)

Response

A list of messages

Example response

{
  "messages": [
    {
      "from": {
        "countryCode": "45",
        "phoneNumber": "12345678",
        "msisdn": "4512345678"
      },
      "to": {
        "id": "683862c7-c814-40cc-a74d-048d9f2f8cb7",
        "name": "PetShop"
      },
      "content": {
        "messageType": 1,
        "text": {
          "text": "Text message content"
        }
      },
      "receivedAt": "2026-06-09T14:00:00Z"
    },
    {
      "from": {
        "countryCode": "45",
        "phoneNumber": "12345678",
        "msisdn": "4512345678"
      },
      "to": {
        "id": "683862c7-c814-40cc-a74d-048d9f2f8cb7",
        "name": "PetShop"
      },
      "content": {
        "messageType": 2,
        "file": {
          "thumbnail": {
            "mimeType": "image/jpeg",
            "fileSizeInBytes": 6873,
            "fileUri": "https://example.com/thumbnail.jpg"
          },
          "payload": {
            "mimeType": "image/jpeg",
            "fileSizeInBytes": 91297,
            "fileName": "image.jpg",
            "fileUri": "https://example.com/image.jpg"
          }
        }
      },
      "receivedAt": "2026-06-09T14:00:00Z"
    },
    {
      "from": {
        "countryCode": "45",
        "phoneNumber": "12345678",
        "msisdn": "4512345678"
      },
      "to": {
        "id": "683862c7-c814-40cc-a74d-048d9f2f8cb7",
        "name": "PetShop"
      },
      "content": {
        "messageType": 3,
        "location": {
          "latitude": 55.6761,
          "longitude": 12.5683
        }
      },
      "receivedAt": "2026-06-09T14:00:00Z"
    },
    {
      "from": {
        "countryCode": "45",
        "phoneNumber": "12345678",
        "msisdn": "4512345678"
      },
      "to": {
        "id": "683862c7-c814-40cc-a74d-048d9f2f8cb7",
        "name": "PetShop"
      },
      "content": {
        "messageType": 4,
        "suggestionResponse": {
          "postbackData": "VEVTVF9CVVRUT05fUFJFU1NFRA==",
          "text": "Yes",
          "suggestionResponseTypeDescription": "Reply"
        }
      },
      "receivedAt": "2026-06-09T14:00:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.