Message Metrics

Query Metrics Related to Messages

Get message attributes

Fetch message attributes using various query parameters

get

/workspaces/{workspaceId}/reporting/messages

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-time

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

filterstring

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', or 'scheduled'.
• 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

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/workspaces/{workspaceId}/reporting/messages?periodStart=2025-02-21T18%3A13%3A31.486Z'

200

422

200

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

An array of messages