API Overview

The Geolocarta REST API provides programmatic access to aerial imagery, cadastral data, and map layer services.

Base URL

https://api.geolocarta.com/v1

Authentication

All requests require an API key or access token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

See Authentication for details.

Response Format

All responses are JSON with consistent structure:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-15T10:00:00Z"
  }
}

Error Responses

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found.",
    "details": {}
  }
}

HTTP Status Codes

Code	Meaning
200	Success
201	Created
400	Bad request — check parameters
401	Unauthorised — invalid API key
403	Forbidden — insufficient scope
404	Not found
429	Rate limited
500	Server error

Pagination

List endpoints support cursor-based pagination:

curl "https://api.geolocarta.com/v1/imagery?limit=20&cursor=abc123"

Available Endpoints

Endpoint	Description
/v1/imagery	Search and download aerial imagery
/v1/cadastral	Query property boundaries
/v1/geocoding	Address and coordinate lookups
/v1/layers	Create and manage map layers
/v1/tokens	Generate access tokens
/v1/health	API health check