Wageningen University & Research Altitude API

openapi: 3.2.0
info:
  title: AgroDataCube API v2 Altitude API
  version: '2.1'
  description: 'Faithful OpenAPI 3.0 conversion of the public AgroDataCube Postman collection. AgroDataCube provides open and derived data for agri-food applications over the Netherlands, returning GeoJSON for vector resources and GeoTIFF for raster (_image) resources. Access requires a free token supplied via the ''token'' HTTP header. Source: Wageningen Environmental Research (WUR).'
  license:
    name: CC BY-NC-SA 4.0
    url: https://creativecommons.org/licenses/by-nc-sa/4.0/
  contact:
    name: AgroDataCube
    url: https://agrodatacube.wur.nl/
servers:
- url: https://agrodatacube.wur.nl/api/v2/rest
x-provenance:
  generated: '2026-08-30'
  method: derived
  source: openapi/_original/wageningen-university-research-agrodatacube-v2.yaml
  x-operator: institution
  operator_evidence: >-
    agrodatacube.wur.nl is a host under Wageningen University & Research's own registrable domain
    (wur.nl); AgroDataCube is operated by Wageningen Environmental Research. The contract is the
    institution's own, not a vendor's running under its name.
  repair: >-
    Re-based on 2026-08-30. refine-openapis welded this per-tag split onto the wrong parent: it wore
    "AgroDataCube API v1 (legacy) Altitude API" and base https://agrodatacube.wur.nl/api/v1/rest while the
    operations come from AgroDataCube API v2. The v1 base is retired — GET /api/v1/rest/fields and
    /api/v1/rest/sources both answered HTTP 404 (Tomcat "HTTP Status 404 - Not Found") on 2026-08-30 —
    so every operation here was documented against a dead server. Title, version and servers[] are now
    taken from the true parent. This is our defect, not the provider's.
  live_probe:
  - url: https://agrodatacube.wur.nl/api/v2/rest/fields
    status: 403
    note: 'route exists; body: {"status": "No token supplied, see https://agrodatacube.wur.nl/api/register.jsp"}'
  - url: https://agrodatacube.wur.nl/api/v1/rest/fields
    status: 404
    note: v1 base retired
security:
- tokenHeader: []
tags:
- name: Altitude
paths:
  /ahn:
    get:
      summary: Altitude zonal statistics for supplied geometry.
      description: Altitude zonal statistics for supplied geometry.
      operationId: get_ahn
      responses:
        '200':
          description: Successful response. AgroDataCube returns a GeoJSON FeatureCollection (vector resources) or a binary GeoTIFF image (raster *_image resources).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeatureCollection'
        '401':
          description: Missing or invalid access token.
        '404':
          description: Resource not found.
      security:
      - tokenHeader: []
      tags:
      - Altitude
      parameters:
      - name: geometry
        in: query
        required: false
        schema:
          type: string
        example: POLYGON((219478 481588.256000001,219478 497638.432,237339.072000001 497638.432,237339.072000001 481588.256000001,219478 481588.256000001))
      - name: epsg
        in: query
        required: false
        schema:
          type: integer
        example: '28992'
components:
  schemas:
    FeatureCollection:
      type: object
      description: GeoJSON FeatureCollection returned by vector resources.
      required:
      - type
      - features
      properties:
        type:
          type: string
          enum:
          - FeatureCollection
        features:
          type: array
          items:
            $ref: '#/components/schemas/Feature'
    Geometry:
      type: object
      description: GeoJSON geometry (Point, Polygon, MultiPolygon, etc.).
      required:
      - type
      - coordinates
      properties:
        type:
          type: string
          enum:
          - Point
          - LineString
          - Polygon
          - MultiPoint
          - MultiLineString
          - MultiPolygon
        coordinates:
          type: array
          items: {}
    Feature:
      type: object
      description: GeoJSON Feature with a geometry and a free-form properties map whose keys depend on the queried resource.
      required:
      - type
      - geometry
      - properties
      properties:
        type:
          type: string
          enum:
          - Feature
        geometry:
          $ref: '#/components/schemas/Geometry'
        properties:
          type: object
          additionalProperties: true
  securitySchemes:
    tokenHeader:
      type: apiKey
      in: header
      name: token
      description: Access token obtained via https://agrodatacube.wur.nl/api/register.jsp