Get measurement

Returns the details of a single measurement.

Request

GET /api/oauth/v2/resource/customers/values/{uuid}

WARNING

The previous path /api/oauth/v2/resource/customer-values is deprecated and still works. Use /api/oauth/v2/resource/customers/values for new integrations.

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string (UUID)	Yes	Unique UUID of the measurement

Response

Success (200 OK)

{
  "data": {
    "id": "9f8a1b2c-3d4e-5f60-8a1b-2c3d4e5f6071",
    "value": "120/80",
    "date": "2026-06-09",
    "valueType": {
      "id": "1e2d3c4b-5a69-4788-9f0e-1d2c3b4a5968",
      "name": "Blood pressure",
      "color": "#e34587",
      "unit": "mmHg",
      "abbreviation": "BP",
      "type": "range",
      "format": "decimal",
      "groupSeparator": ".",
      "showFirstOptionNull": false,
      "showAllCustomerOverview": true,
      "useMotherChildPass": false,
      "isDeleted": false,
      "enumOptionsList": []
    },
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    }
  }
}

Response fields

Field	Type	Description
data.id	string (UUID)	Unique UUID of the measurement
data.value	string | object | null	Measured value. For the types bmi, whr, and whtr an object (see below)
data.date	string | null	Measurement date (YYYY-MM-DD)
data.valueType	object	Measurement type
data.valueType.id	string (UUID)	UUID of the measurement type
data.valueType.name	string	Name of the measurement type
data.valueType.color	string | null	Color of the measurement type (hex)
data.valueType.unit	string | null	Unit of the measurement type
data.valueType.abbreviation	string | null	Abbreviation of the measurement type
data.valueType.type	string	Type of the measurement type (e.g. number, range, enum)
data.valueType.format	string | null	Number format (e.g. decimal, integer)
data.valueType.groupSeparator	string | null	Thousands separator
data.valueType.showFirstOptionNull	boolean	Show first enum option as empty
data.valueType.showAllCustomerOverview	boolean	Show in customer overview
data.valueType.useMotherChildPass	boolean	Use in mother-child pass
data.valueType.isDeleted	boolean	Measurement type deleted
data.valueType.enumOptionsList	array	Options for enum types
data.customer	object	Assigned customer
data.customer.id	string (UUID)	Customer ID
data.customer.firstName	string	First name
data.customer.lastName	string	Last name

Value for bmi, whr, and whtr

For these types, data.value is an object with the measurements and the calculated ratio:

Type	Structure of data.value
bmi	{"bodyHeight": 180, "bodyWeight": 80, "bmi": 24.7}
whr	{"waist": 90, "hip": 106, "waistToHipRatio": 0.85}
whtr	{"waist": 90, "height": 172, "waistToHeightRatio": 0.52}

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/customers/values/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope customers not present
404	not_found	Measurement not found