| Status | Meaning | Recommended action |
|---|---|---|
| 200 | Success — data returned | Parse the 📱 field. |
| 400 | Invalid input | Fix input format — see the module page for the exact pattern. |
| 401 | Missing or invalid bearer token | Re-authenticate and retry. |
| 402 | Insufficient credits | Top up credits, then retry. |
| 404 | No records found upstream | Payload includes status: Not Found. |
| 405 | Method not allowed | Only GET and POST are supported. |
| 429 | Rate limit hit | Back off; see rate limits doc. |
| 500 | Upstream provider or internal fault | Credits are auto-refunded. Retry after a short delay. |
Error envelope
Every non-2xx response uses the same envelope — the human message is at ⚠️ and the machine-readable field is error.
{
"⚠️": "Request failed",
"⏰": "2026-07-24T09:12:44.512Z",
"error": "Insufficient credits"
}