Public API
Errors
Status codes and detail shapes returned by the public API.
Failed calls return JSON with a detail field. Some credit failures use a structured object with a code.
The machine-readable contract is `openapi.public.yaml`. Download it for clients and codegen. This site has no live Try-it console.
Common status codes
| Status | Meaning |
|---|---|
| 401 | Missing, unknown, or revoked key |
| 403 | Key is missing the required scope |
| 404 | Resource not in this workspace |
| 409 | Conflict (for example a duplicate phone, or Idempotency-Key reuse with a different body) |
| 422 | Invalid body or query |
| 402 | Plan credit exhausted — see Credits |
| 429 | More than 60 requests in a minute — see Rate limits |
| 503 | Rate-limit store unavailable; retry after one second |
Example
curl -sS -X GET "https://api.stage.dhvanee.com/v1/contacts/00000000-0000-0000-0000-000000000000" \
-H "Authorization: Bearer dhvanee_live_YOUR_KEY"A missing contact returns 404 with a short detail string.
Was this page helpful?