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

# Get measurements for this user

`GET /v3/measurements`

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.net/quantimo/apis/curedao-unified-health-api.md) · [All operations](https://skmtc.net/quantimo/apis/curedao-unified-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quantimo/curedao-unified-health-api/versions/7ac03025c3d2/schema)