Measurements

Measurements represent values submitted via measurement series. Each measurement has a measurement type, unit, source, and subject.

https://api.validere.io/app

List measurements of a measurement series

Search for measurements of a measurement series using a number of query parameters.

Get list of measurements

get

Authorizations

StagingIntegrationLocal

Path parameters

measurement_series_idstring · uuidRequired

ID of the measurement series

Query parameters

group_bystringOptional

group by

Example: measurement_type

intervalundefined · enumOptional

interval

Example: 1dayPossible values:

funcundefined · enumOptional

Aggregate Function

Example: avgPossible values:

startstring · date-timeOptional

start date - default value is current date time

Example: 2022-11-20T09:12:28.000Z

endstring · date-timeOptional

end date

Example: 2022-11-30T09:12:28.000Z

page_sizenumberOptional

page size

pagenumberOptional

page number

sort_bystringOptional

sort by

sort_directionstring · enumOptional

sort direction

Example: descPossible values:

subject_idstring · uuidOptional

ID of the entity you want to list the measurements for

subject_typestring · enumOptional

Type of the entity you want to list the measurements for. Required if ID is defined.

Possible values:

Responses

200

successful operation

application/json

get

/app/v1/measurements/{measurement_series_id}

HTTPcURLJavaScriptPython

GET /app/v1/measurements/{measurement_series_id} HTTP/1.1
Host: api.validere.io
Accept: */*

200

successful operation

{
  "page_number": 0,
  "page_size": 10,
  "total_entries": 58,
  "total_pages": 6,
  "data": [
    {
      "measure_name": "methane_concentration",
      "measure_value": 456,
      "msid": "123e4567-e89b-12d3-a456-426614174000",
      "time": "2026-01-26T13:55:44.487Z"
    }
  ]
}

List measurements (aggregated list)

Search for aggregated measurements using a number of query parameters.

• device_id is a reference to a model of a representation that is the source of these measurements

Get aggregated list of measurements

get

Authorizations

StagingIntegrationLocal

Query parameters

device_idstring · uuidRequired

Id of device

Example: 748970de-fd1f-4494-ae3f-47cc21ff205f

group_bystringOptional

group by

Example: measurement_type

intervalundefined · enumOptional

interval

Example: 1dayPossible values:

funcundefined · enumOptional

Aggregate Function

Example: avgPossible values:

startstring · date-timeOptional

start date - default value is current date time

Example: 2022-11-20T09:12:28.000Z

endstring · date-timeOptional

end date

Example: 2022-11-30T09:12:28.000Z

page_sizenumberOptional

page size

pagenumberOptional

page number

sort_bystringOptional

sort by

sort_directionstring · enumOptional

sort direction

Example: descPossible values:

Responses

200

successful operation

application/json

get

/app/v1/measurements

HTTPcURLJavaScriptPython

GET /app/v1/measurements?device_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.validere.io
Accept: */*

200

successful operation

{
  "page_number": 0,
  "page_size": 10,
  "total_entries": 58,
  "total_pages": 6,
  "data": [
    {
      "measure_name": "methane_concentration",
      "measure_value": 456,
      "msid": "123e4567-e89b-12d3-a456-426614174000",
      "time": "2026-01-26T13:55:44.487Z"
    }
  ]
}

Get measurements for a measurement type

Get measurements for a measurement type

get

Authorizations

StagingIntegrationLocal

Path parameters

measurement_typestringRequired

Measurement type of the measurements being retrieved

Example: volume

Query parameters

device_idstring · uuidOptional

ID of device

Example: 748970de-fd1f-4494-ae3f-47cc21ff205f

subject_idstring · uuidOptional

ID of the entity you want to list the measurement types for

subject_typestring · enumOptional

Type of the entity you want to list the measurement types for. Required if ID is defined.

Possible values:

include_formsbooleanOptional

If form measurements should be included

form_submission_statusesstringOptional

Form submission status to filter on, can be comma separated list

measurement_series_idsstringOptional

a comma-separated list of measurement series ids

startstring · date-timeOptional

start date - default value is current date time

Example: 2022-11-20T09:12:28.000Z

endstring · date-timeOptional

end date

Example: 2022-11-30T09:12:28.000Z

intervalundefined · enumOptional

interval

Example: 1dayPossible values:

funcundefined · enumOptional

Aggregate Function

Example: avgPossible values:

Responses

200

successful operation

application/json

get

/app/v1/measurements/plot/{measurement_type}

HTTPcURLJavaScriptPython

GET /app/v1/measurements/plot/{measurement_type} HTTP/1.1
Host: api.validere.io
Accept: */*

200

successful operation

{
  "form": {
    "data": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "measure_value": 456,
      "time": "2026-01-26T13:55:44.487Z",
      "form_submission_id": "123e4567-e89b-12d3-a456-426614174000",
      "form_submission_status": "pending",
      "form_schema": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text"
      },
      "form_category": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text"
      }
    }
  },
  "series": [
    {
      "measurement_series_id": "123e4567-e89b-12d3-a456-426614174000",
      "description": "text",
      "data": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "measure_value": 456,
        "time": "2026-01-26T13:55:44.487Z",
        "form_submission_id": "123e4567-e89b-12d3-a456-426614174000",
        "form_submission_status": "pending",
        "form_schema": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        },
        "form_category": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text"
        }
      }
    }
  ]
}