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

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

`GET /api/researchdata/{id}/user/{user_id}/{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).
  - `device_id` integer — The device_id to filter the measurements on (next to date_start and date_until).
  - `location_id` integer — The location_id to filter the hives, and measurements on (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: NONE.
  - `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 — value dient minimaal 0 te zijn.
  - `timezone` string — only in case of 1 device requested, to provide 'normal' data view. Must be a valid time zone, such as <code>Africa/Accra</code>.

## Response `200`

- object[]

## Changes

- **2023-06-22** `d8b6d710c501` — 9 info
  - added the new optional request property `calculation`
  - added the new optional request property `calculation_prop`
  - added the new optional request property `decimals`
  - added the new optional request property `index`
  - …5 more
- **2022-06-20** `a87569f002e1` — 1 info
  - added the new optional `header` request parameter `Accept-language`
- **2022-06-10** `568ca15f3476` — 10 warning
  - deleted the `header` request parameter `Accept-language`
  - removed the request property `calculation`
  - removed the request property `calculation_prop`
  - removed the request property `decimals`
  - …6 more

[Change history](https://skmtc.dev/beepnl/apis/beep/changes/api/researchdata/:id/user/:user_id/: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)