Errors and Status Codes

Error envelope

Application errors return:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "state must be a 2-letter code",
    "request_id": "req-123"
  }
}

200: request succeeded
400: malformed path identifier (geo_id format)
404: valid identifier but resource not found
422: query validation failed, including unsupported permit-scoped geo type or invalid cursor
429: throttled/quota exceeded
500: internal server error
503: dependent permits data source unavailable/misconfigured