Dhvanee DocsDashboard
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

StatusMeaning
401Missing, unknown, or revoked key
403Key is missing the required scope
404Resource not in this workspace
409Conflict (for example a duplicate phone, or Idempotency-Key reuse with a different body)
422Invalid body or query
402Plan credit exhausted — see Credits
429More than 60 requests in a minute — see Rate limits
503Rate-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?
Errors · Dhvanee Docs