SMS delivery reports and message tracking

Sending is only half of messaging. NewHope SMS records what happened to every message, so you can see which ones arrived, which failed and what the campaign cost.

Hand holding a smartphone

Message statuses

Pending

The message is accepted and waiting to be sent, for example a scheduled message.

Sent

The message has been handed over for delivery.

Delivered

A delivery report confirmed that the message reached the phone.

Failed

The message could not be delivered, for example because the number was not valid or reachable.

In the dashboard

Open SMS Reports to see your messages with their recipient, Sender ID and status, and to search or filter them by status. You can also download usage reports and purchase statements as PDF documents for your records.

Through the API

When you send a message with the API you can include a webhook_url. When the delivery update arrives, NewHope SMS forwards it to that address, so your own system can mark a message as delivered or failed without asking again and again. You can also read the status of a message with a normal API request. The exact fields are in the API documentation.

What delivery reports can and cannot tell you

A delivered status means the network confirmed delivery to the handset. It does not mean the person read the message. Some networks and phones do not return a final report quickly, so a message can stay at "sent" for a while.

Why it matters

Frequently asked questions

How do I know if my SMS was delivered?

Each message has a status in your dashboard: pending, sent, delivered or failed. API users can also receive the update on a webhook.

Can I download a report?

Yes. Usage reports and purchase statements can be downloaded as PDF.

Does delivered mean the message was read?

No. It means the network confirmed delivery to the phone.

Related pages

See your own delivery reports

Create an account and follow every message you send.

Get started free Talk to us