Response codes
API status codes appear in message send responses, delivery reports, and message logs. They provide more detail about the lifecycle of a message beyond the HTTP status code.
Each status is returned as a structured object:
json
1{
2 "groupId": 3,
3 "groupName": "DELIVERED",
4 "id": 5,
5 "name": "DELIVERED_TO_HANDSET",
6 "description": "Message delivered to handset"
7}
Status codes are organized into groups:
- Group 1 — Pending: The message has been processed and forwarded (e.g., to the operator). Delivery to the handset is not yet confirmed.
- Group 2 — Undeliverable: The message could not be delivered.
- Group 3 — Delivered: The message was successfully delivered.
- Group 4 — Expired: The message expired before delivery was confirmed, typically after the 48-hour validity period.
- Group 5 — Rejected: The message was rejected by Infobip or the operator before it could be sent.
Channel-specific status codes (Voice, MMS, Email, Push, Moments) follow the same object structure with their own group members.
Use your browser's Ctrl+F / Command+F to search the full table by status name or ID.
For the complete status code reference, see Response status and error codes.