Skip to content

API Overview

The ADAM API is a single, public, OGC-compliant service. This page is the entry point for the formal reference: base URL, supported standards, the shape of the catalogue, and the authoritative links you will need.

Coordinates
Base URL https://api.adam.geospatial.wfp.org/api
Version v1.0.0-alpha
Authentication None (public, read-only)
Standards OGC API — Features, OGC API — Tiles
Formats GeoJSON, MVT, TileJSON, StyleJSON, HTML
OpenAPI spec /openapi.json
Interactive Swagger UI /docs

Endpoint map

The API is organised into four tag groups:

  • OGC Common

    Landing page and conformance declaration.

    GET / · GET /conformance

  • OGC Features API

    Discover collections, list filterable properties, query and retrieve features.

    /collections · /collections/{id}/queryables · /collections/{id}/items

    Full reference

  • OGC Tiles API

    Vector tiles, TileJSON and StyleJSON descriptors, all matrix sets.

    /tileMatrixSets · /collections/{id}/tiles/...

    Full reference

  • Map Viewer

    Server-rendered interactive HTML preview for any collection — zero-code map check.

    /collections/{id}/tiles/{tms}/map.html

Conformance

ADAM declares which OGC capabilities it implements. Query it at:

GET /conformance

The conformance document is how generic OGC clients (QGIS, third-party integrators) auto-configure against the service. You rarely need it for hand-written code, but it is the self-describing contract of the API.

Common conventions

  • Geometries follow GeoJSON RFC 7946: WGS84 (EPSG:4326), longitude/latitude order
  • Timestamps are ISO 8601 in UTC
  • Errors follow standard HTTP status codes; bodies are JSON
  • Content negotiation via the f query parameter: json, geojson, html

Rate limits

None enforced at this time. Be a good citizen: cache responses, use pagination, avoid hammering unbounded queries.

Live references