Error Responses

All API endpoints follow a consistent error response format.

Error Response Format

{
  "error": "Error message",
  "details": "Additional error details (optional)",
  "code": "ERROR_CODE"
}

HTTP Status Codes

Code

Description

200

Success

201

Created

400

Bad Request - Invalid input

403

Forbidden - Access denied

404

Not Found - Resource doesn’t exist

429

Too Many Requests - Rate limit exceeded

500

Internal Server Error

503

Service Unavailable

Common Error Codes

Code

Description

INVALID_INPUT

Request validation failed

NOT_FOUND

Resource not found

RATE_LIMIT_EXCEEDED

Too many requests

DATABASE_ERROR

Database operation failed

PARSE_ERROR

File parsing failed

IMPORT_ERROR

GeoNet import failed

MERGE_ERROR

Catalogue merge failed

Last Updated: October 2024