---
title: "Get measurements for this user"
method: GET
path: "/v3/measurements"
tags: ["measurements"]
---

# Get measurements for this user

`GET /v3/measurements`

## Request

- Base URL: `https://app.quantimo.do/api`
- URL: `https://app.quantimo.do/api/v3/measurements`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://app.quantimo.do/api/v1/oauth/authorize`
    - Token URL: `https://app.quantimo.do/api/v1/oauth/token` scopes: `readmeasurements`
- TypeScript: <https://skmtc.dev/quantimo/apis/curedao-unified-health-api/docs/v3/measurements/get.ts> (a function with typed inputs; its response is checked against the schema)

Measurements are any value that can be recorded like daily steps, a mood rating, or apples eaten.

## Query parameters

- `variableName` string
- `sort` string
- `limit` integer
- `offset` integer
- `variableCategoryName` 'Activities' | 'Books' | 'Causes of Illness' | 'Cognitive Performance' | 'Conditions' | 'Emotions' | 'Environment' | 'Foods' | 'Location' | 'Miscellaneous' | 'Movies and TV' | 'Music' | 'Nutrients' | 'Payments' | 'Physical Activity' | 'Physique' | 'Sleep' | 'Social Interactions' | 'Software' | 'Symptoms' | 'Treatments' | 'Vital Signs' | 'Goals'
- `updatedAt` string
- `userId` number
- `sourceName` string
- `connectorName` string
- `value` string
- `unitName` '% Recommended Daily Allowance' | '-4 to 4 Rating' | '0 to 1 Rating' | '0 to 5 Rating' | '1 to 10 Rating' | '1 to 5 Rating' | 'Applications' | 'Beats per Minute' | 'Calories' | 'Capsules' | 'Centimeters' | 'Count' | 'Degrees Celsius' | 'Degrees East' | 'Degrees Fahrenheit' | 'Degrees North' | 'Dollars' | 'Drops' | 'Event' | 'Feet' | 'Grams' | 'Hours' | 'Inches' | 'Index' | 'Kilocalories' | 'Kilograms' | 'Kilometers' | 'Liters' | 'Meters' | 'Micrograms' | 'Micrograms per decilitre' | 'Miles' | 'Milligrams' | 'Milliliters' | 'Millimeters' | 'Millimeters Merc' | 'Milliseconds' | 'Minutes' | 'Pascal' | 'Percent' | 'Pieces' | 'Pills' | 'Pounds' | 'Puffs' | 'Seconds' | 'Serving' | 'Sprays' | 'Tablets' | 'Torr' | 'Units' | 'Yes/No' | 'per Minute' | 'Doses' | 'Quarts' | 'Ounces' | 'International Units' | 'Meters per Second'
- `earliestMeasurementTime` string
- `latestMeasurementTime` string
- `createdAt` string
- `id` integer
- `groupingWidth` integer
- `groupingTimezone` string
- `doNotProcess` boolean
- `clientId` string
- `doNotConvert` boolean
- `minMaxFilter` boolean

## Response `200`

Successful operation

- Measurement[]
  - `card` Card
    - `actionSheetButtons` Button[]
      - `accessibilityText` string: Ex: connect
      - `action` object: Action data
      - `additionalInformation` string: Ex: connect
      - `color` string: Ex: #f2f2f2
      - `confirmationText` string: Text to show user before executing functionName
      - `functionName` string: Name of function to call
      - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string: Ex: connect
      - `id` string: HTML element id
      - `image` string: Ex: https://image.jpg
      - `ionIcon` string: Ex: ion-refresh
      - `link` string, required: Ex: https://local.quantimo.do
      - `stateName` string: State to go to
      - `stateParams` object: Data to provide to the state
      - `successToastText` string: Text to show user after executing functionName
      - `successAlertTitle` string: Text to show user after executing functionName
      - `successAlertBody` string: Text to show user after executing functionName
      - `text` string, required: Ex: Connect
      - `tooltip` string: Ex: This is a tooltip
      - `webhookUrl` string: Post here on button click
    - `avatar` string: Smaller square image
    - `avatarCircular` string: Smaller circular image
    - `backgroundColor` string: Ex: #f2f2f2
    - `buttons` Button[]
      - `accessibilityText` string: Ex: connect
      - `action` object: Action data
      - `additionalInformation` string: Ex: connect
      - `color` string: Ex: #f2f2f2
      - `confirmationText` string: Text to show user before executing functionName
      - `functionName` string: Name of function to call
      - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string: Ex: connect
      - `id` string: HTML element id
      - `image` string: Ex: https://image.jpg
      - `ionIcon` string: Ex: ion-refresh
      - `link` string, required: Ex: https://local.quantimo.do
      - `stateName` string: State to go to
      - `stateParams` object: Data to provide to the state
      - `successToastText` string: Text to show user after executing functionName
      - `successAlertTitle` string: Text to show user after executing functionName
      - `successAlertBody` string: Text to show user after executing functionName
      - `text` string, required: Ex: Connect
      - `tooltip` string: Ex: This is a tooltip
      - `webhookUrl` string: Post here on button click
    - `buttonsSecondary` Button[]
      - `accessibilityText` string: Ex: connect
      - `action` object: Action data
      - `additionalInformation` string: Ex: connect
      - `color` string: Ex: #f2f2f2
      - `confirmationText` string: Text to show user before executing functionName
      - `functionName` string: Name of function to call
      - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string: Ex: connect
      - `id` string: HTML element id
      - `image` string: Ex: https://image.jpg
      - `ionIcon` string: Ex: ion-refresh
      - `link` string, required: Ex: https://local.quantimo.do
      - `stateName` string: State to go to
      - `stateParams` object: Data to provide to the state
      - `successToastText` string: Text to show user after executing functionName
      - `successAlertTitle` string: Text to show user after executing functionName
      - `successAlertBody` string: Text to show user after executing functionName
      - `text` string, required: Ex: Connect
      - `tooltip` string: Ex: This is a tooltip
      - `webhookUrl` string: Post here on button click
    - `content` string: Ex: Content
    - `headerTitle` string: Ex: Title
    - `html` string: HTML for the entire card.
    - `htmlContent` string: Ex: <div>Content</div>
    - `id` string, required: HTML element id
    - `image` string: Larger image of variable dimensions
    - `inputFields` InputField[]
      - `displayName` string, required
      - `helpText` string
      - `hint` string
      - `icon` string
      - `id` string: HTML element id
      - `image` string
      - `key` string
      - `labelLeft` string
      - `labelRight` string
      - `link` string
      - `maxLength` integer
      - `maxValue` number
      - `minLength` integer
      - `minValue` number
      - `options` string[]: Selector list options
      - `placeholder` string: Ex: Title
      - `postUrl` string
      - `required` boolean
      - `show` boolean: Ex: Title
      - `submitButton` Button
        - `accessibilityText` string: Ex: connect
        - `action` object: Action data
        - `additionalInformation` string: Ex: connect
        - `color` string: Ex: #f2f2f2
        - `confirmationText` string: Text to show user before executing functionName
        - `functionName` string: Name of function to call
        - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
        - `html` string: Ex: connect
        - `id` string: HTML element id
        - `image` string: Ex: https://image.jpg
        - `ionIcon` string: Ex: ion-refresh
        - `link` string, required: Ex: https://local.quantimo.do
        - `stateName` string: State to go to
        - `stateParams` object: Data to provide to the state
        - `successToastText` string: Text to show user after executing functionName
        - `successAlertTitle` string: Text to show user after executing functionName
        - `successAlertBody` string: Text to show user after executing functionName
        - `text` string, required: Ex: Connect
        - `tooltip` string: Ex: This is a tooltip
        - `webhookUrl` string: Post here on button click
      - `type` 'check_box' | 'date' | 'email' | 'number' | 'postal_code' | 'select_option' | 'string' | 'switch' | 'text_area' | 'unit' | 'variable_category', required: Ex: Title
      - `validationPattern` string: See http://html5pattern.com/ for examples
      - `value` string
    - `ionIcon` string: Ex: ion-refresh
    - `link` string: A link to a web page or something. Not much more to say about that.
    - `parameters` object: Key value pairs derived from user input fields, button clicks, or preset defaults
    - `relatedCards` Card[]
    - `selectedButton` Button
      - `accessibilityText` string: Ex: connect
      - `action` object: Action data
      - `additionalInformation` string: Ex: connect
      - `color` string: Ex: #f2f2f2
      - `confirmationText` string: Text to show user before executing functionName
      - `functionName` string: Name of function to call
      - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string: Ex: connect
      - `id` string: HTML element id
      - `image` string: Ex: https://image.jpg
      - `ionIcon` string: Ex: ion-refresh
      - `link` string, required: Ex: https://local.quantimo.do
      - `stateName` string: State to go to
      - `stateParams` object: Data to provide to the state
      - `successToastText` string: Text to show user after executing functionName
      - `successAlertTitle` string: Text to show user after executing functionName
      - `successAlertBody` string: Text to show user after executing functionName
      - `text` string, required: Ex: Connect
      - `tooltip` string: Ex: This is a tooltip
      - `webhookUrl` string: Post here on button click
    - `sharingBody` string: Ex: sharingBody
    - `sharingButtons` Button[]
      - `accessibilityText` string: Ex: connect
      - `action` object: Action data
      - `additionalInformation` string: Ex: connect
      - `color` string: Ex: #f2f2f2
      - `confirmationText` string: Text to show user before executing functionName
      - `functionName` string: Name of function to call
      - `parameters` object: Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string: Ex: connect
      - `id` string: HTML element id
      - `image` string: Ex: https://image.jpg
      - `ionIcon` string: Ex: ion-refresh
      - `link` string, required: Ex: https://local.quantimo.do
      - `stateName` string: State to go to
      - `stateParams` object: Data to provide to the state
      - `successToastText` string: Text to show user after executing functionName
      - `successAlertTitle` string: Text to show user after executing functionName
      - `successAlertBody` string: Text to show user after executing functionName
      - `text` string, required: Ex: Connect
      - `tooltip` string: Ex: This is a tooltip
      - `webhookUrl` string: Post here on button click
    - `sharingTitle` string: Ex: sharingTitle
    - `subHeader` string: Ex: subTitle
    - `subTitle` string: Ex: subTitle
    - `title` string: Ex: Title
  - `clientId` string: Ex: curedao
  - `connectorId` integer: Ex: 13
  - `createdAt` string: Ex: 2017-07-30 21:08:36
  - `displayValueAndUnitString` string: Examples: 3/5, $10, or 1 count
  - `iconIcon` string: Ex: ion-sad-outline
  - `id` integer: Ex: 1051466127
  - `inputType` string: Ex: value
  - `ionIcon` string: Ex: ion-ios-medkit-outline
  - `manualTracking` boolean: Ex: 1
  - `maximumAllowedValue` number, double: Ex: 5. Unit: User-specified or common.
  - `minimumAllowedValue` number, double: Ex: 1. Unit: User-specified or common.
  - `note` string: Note of measurement
  - `noteObject` object: Additional meta data for the measurement
  - `noteHtml` object: Embeddable HTML with message hyperlinked with associated url
  - `originalUnitId` integer: Ex: 23
  - `originalValue` number, double: Original value submitted. Unit: Originally submitted.
  - `pngPath` string: Ex: img/variable_categories/treatments.png
  - `pngUrl` string: Ex: https://web.quantimo.do/img/variable_categories/treatments.png
  - `productUrl` string: Link to associated product for purchase
  - `sourceName` string, required: Application or device used to record the measurement values
  - `startDate` string: Ex: 2014-08-27
  - `startTimeEpoch` integer: Seconds between the start of the event measured and 1970 (Unix timestamp)
  - `startTimeString` string, required: Start Time for the measurement event in UTC ISO 8601 YYYY-MM-DDThh:mm:ss
  - `svgUrl` string: Ex: https://web.quantimo.do/img/variable_categories/treatments.svg
  - `unitAbbreviatedName` string, required: Abbreviated name for the unit of measurement
  - `unitCategoryId` integer: Ex: 6
  - `unitCategoryName` string: Ex: Miscellany
  - `unitId` integer: Ex: 23
  - `unitName` string: Ex: Count
  - `updatedAt` string: Ex: 2017-07-30 21:08:36
  - `url` string: Link to associated Facebook like or Github commit, for instance
  - `userVariableUnitAbbreviatedName` string: Ex: count
  - `userVariableUnitCategoryId` integer: Ex: 6
  - `userVariableUnitCategoryName` string: Ex: Miscellany
  - `userVariableUnitId` integer: Ex: 23
  - `userVariableUnitName` string: Ex: Count
  - `userVariableVariableCategoryId` integer: Ex: 13
  - `userVariableVariableCategoryName` string: Ex: Treatments
  - `valence` string: Valence indicates what type of buttons should be used when recording measurements for this variable. positive - Face buttons with the happiest face equating to a 5/5 rating where higher is better like Overall Mood. negative - Face buttons with happiest face equating to a 1/5 rating where lower is better like Headache Severity. numeric - Just 1 to 5 numeric buttons for neutral variables.
  - `value` number, double, required: Converted measurement value in requested unit
  - `variableCategoryId` integer: Ex: 13
  - `variableCategoryImageUrl` string: Ex: https://static.quantimo.do/img/variable_categories/pill-96.png
  - `variableCategoryName` 'Activity' | 'Books' | 'Causes of Illness' | 'Cognitive Performance' | 'Conditions' | 'Emotions' | 'Environment' | 'Foods' | 'Goals' | 'Locations' | 'Miscellaneous' | 'Movies and TV' | 'Music' | 'Nutrients' | 'Payments' | 'Physical Activities' | 'Physique' | 'Sleep' | 'Social Interactions' | 'Software' | 'Symptoms' | 'Treatments' | 'Vital Signs': Ex: Emotions, Treatments, Symptoms...
  - `variableDescription` string: Valence indicates what type of buttons should be used when recording measurements for this variable. positive - Face buttons with the happiest face equating to a 5/5 rating where higher is better like Overall Mood. negative - Face buttons with happiest face equating to a 1/5 rating where lower is better like Headache Severity. numeric - Just 1 to 5 numeric buttons for neutral variables.
  - `variableId` integer: Ex: 5956846
  - `variableName` string, required: Name of the variable for which we are creating the measurement records
  - `displayName` string: Ex: Trader Joe's Bedtime Tea

## Other responses

- `401`: Not Authenticated

---

[API](https://skmtc.dev/quantimo/apis/curedao-unified-health-api.md) - [All operations](https://skmtc.dev/quantimo/apis/curedao-unified-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quantimo/apis/curedao-unified-health-api/revisions/7ac03025c3d2?raw)