AgroDataCube API v1 (legacy)
Legacy version of the AgroDataCube REST API for agri-food open data. Superseded by v2 but still available; uses the same access token.
Legacy version of the AgroDataCube REST API for agri-food open data. Superseded by v2 but still available; uses the same access token.
openapi: 3.0.3
info:
title: AgroDataCube API v1 (legacy)
version: '1.0'
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/v1/rest
security:
- tokenHeader: []
tags:
- name: Retrieve
- name: Return
paths:
/ahn:
get:
summary: Retrieve zonal statistics for altitude using the supplied geometry. If no epsg is provided
epsg = 28992 (RD) is assumed.
description: Retrieve zonal statistics for altitude using the supplied geometry. If no epsg is provided
epsg = 28992 (RD) is assumed. Currently only EPSGs 28992 (Dutch RD) and 4326 (WGS 84) are supported.
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:
- Retrieve
parameters:
- name: geometry
in: query
required: false
schema:
type: string
- name: epsg
in: query
required: false
schema:
type: integer
example: '4326'
/codes/cropcodes:
get:
summary: Retrieve a list of all possible cropcodes.
description: Retrieve a list of all possible cropcodes.
operationId: get_codes_cropcodes
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:
- Retrieve
parameters:
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/codes/cropcodes/{cropcode}:
get:
summary: Retrieve details for a specific cropcode.
description: Retrieve details for a specific cropcode.
operationId: get_codes_cropcodes_cropcode
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:
- Retrieve
parameters:
- name: cropcode
in: path
required: true
schema:
type: string
description: Path parameter cropcode.
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/codes/soilcodes:
get:
summary: Retrieve a list of all possible soilcodes.
description: Retrieve a list of all possible soilcodes.
operationId: get_codes_soilcodes
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:
- Retrieve
parameters:
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/codes/soilcodes/{soilcode}:
get:
summary: Retrieve details for a specific soilcode.
description: Retrieve details for a specific soilcode.
operationId: get_codes_soilcodes_soilcode
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:
- Retrieve
parameters:
- name: soilcode
in: path
required: true
schema:
type: string
description: Path parameter soilcode.
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields:
get:
summary: Retrieve the geometry and soil information of the intersections of the supplied geometry
and the fields. If no epsg is p
description: Retrieve the geometry and soil information of the intersections of the supplied geometry
and the fields. If no epsg is provided EPSG:28992 (Dutch RD) is assumed. Currently only EPSGs
28992 and 4326 (WGS 84) are supported.
operationId: get_fields
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:
- Retrieve
parameters:
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
- name: year
in: query
required: false
schema:
type: string
- name: cropcode
in: query
required: false
schema:
type: integer
- name: cropname
in: query
required: false
schema:
type: string
- name: geometry
in: query
required: false
schema:
type: string
- name: epsg
in: query
required: false
schema:
type: integer
example: '4326'
/fields/{fieldid}:
get:
summary: Retrieve the geometry and crop information for a specific crop field.
description: Retrieve the geometry and crop information for a specific crop field.
operationId: get_fields_fieldid
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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields/{fieldid}/ahn:
get:
summary: Retrieve altitude zonal statistics (in cm) based on AHN for a specific field.
description: Retrieve altitude zonal statistics (in cm) based on AHN for a specific field.
operationId: get_fields_fieldid_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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields/{fieldid}/meteostations:
get:
summary: Retrieve a list of the nearest meteostations to a specific field, ranked by distance.
description: Retrieve a list of the nearest meteostations to a specific field, ranked by distance.
operationId: get_fields_fieldid_meteostations
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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields/{fieldid}/ndvi:
get:
summary: Retrieve the available NDVI (Normalized Difference Vegetation Index) values for a specific
field and time period.
description: Retrieve the available NDVI (Normalized Difference Vegetation Index) values for a specific
field and time period.
operationId: get_fields_fieldid_ndvi
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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields/{fieldid}/soilparams:
get:
summary: Retrieve the spatial intersections of a field with the soil physical parameters geometries
(for more detailed informatio
description: 'Retrieve the spatial intersections of a field with the soil physical parameters geometries
(for more detailed information see http://content.alterra.wur.nl/Webdocs/PDFFiles/Alterrarapporten/AlterraRapport2387.pdf).
The soilparamid returned can be used to '
operationId: get_fields_fieldid_soilparams
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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/fields/{fieldid}/soiltypes:
get:
summary: 'Retrieve the spatial intersections of the field with the geometries of the soilmap 1 :
50.000. The soilid returned is th'
description: 'Retrieve the spatial intersections of the field with the geometries of the soilmap
1 : 50.000. The soilid returned is the objectid in the shapefile as provided by PDOK.'
operationId: get_fields_fieldid_soiltypes
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:
- Retrieve
parameters:
- name: fieldid
in: path
required: true
schema:
type: string
description: Path parameter fieldid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/meteodata:
get:
summary: Retrieve weather data from one of the meteostations for a specified time period. Dates
can be entered as yyyymmdd, yyyy
description: Retrieve weather data from one of the meteostations for a specified time period. Dates
can be entered as yyyymmdd, yyyymm, or yyyy.
operationId: get_meteodata
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:
- Retrieve
parameters:
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: meteostation
in: query
required: false
schema:
type: string
- name: fromdate
in: query
required: false
schema:
type: string
- name: todate
in: query
required: false
schema:
type: string
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/meteodata/{stationid}/{date}:
get:
summary: Retrieve weather data from one of the meteostations and for a specific date. The date
can be entered as yyyymmdd, yyyym
description: Retrieve weather data from one of the meteostations and for a specific date. The date
can be entered as yyyymmdd, yyyymm, or yyyy.
operationId: get_meteodata_stationid_date
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:
- Retrieve
parameters:
- name: stationid
in: path
required: true
schema:
type: string
description: Path parameter stationid.
- name: date
in: path
required: true
schema:
type: string
description: Path parameter date.
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/meteostations:
get:
summary: Return a list of all meteostations for which data is available.
description: Return a list of all meteostations for which data is available.
operationId: get_meteostations
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:
- Return
parameters:
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/meteostations/{meteostation}:
get:
summary: Return the data for the given meteostation.
description: Return the data for the given meteostation.
operationId: get_meteostations_meteostation
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:
- Return
parameters:
- name: meteostation
in: path
required: true
schema:
type: string
description: Path parameter meteostation.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/regions/municipalities:
get:
summary: Return all municipalities (gemeentes), based on the boundaries for 2015.
description: Return all municipalities (gemeentes), based on the boundaries for 2015.
operationId: get_regions_municipalities
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:
- Return
parameters:
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
/regions/postalcodes:
get:
summary: Return the dutch 6-positions postalcode areas.
description: Return the dutch 6-positions postalcode areas.
operationId: get_regions_postalcodes
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:
- Return
parameters:
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/regions/provences:
get:
summary: Return the provinces. These are the boundaries from 2015.
description: Return the provinces. These are the boundaries from 2015.
operationId: get_regions_provences
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:
- Return
parameters:
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/soilparams/{soilparamid}:
get:
summary: Return all the information for the given soilparamid.
description: Return all the information for the given soilparamid.
operationId: get_soilparams_soilparamid
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:
- Return
parameters:
- name: soilparamid
in: path
required: true
schema:
type: string
description: Path parameter soilparamid.
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/soiltypes:
get:
summary: Return the intersections of the supplied geometry and soilmap. If no epsg is provided epsg
= 28992 (RD) is assumed. Curr
description: Return the intersections of the supplied geometry and soilmap. If no epsg is provided
epsg = 28992 (RD) is assumed. Currently only epsg's 28992 and 4326 (WGS 84) are supported
operationId: get_soiltypes
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:
- Return
parameters:
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: geometry
in: query
required: false
schema:
type: string
- name: epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/soiltypes/{entityid}:
get:
summary: Return all the information for the given soilmap entityid.
description: Return all the information for the given soilmap entityid.
operationId: get_soiltypes_entityid
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:
- Return
parameters:
- name: entityid
in: path
required: true
schema:
type: string
description: Path parameter entityid.
- name: output_epsg
in: query
required: false
schema:
type: integer
example: '4326'
- name: page_size
in: query
required: false
schema:
type: integer
example: '25'
- name: page_offset
in: query
required: false
schema:
type: integer
example: '0'
/sources:
get:
summary: Return all information about availabe data
description: Return all information about availabe data
operationId: get_sources
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:
- Return
/sources/{resource_name}:
get:
summary: Return all information for the given resource
description: Return all information for the given resource
operationId: get_sources_resource_name
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:
- Return
parameters:
- name: resource_name
in: path
required: true
schema:
type: string
description: Path parameter resource_name.
components:
securitySchemes:
tokenHeader:
type: apiKey
in: header
name: token
description: Access token obtained via https://agrodatacube.wur.nl/api/register.jsp
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'
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
Geometry:
type: obj
# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/wageningen-university-research/refs/heads/main/openapi/wageningen-university-research-agrodatacube-v1.yaml