Get inbound MMS messages

If for some reason you are unable to receive incoming MMS at the endpoint of your choice in real time, you can use this API call to fetch messages. Each request will return a batch of received messages - only once. The following API request will return only new messages that arrived since the last API request.

Please log in to see full path URL. Learn why.
get
/mms/1/inbox/reports
query Parameters
limit
integer <int32>
Example: limit=2

Maximum number of delivery reports that will be returned.

applicationId
string
Example: applicationId=ApplicationExample

Application identifier used for filtering.

entityId
string
Example: entityId=EntityExample

Entity identifier used for filtering.

Responses

200

OK

401

Unauthorized

403

Forbidden

500

Internal Server Error

Request samples

Example
cURL
Copy
curl -L -g 'https://{baseUrl}/mms/1/inbox/reports?limit=2&applicationId=ApplicationExample&entityId=EntityExample' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type
application/json
Example
Copy
Collapse all
{
  • "results":
    [
    • {
      • "messageId": "817790313235066447",
      • "to": "25256",
      • "from": "41793026727",
      • "message": "{\"mms_parts\":[{\"origin\":\"text\",\"contentType\":\"text/plain; charset=utf-8\",\"contentId\":\"content0\",\"value\":\"Sample text\"}],\"userAgent\":\"motogstylus5g\",\"priority\":null,\"subject\":null}",
      • "receivedAt": "2016-10-06T09:28:39.220+0000",
      • "mmsCount": 1,
      • "callbackData": "Some custom data",
      • "price":
        {
        • "pricePerMessage": 0,
        • "currency": "EUR"
        }
      }
    ]
}

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.