Skip to content

Error Handling

DRAFT Specification / Work in Progress

This portion of the BTAA GIN site, our GeoBTAA API, and our Linked Data offerings are a WORK IN PROGRESS. Please reach out if you have questions or wish to participate in bringing these resources to public release.

Errors MUST return a JSON object with type, title, status, and detail properties.

{
  "type": "https://opengeometadata.org/api/errors/RateLimitExceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Allowed 1000 requests per minute; received 1423."
}
HTTP Status Meaning
400 Bad request / parameter validation error
401 Missing or invalid API key
404 Record or endpoint not found
429 Rate limit exceeded
500 Internal server error