The error format (v1 vs. dawa)

1 min read

The error format

The error shape depends on the surface.

/v1/* (native):

JSON

{ "error": {
  "type": "rate_limit_exceeded",
  "message": "Du har overskredet dit forbrugsloft. Prøv igen senere.",
  "code": 429,
  "request_id": "req_ab12cd34",
  "doc_url": "https://danskadresseapi.dk/docs#error-rate_limit_exceeded",
  "debug_url": "https://danskadresseapi.dk/dashboard/debug?req=req_ab12cd34" } }

code is the HTTP number (e.g. 429). type is a string. Give request_id to support.

/dawa/* (DAWA shape):

JSON

{ "type": "ResourceNotFoundError",
  "title": "The resource was not found",
  "details": { "id": "0a3f50…" } }

Validation: type: "QueryParameterFormatError", details is pair-arrays [["param","message"]].

Both surfaces keep the X-RateLimit-* and Retry-After headers, so client-side back-off works the same.

Was this helpful?