Skip to main content

How the API is organised

The GraphQL schema groups its fields in three levels. Understanding this structure makes it easier to explore the schema in the GraphiQL Explorer and to write queries.

  1. Namespace — a top-level field per environmental domain, for example water or radiation.
  2. Category — a dataset within a domain, for example observations, nawa_trend or nis_survey.
  3. Table — the query fields that return the data, for example stations, data or data_live.

A query therefore descends from the namespace through the category to the table:

{
water { # namespace
observations { # category
stations(limit: 1) { # table
no
name
}
}
}
}

The same structure appears in the type names used throughout the GraphiQL Explorer: the type Water_Observations_Stations follows the Namespace_Category_Table convention.

Access

The endpoint is read-only and reachable without authentication. Data is retrieved with GraphQL queries; the schema defines no mutations or subscriptions. Cross-origin requests are permitted (CORS-enabled), so the endpoint can be called directly from a browser.