API Documentation

  • Home
  • Getting Started

SMS API

  • Overview
  • Send SMS
  • Bulk SMS
  • Send Hashed SMS
  • Send OTP
  • Delivery Reports
  • Delivery Status
  • SMS Balance
  • Common Errors
  • Response Codes

Delivery Status Descriptions

This page outlines the possible delivery status values you may receive when checking message delivery reports.

Status Codes

Status Description
Pending Message is queued for delivery
Sent Message has been sent to the carrier
Delivered Message has been successfully delivered to the recipient
Failed Message delivery failed
Undeliverable Message cannot be delivered to this number
Rejected Message was rejected by the carrier
Invalid Message format is invalid

Understanding Status Codes

Pending

The message has been received by the system and is waiting to be sent. This is typically a very brief status.

Sent

The message has been forwarded to the carrier network. It may be in transit to the recipient.

Delivered

The message has been successfully delivered to the recipient's device. This is the desired outcome.

Failed

The message delivery failed. This could be due to various reasons such as network issues or invalid number format.

Undeliverable

The message cannot be delivered to the specified number. Common reasons include invalid phone numbers or the number being blocked.

Rejected

The carrier network rejected the message. This may be due to content filtering or other network policies.

Invalid

The message format or content is invalid according to the carrier's requirements.

Last Updated: 2/24/2025 | Contributors: Macrologic API Team

Related Endpoints

  • Delivery Reports
  • Response Codes
  • Common Errors

© 2025 All rights reserved | info@macrologicsys.com