Message Metrics

Query Metrics Related to Messages

Get message attributes

get

Fetch message attributes using various query parameters

Authorizations

useraccessKey

AuthorizationstringRequired

Provide the token that is returned upon login

Path parameters

workspaceIdstring · uuidRequired

The ID of the workspace

Query parameters

periodStartstring · date-timeRequired

The date and time in the format 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DDTHH:MM:SS-HH:MM'.

periodEndstring · date-timeOptional

The date and time in the format 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DDTHH:MM:SS-HH:MM'.

filterstringOptional

Filter conditions for which to fetch messages. Each condition is a string in the format of 'equals(field,value)'. Available field-value pairs are

• channelID - UUID, can supply multiple equals conditions for multiple channelIds
• campaignID - UUID, can supply multiple equals conditions for multiple campaignIds
• platformID - string, can supply multiple equals conditions for multiple platforms
  • Common values are 'sms-messagebird', 'email-sparkpost', 'whatsapp', and 'rcs-google'. More are possible and are returned in the response.
• channelName - string, exact match only.
• status - string, can supply multiple equals conditions for multiple statuses
  • Allowed values are 'invalid', 'accepted', 'processing', 'sent', 'sending_failed', 'delivered', 'delivery_failed', 'deleted', 'scheduled', or 'skipped'
• direction - string, message direction
  • Allowed values are 'in', 'out', 'invalid'
• receiverCountry - string, can supply multiple equals conditions for multiple receiver countries
  • Allowed values are ISO 3166-1 two character country codes
• channelSenderType - string, can supply multiple equals conditions for multiple channel sender types
  • Allowed values are 'long-code-number', 'short-code-number', 'alpha-number'
• sender - string, can supply multiple equals conditions for multiple senders
  • Examples include sender phone numbers or email addresses. Exact match only. If '+' is used, it must be URL encoded as '%2B'.
• failureCodes - string, can supply multiple equals conditions for multiple failure codes
  • Examples include 15001, 14001, 12006 etc

Responses

200

An array of messages

application/json

422

The request did not pass validation

application/json

get

/workspaces/{workspaceId}/reporting/messages

HTTPcURLJavaScriptPython

GET /workspaces/{workspaceId}/reporting/messages?periodStart=2025-12-19T14%3A21%3A02.282Z HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "ChannelID": "text",
    "ChannelName": "text",
    "ChannelSenderType": "text",
    "CampaignID": "text",
    "ChargeableUnits": 1,
    "PartCount": 1,
    "PlatformID": "text",
    "Status": "text",
    "FailureCode": "text",
    "CreatedAt": "2025-12-19T14:21:02.282Z",
    "SentAt": "2025-12-19T14:21:02.282Z",
    "DeliveredAt": "2025-12-19T14:21:02.282Z",
    "Direction": "text",
    "From": {
      "Key": "text",
      "Value": "text",
      "CountryCode": "text"
    },
    "To": {
      "Value": [
        "text"
      ],
      "CountryCodes": [
        "text"
      ]
    },
    "MessageType": "text",
    "ExtraInformation": {
      "Operator": "text",
      "MailboxProvider": "text",
      "MailboxProviderRegion": "text"
    },
    "UseCase": "text",
    "Activity": {
      "OpenedAt": "2025-12-19T14:21:02.282Z",
      "ClickedAt": "2025-12-19T14:21:02.282Z"
    }
  }
]