channels
mms
logs-and-status-reports-mms

Get MMS message logs

Use this method for displaying logs for example in the user interface. Available are the logs for the last 48 hours.

get/mms/2/logs

Request

  • Base URL
    https://api.infobip.com (the document declares no server; this is the origin it was published from)
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://api.infobip.com/auth/1/oauth2/token
    • or API key in header Authorization
    • or API key in header Authorization
    • or HTTP basic

Query parameters

mccstring

Filter logs by mobile country code.

mncstring

Filter logs by mobile network code.

senderstring

The sender ID which can be alphanumeric or numeric.

destinationstring

Message destination address.

bulkIdstring[]

Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. May contain multiple comma-separated values. Maximum length 2048 characters.

messageIdstring[]

Unique message ID for which a log is requested. May contain multiple comma-separated values. Maximum length 2048 characters.

generalStatus'ACCEPTED' | 'PENDING' | 'UNDELIVERABLE' | 'DELIVERED' | 'EXPIRED' | 'REJECTED'

Status group name that describes which category the status code belongs to, i.e., PENDING, UNDELIVERABLE, DELIVERED, EXPIRED, REJECTED.

sentSincestring date-time

The logs will only include messages sent after this date. Use it alongside sentUntil to specify a time range for the logs, but only up to the maximum limit of 1000 logs per call. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

sentUntilstring date-time

The logs will only include messages sent before this date. Use it alongside sentSince to specify a time range for the logs, but only up to the maximum limit of 1000 logs per call. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

Example:2020-02-23T17:42:05.39+01:00
limitinteger

Maximum number of messages to include in logs. If not set, the latest 50 records are returned. Maximum limit value is 1000 and you can only access logs for the last 48h.

entityIdstring

Entity id used to send the message. For more details, see our documentation.

applicationIdstring

Application id used to send the message. For more details, see our documentation.

campaignReferenceIdstring[]

ID of a campaign that was sent in the message. May contain multiple comma-separated values.

useCursorboolean

Flag used to enable cursor-based pagination. When set to true, the system will use the cursor to fetch the next set of logs.

cursorstring

Value which represents the current position in the data set. For the first request, this field shouldn't be defined. In subsequent requests, use the nextCursor value returned from the previous response to continue fetching data.

Response

OK

Example response

{
  "results": [
    {
      "bulkId": "BULK-ID-123-xyz"
    }
  ]
}

Changes

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