API Reference v3

Landers API Reference

Complete REST, GraphQL, and WebSocket documentation for building on the Landers intelligence platform.

REST API GraphQL WebSocket Auth

Authentication

Bearer Token Auth

All API requests require a valid API key passed as a Bearer token in the Authorization header.

Generate your API key from Settings → Integrations → API Keys. Pro and Enterprise plans have access to all endpoints. Starter accounts have read-only access to a limited subset.

Full API Guide View Plans

bash — example request

curl -X GET "https://api.landers.io/v3/landings/search?lat=25.2048&lng=55.2708" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Format

JSON Responses

All API responses return JSON. Successful responses include a results array; error responses include a standard error object with code, message, and details fields.

200 OKSuccessful response

401 UnauthorizedInvalid or missing API key

429 Too Many RequestsRate limit exceeded

503 Service UnavailableTemporary upstream issue

json — example response

{
  "results": [
    {
      "id": "lnd_9xKm2pQr",
      "name": "Dubai Helipad — Business Bay",
      "coordinates": { "lat": 25.1851, "lng": 55.2796 },
      "vehicle_types": ["helicopter", "vtol"],
      "availability": "available",
      "safety_score": 94,
      "weather_window": "clear",
      "distance_km": 2.3
    }
  ],
  "total": 12,
  "page": 1
}

Endpoints

API Endpoint Reference

GET/v3/landings/search

Search landing spots by coordinates, vehicle type, and filters.

GET/v3/landings/:id

Retrieve full intelligence for a specific landing spot.

POST/v3/bookings

Create a new landing booking at a specified spot and time.

GET/v3/bookings/:id

Retrieve a booking by ID with full status and metadata.

PUT/v3/bookings/:id/cancel

Cancel an existing booking. Refund policy applies.

GET/v3/routes/optimise

Get AI-optimised route between origin and destination.

GET/v3/weather/forecast

Retrieve 72-hour forecast for a coordinate pair.

GET/v3/aviation/notams

Fetch active NOTAMs for a given area and altitude band.

GET/v3/maritime/ais/vessels

List vessels within a bounding box with AIS telemetry.

GET/v3/maritime/ports/:code

Get port intelligence including berth availability and tides.

GET/v3/safety/score

Retrieve the Landers safety score for a landing spot.

POST/v3/vehicles

GET/v3/vehicles

List all vehicles registered under your account.

WS/v3/stream/ais

Subscribe to real-time AIS vessel position updates.

WS/v3/stream/weather

Subscribe to live weather updates for registered regions.

Looking for GraphQL or WebSocket documentation?

Read the full API integration guide

SDKs

Official Client Libraries

JavaScript / Node.js

npm install @landers/sdk

Python

pip install landers-sdk

go get github.com/landers-io/go-sdk

Swift (iOS)

swift package add landers-ios