v1.0.0

OpenAPI 3.1.0

WMO Global Ecosystems Atlas API

Public API for the WMO Global Ecosystems Atlas. Provides access to ecosystem taxonomy, geospatial statistics, and a mechanism to suggest data improvements.

Server

https://globalecosystemsatlas.org/api/v1

Client Libraries

Shell Curl

taxonomy

Realms, biomes, ecosystems, and datasets reference data

taxonomy Operations

get/realms
get/biomes
get/ecosystems
get/datasets
get/realms/{id}
get/biomes/{id}
get/ecosystems/{id}
get/datasets/{id}

List realms

Query Parameters

limit
Type: integer
min:
1
max:
200

Maximum number of items to return (1–200, default 100)
offset
Type: integer
min:
0

Number of items to skip for pagination (default 0)
fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json

get/realms

curl https://globalecosystemsatlas.org/api/v1/realms

Show Schema

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "color": "string",
      "description": "string"
    }
  ],
  "meta": {
    "total_count": 1,
    "limit": 1,
    "offset": 1
  }
}

Paginated list of realms

List biomes

Query Parameters

limit
Type: integer
min:
1
max:
200

Maximum number of items to return (1–200, default 100)
offset
Type: integer
min:
0

Number of items to skip for pagination (default 0)
fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json

get/biomes

curl https://globalecosystemsatlas.org/api/v1/biomes

Show Schema

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "color": "string",
      "description": "string",
      "realm": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "meta": {
    "total_count": 1,
    "limit": 1,
    "offset": 1
  }
}

Paginated list of biomes

List ecosystems

Query Parameters

limit
Type: integer
min:
1
max:
200

Maximum number of items to return (1–200, default 100)
offset
Type: integer
min:
0

Number of items to skip for pagination (default 0)
fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json

get/ecosystems

curl https://globalecosystemsatlas.org/api/v1/ecosystems

Show Schema

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "color": "string",
      "ecosystem_class": "string",
      "description": "string",
      "area": 1,
      "biome": {
        "id": "string",
        "name": "string",
        "realm": {
          "id": "string",
          "name": "string"
        }
      }
    }
  ],
  "meta": {
    "total_count": 1,
    "limit": 1,
    "offset": 1
  }
}

Paginated list of ecosystems

List datasets

Query Parameters

limit
Type: integer
min:
1
max:
200

Maximum number of items to return (1–200, default 100)
offset
Type: integer
min:
0

Number of items to skip for pagination (default 0)
fields
Type: string

Comma-separated list of fields to include in the response

Responses

application/json

get/datasets

curl https://globalecosystemsatlas.org/api/v1/datasets

Show Schema

{
  "data": [
    {
      "id": "string",
      "title": "string",
      "abstract": "string",
      "citation": "string",
      "url": "string",
      "doi": "string",
      "licence": "string",
      "published_year": 1
    }
  ],
  "meta": {
    "total_count": 1,
    "limit": 1,
    "offset": 1
  }
}

Paginated list of datasets

Get a realm

Path Parameters

id
Type: string
required

Realm identifier

Query Parameters

fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json
application/json

get/realms/{id}

curl 'https://globalecosystemsatlas.org/api/v1/realms/{id}'

Show Schema

{
  "data": {
    "id": "string",
    "name": "string",
    "color": "string",
    "description": "string"
  }
}

The requested realm

Get a biome

Path Parameters

id
Type: string
required

Biome identifier

Query Parameters

fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json
application/json

get/biomes/{id}

curl 'https://globalecosystemsatlas.org/api/v1/biomes/{id}'

Show Schema

{
  "data": {
    "id": "string",
    "name": "string",
    "color": "string",
    "description": "string",
    "realm": {
      "id": "string",
      "name": "string"
    }
  }
}

The requested biome

Get an ecosystem

Path Parameters

id
Type: string
required

Ecosystem (EFG) identifier

Query Parameters

fields
Type: string

Comma-separated list of fields to include in the response
lang
Type: string

Language for the resolved name/description (e.g. en, fr, es). Defaults to en; falls back to English when a translation is missing.

Responses

application/json
application/json

get/ecosystems/{id}

curl 'https://globalecosystemsatlas.org/api/v1/ecosystems/{id}'

Show Schema

{
  "data": {
    "id": "string",
    "name": "string",
    "color": "string",
    "ecosystem_class": "string",
    "description": "string",
    "area": 1,
    "biome": {
      "id": "string",
      "name": "string",
      "realm": {
        "id": "string",
        "name": "string"
      }
    }
  }
}

The requested ecosystem

Get a dataset

Path Parameters

id
Type: string
required

Dataset identifier

Query Parameters

fields
Type: string

Comma-separated list of fields to include in the response

Responses

application/json
application/json

get/datasets/{id}

curl 'https://globalecosystemsatlas.org/api/v1/datasets/{id}'

Show Schema

{
  "data": {
    "id": "string",
    "title": "string",
    "abstract": "string",
    "citation": "string",
    "url": "string",
    "doi": "string",
    "licence": "string",
    "published_year": 1
  }
}

The requested dataset

statistics (Collapsed)

Geospatial coverage statistics by country, grouping, or custom area

statistics Operations

get/stats/countries/{id}
get/stats/groupings/{id}
post/stats/custom
get/stats/global

contributions (Collapsed)

Submit suggestions to improve the underlying geospatial data

contributions Operations

post/suggestions

geography (Collapsed)

Countries and regional groupings reference data

geography Operations

get/locations
get/locations/{id}
get/groupings
get/groupings/{id}

lookup (Collapsed)

Look up ecosystem data at a point

lookup Operations

get/point/{lon}/{lat}

tiles (Collapsed)

Raster map tiles for the ecosystem layer

tiles Operations

get/tiles/{level}/{z}/{x}/{y}.png
get/tiles/ecosystems/tilejson.json

WMO Global Ecosystems Atlas API

taxonomy

List realms

List biomes

List ecosystems

List datasets

Get a realm

Get a biome

Get an ecosystem

Get a dataset

statistics (Collapsed)

contributions (Collapsed)

geography (Collapsed)

lookup (Collapsed)

tiles (Collapsed)

Models