Response Codes
Pindo uses conventional HTTP status codes. 2xx means success;
4xx means the request was rejected. The body explains why.
Status codes
| Code | Text | Meaning |
|---|---|---|
| 201 | sent | Successfully sent. |
| 401 | unauthorized | Unauthorized access. Check your token. |
| 404 | not found | Invalid resource URI. |
| 409 | conflict | Number is from an unsupported country. |
| 409 | conflict | Number is from an unsupported telco. |
| 409 | conflict | Wrong phone number format. |
Successful send
A 201 response includes pricing and your remaining balance:
{
"bonus": 0.0,
"discount": 0.4,
"item_count": 1,
"item_price": 0.006,
"remaining_balance": 71421.953,
"self_url": "http://api.pindo.io/v1/sms/out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
"sms_id": "out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
"status": "sent",
"to": "+250789385878",
"total_cost": 0.006
}Always check status and remaining_balance in the response so you can surface
delivery state and low-balance warnings to your users.