SMS Summary

The time and date (in UTC) when we accepted a valid message request from your account or from a mobile operator.

While not required fields, we recommend adding the Accepted Date, Delivered Date and Updated Date fields as they are useful in analyzing an SMS message's history. If included, you can select to group messages by:

• Second — this is the default value.
• Minute
• 15 Minutes
• 30 Minutes
• Hour
• Day — as per the UTC
• Week — this is Sundays to Saturdays
• Month — each calendar month
• Quarter — The quarters are: January-March, April-June, July-September, October-December
• Year — year by 1st of January until 31st of December

Filterable? Yes. When used as a filter, it is always required.

You can filter the report by the following:

• Predefined — select a predefined choice. This can be either Today, Yesterday, This Week, Last Week, This Month, or Last Month; however remember that the maximum date range is restricted to 2 days for this report (as set in the Accepted Date filter)
• Rolling — select the type of time period (e.g. Hours) and how many units of that time you want included in the report. For example, "5 Hours" will create a report that, when run, includes the last 5 hours data.
• Equals — select a specific date by clicking the calendar icon, or by entering the date using a yyyy/mm/dd format.
• Custom Range — select a date range; however, remember that the maximum data range is 2 days for this report.

When creating a scheduled report, use either the Predefined or the Rolling options as these adjust for each run of the report to show data relative to the run time.

The unique ID of an account you have with OpenMarket. Depending on your business requirements, you may have multiple accounts to send and receive SMS.

Filterable? Yes. Enter one or more account IDs on which to filter. From the drop-down list, enter the account ID, and then select it from the list. Search and add additional account IDs as needed. A tally keeps track of the number of IDs added to the filter. Alternately, you can filter on Account Name.

The unique name of an account you have with OpenMarket. Depending on your business requirements, you may have multiple accounts to send and receive SMS messages.

You can alternatively use Account ID in the report. Include if your business is using multiple accounts, particularly if your business units use different accounts that you will need to report on.

Filterable? Yes. Enter one or more account names on which to filter. From the drop-down list, enter the account name, and then select it from the list. Search and add additional account names as needed. A tally keeps track of the number of account names added to the filter. Alternately, you can filter on Account ID.

The two-letter code that identifies the country or region. For example, AU (Australia) or CA (Canada). You can find a list of the codes on Wikipedia.

• For MTs, this is the country of the destination
• For MOs, this is the country of the originator

The value ## means that we were not sent the country details back from the mobile operator (most operators include this and other details in the delivery receipt they send us). It is not linked to the delivery status of the message.

You can alternately use the Country Name, which lists the full name of the country or region.

Filterable? Yes. You can filter by one or more country alpha codes. From the drop-down list, enter or search for the country code then select it. As you select country codes, a tally keeps track of the number of country codes added to the filter.

The name of the country in which the end user's phone number is registered.

The value unknown means that we were not sent the country details back from the mobile operator (most operators include this and other details in the delivery receipt they send us). It is not linked to the delivery status of the message.

You can alternately use the Country Code, which is the two-letter code for a country or region.

Filterable? Yes. You can filter by one or more country names. From the drop-down list, enter or search for the country name, and then select it. As you select country names, a tally keeps track of the number of country names added to the filter.

A code number and message that identifies the current or final delivery state of a message. If you want a high-level view of message delivery, use Message Status.

Filterable? Yes. Use this to look at the specific delivery issues you may have had, as it provides a granular breakdown of issues that is useful for troubleshooting.

Codes can differ between API versions. See the following:

• For the HTTP Global SMS API, see Delivery Receipts and Response Codes.
• For the version 3 SMS APIs, see Response and Delivery Receipt Codes for SMS Version 3 API.

Alternately, you can filter by Delivery Receipt Description. You can filter by one or more codes. From the drop-down list, enter or search for the code then select it. As you select codes, a tally keeps track of the number of codes added to the filter.

Use this to look at the specific delivery issues you may have had, as it provides a granular breakdown of issues that is useful for troubleshooting. If you want a high-level view of message delivery, use Message Status.

Filterable? Yes.

Codes can differ between API versions. See the following:

• For the HTTP Global SMS API, see Delivery Receipts and Response Codes.
• For the version 3 SMS APIs, see Response and Delivery Receipt Codes for SMS Version 3 API.

Alternately, you can filter by Delivery Receipt Code. You can filter by one or more descriptions. From the drop-down list, enter or search for the description, and then select it. As you select descriptions, a tally keeps track of the number of descriptions added to the filter.

The percentage of messages that failed to be delivered. It does not include messages for which we are awaiting a status from the mobile operator. This is calculated by dividing the number of messages failed by the number accepted and multiplying by 100.

Use this field to see whether failure rates changed over time, or were influenced by mobile operator or country.

This field is calculated using other fields, which means that the report also needs the Messages Failed and Messages Accepted fields. These are automatically included if you select Failure Rate.

Filterable?: No.

Indicates whether the message was sent from your account or from an end user. Useful to quickly determine the direction of the message, particularly if you are using Message Originator and Phone Number in the report (and do not include Destination Address or Sender Address, which indicate direction).

Filterable? Yes. You can select one or both of:

• MT — for filtering on messages sent from your account
• MO — for filtering on messages sent from an end user

The source number used to send an MT message or receive an MO message. Types of originators include short codes, text-enabled landlines, toll-free numbers, alphanumeric strings, and virtual mobile numbers (long codes).

Filterable? Yes. Multiple values are supported. This is a free-text field, so you will need to know your originators before using this filter. To add multiple originators, include a line space between each number—that is, press the Enter key after adding each number so that each number is on its own line. Use this to split the message traffic by your message originators. You can use this in conjunction with the Message Direction field to see the messages coming from and to that originator.

Provides the current or final delivery status of a message. Use this if you want a high-level view of message delivery. This is in comparison to using the delivery receipt code, which provides a more granular breakdown of delivery issues and is more suited to specific troubleshooting.

Filterable? Yes. Filters are:

• Delivered — the message was successfully delivered
• Awaiting Report — we forwarded the message to the operator, however we have not received a delivery receipt yet
• Failed — the message was not delivered. The delivery receipt code will identify the reason the message failed.
• Accepted — the message was accepted by the operator
• Rejected — the message was rejected by the operator after the number of retries was exhausted
• Expired — the message could not be delivered during the set validity period
• Retrying — the message has not yet been delivered, but retries are being attempted
• Unknown — the status of the message cannot be determined for some reason

You can select one or more statuses on which to filter. As you select statuses to add, a tally keeps track of the number of statuses added to the filter.

Use this field if you want to see the operators your end users are connected to, organized by mobile operator ID. This can be useful for troubleshooting high message failures with a specific operator — include the delivery receipt code in the report.

Note, however, that this does not always indicate the operator that we directly sent the messages to; some messages are sent off-net—for example, using a related operator in the same region—or in more remote locations, by a high-quality route.

Filterable?: Yes.

This is always a number, such as 383 for AT&T, and 348 for T-Mobile in the UK. For the US, if the operator is unknown, we return a value of 0. For the rest of the world, an unknown operator is returned as -1.

Select one ore more mobile operators to add to the filter. As you select operators, a tally keeps track of the number of operators added to the filter.

You can alternatively use Mobile Operator Name in the report.

Use this field if you want to see the operators your end users are connected to, organized by mobile operator name. This can be useful for troubleshooting high message failures with a specific operator — include the delivery receipt code in the report.

Note, however, that this does not always indicate the operator that we directly sent the messages to; some messages are sent off-net—for example, using a related operator in the same region—or in more remote locations, by a high-quality route.

Filterable? Yes.

This filter list organizes mobile operators by name, followed by their country of operation and mobile operator ID.

If the operator is in the US, and unknown, we return a value of unknown (US, 0). For the rest of the world, this is returned as unknown (null ,-1)

Select one ore more mobile operators to add to the filter. As you select operators, a tally keeps track of the number of operators added to the filter.

You can alternatively use Mobile Operator ID in the report, particularly if you need to compare this report to information OpenMarket returns in our API responses.

This indicates whether or not the sent message was a global one-way or two-way message. This is useful if you need to reconcile your one-way and two-way messaging, particularly if you are using our HTTP Global SMS API.

If you're using our HTTP Global SMS API, you can specify whether a message is one-way or two-way in your request, using "interaction". If you don't specify this, or if you're using another API version or another product, then OpenMarket determines the product based on the message originator you used to send the message, and what region the message was sent to.

Note that all US and Canadian messaging is two-way.

For MO messages, the value is always two-way.

Filterable?: Yes. Filters are:

• One Way
• Two Way
• Unknown

MO messages are included in the two-way data, so if you want only MT or MO messages in the report, filter by Message Direction.

This field is only populated if you are using the UK SMS API (also known as the MX API). It contains information included in the MT message request. This value is filterable, so that you can group your messages in Reports using your own campaign or program identifiers. It has no effect on the message or its delivery. Include this field if you are grouping messaging programs using subaccount; otherwise, you can ignore this field.

Do not use subaccount for individual identifiers, such as "ticket" or "transaction" IDs.

Filterable?: Yes. Use to filter the report by one or more of your subaccount groups. This is a free-text field, so you'll need to know the possible values you have sent with your messages. You can filter on multiple subaccounts. Each subaccount must be on its own line—that is, press the Enter key after adding each subaccount.

The number of message requests that we accepted from your account or the mobile operators.

If you want to see Messages Accepted data split into the messages you sent versus the messages you received, then include Message Direction in your report as a field or a filter.

Number of MT messages for which the mobile operator has not yet provided a final delivery status.

In the final report, the default name of the column "Sum of Messages Awaiting Report".

Include this field if your report is from the recent past (within seven days) and you want to differentiate between messages accepted, delivered, and those where the outcome isn't yet finalized. Almost all messages have a final outcome within seven days, so this field isn't useful if the report is set further back in time.

The number of MT messages that the mobile operator confirmed as successfully delivered, or the number of MOs sent to the mobile operator.

If you want to see Messages Delivered data split into the messages you sent versus the messages you received, then include Message Direction in your report as a field or a filter.

The number of MT messages that were not successfully delivered.