---
title: "api/researchdata/{id}/data/{item} GET
List all research 'item' data within the consent=1 periods within a Research. The 'item' field indicates the type of data (apiaries/locations/devices/inspections/measurements/weather) to request within the research (which the user gave consent for to use). Example: inspectionsResponse: api/researchdata/1/inspections."
method: GET
path: "/api/researchdata/{id}/data/{item}"
tags: ["Api\\ResearchDataController"]
---

# api/researchdata/{id}/data/{item} GET
List all research 'item' data within the consent=1 periods within a Research. The 'item' field indicates the type of data (apiaries/locations/devices/inspections/measurements/weather) to request within the research (which the user gave consent for to use). Example: inspectionsResponse: api/researchdata/1/inspections.

`GET /api/researchdata/{id}/data/{item}`

## Headers

- `Authorization` string
- `Content-Type` string
- `Accept` string
- `Accept-language` string

## Request body

- object
  - `date_start` string — The date in 'YYYY-MM-DD HH:mm:ss' format (2020-01-01 00:00:00) to request data from (default is beginning of research, or earlier (except inspections and measurements).
  - `date_until` string — The date in 'YYYY-MM-DD HH:mm:ss' format (2020-09-29 23:59:59) to request data until (default is until the end of the user consent, or research end).
  - `year_months` string — Comma separated string of YYYY-MM strings to filter ONLY measurment data.
  - `device_ids` string — Comma separated string of device_ids to filter the measurements on (next to date_start and date_until).
  - `device_id` integer — The device_id to filter measurements on (next to date_start and date_until).
  - `location_ids` string — Comma separated string of location_ids to filter measurements (next to date_start and date_until).
  - `location_id` integer — The location_id to filter and measurements (next to date_start and date_until).
  - `measurements` string — Comma separated string of measurements (e.g. weight_kg,t_i,t_0,t_1) to query. Default: * (all measurments available).
  - `decimals` integer — Specifies the optional maximum amount of decimals that the (InfluxDB) calculation returns. Default: 2.
  - `interval` string — Specifies the optional (InfluxDB GROUPBY) time interval to interpolate measurements (*(all values)/1m/5m/30m/1h/1d/1w/30d/365d) m (minutes), h (hours), d (days), w (weeks). Default: 1d.
  - `calculation` string — Specifies the optional (InfluxDB) calculation (NONE/FIRST/LAST/MEAN/MEDIAN/MIN/MAX/SUM/COUNT/SPREAD/STDDEV/DERIVATIVE/PERCENTILE/BOXPLOT/PEAKS/WEEKMAP/NETWEIGHT) for use with time interval. Default: MEAN.
  - `calculation_prop` string — Specifies the optional (InfluxDB) calculation property for i.e. PERCENTILE/DERIVATIVE/etc). Default: null.
  - `limit` integer — Specifies the maximum number of measurements per location_research (InfluxDB LIMIT), Max: 5000. Default: 5000.
  - `precision` string — Specifies the optional InfluxDB format/precision (rfc3339/h/m/s/ms/u) of the timestamp of the measurements and weather data: rfc3339 (YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ), h (hours), m (minutes), s (seconds), ms (milliseconds), u (microseconds). Precision defaults to rfc3339.
  - `index` integer — Historic index of the interval from now. 0=period with current time included. 1=previous interval. Required without end.
  - `timezone` string — Provide the front-end timezone to correct the time from UTC to front-end time.
  - `output_csv_links` boolean — Optionally provide true if you want the data to be returned as an array of CSV files in stead of JSON data.

## Other responses

- `500`

## Changes

> 15 revisions in range; 1 could not be searched.

- **2023-06-22** `d8b6d710c501` — 1 info
  - endpoint added
- **2022-06-10** `568ca15f3476` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/beepnl/apis/beep/changes/api/researchdata/:id/data/:item/get.md)

---

[API](https://skmtc.dev/beepnl/apis/beep.md) · [All operations](https://skmtc.dev/beepnl/apis/beep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beepnl/beep/revisions/7f1e35deb524/schema)