v1

latestOpenAPI 3.0.1GNU General Public License v3 (GPL-3)2026-07-145265194.5 KB
measurements

Get measurements for this user

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

get/v3/measurements

Query parameters

variableNamestring

Name of the variable you want measurements for

sortstring

Sort by one of the listed field names. If the field name is prefixed with -, it will sort in descending order.

limitinteger

The LIMIT is used to limit the number of results returned. So if youhave 1000 results, but only want to the first 10, you would set this to 10 and offset to 0. The maximum limit is 200 records.

offsetinteger

OFFSET says to skip that many rows before beginning to return rows to the client. OFFSET 0 is the same as omitting the OFFSET clause.If both OFFSET and LIMIT appear, then OFFSET rows are skipped before starting to count the LIMIT rows that are returned.

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'

Ex: Emotions, Treatments, Symptoms...

updatedAtstring

When the record was last updated. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format. Time zone should be UTC and not local.

userIdnumber

User's id

sourceNamestring

ID of the source you want measurements for (supports exact name match only)

connectorNamestring

Ex: facebook

valuestring

Value of measurement

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'

Ex: Milligrams

earliestMeasurementTimestring

Excluded records with measurement times earlier than this value. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format. Time zone should be UTC and not local.

latestMeasurementTimestring

Excluded records with measurement times later than this value. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format. Time zone should be UTC and not local.

createdAtstring

When the record was first created. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format. Time zone should be UTC and not local.

idinteger

Measurement id

groupingWidthinteger

The time (in seconds) over which measurements are grouped together

groupingTimezonestring

The time (in seconds) over which measurements are grouped together

doNotProcessboolean

Ex: true

clientIdstring

Your CureDAO client id can be obtained by creating an app at https://builder.quantimo.do

doNotConvertboolean

Ex: 1

minMaxFilterboolean

Ex: 1

Response

Successful operation

clientIdstring

Ex: curedao

connectorIdinteger

Ex: 13

createdAtstring

Ex: 2017-07-30 21:08:36

displayValueAndUnitStringstring

Examples: 3/5, $10, or 1 count

iconIconstring

Ex: ion-sad-outline

idinteger

Ex: 1051466127

inputTypestring

Ex: value

ionIconstring

Ex: ion-ios-medkit-outline

manualTrackingboolean

Ex: 1

maximumAllowedValuenumber double

Ex: 5. Unit: User-specified or common.

minimumAllowedValuenumber double

Ex: 1. Unit: User-specified or common.

notestring

Note of measurement

noteObjectobject

Additional meta data for the measurement

noteHtmlobject

Embeddable HTML with message hyperlinked with associated url

originalUnitIdinteger

Ex: 23

originalValuenumber double

Original value submitted. Unit: Originally submitted.

pngPathstring

Ex: img/variable_categories/treatments.png

productUrlstring

Link to associated product for purchase

sourceNamestring required

Application or device used to record the measurement values

startDatestring

Ex: 2014-08-27

startTimeEpochinteger

Seconds between the start of the event measured and 1970 (Unix timestamp)

startTimeStringstring required

Start Time for the measurement event in UTC ISO 8601 YYYY-MM-DDThh:mm:ss

unitAbbreviatedNamestring required

Abbreviated name for the unit of measurement

unitCategoryIdinteger

Ex: 6

unitCategoryNamestring

Ex: Miscellany

unitIdinteger

Ex: 23

unitNamestring

Ex: Count

updatedAtstring

Ex: 2017-07-30 21:08:36

urlstring

Link to associated Facebook like or Github commit, for instance

userVariableUnitAbbreviatedNamestring

Ex: count

userVariableUnitCategoryIdinteger

Ex: 6

userVariableUnitCategoryNamestring

Ex: Miscellany

userVariableUnitIdinteger

Ex: 23

userVariableUnitNamestring

Ex: Count

userVariableVariableCategoryIdinteger

Ex: 13

userVariableVariableCategoryNamestring

Ex: Treatments

valencestring

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.

valuenumber double required

Converted measurement value in requested unit

variableCategoryIdinteger

Ex: 13

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...

variableDescriptionstring

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.

variableIdinteger

Ex: 5956846

variableNamestring required

Name of the variable for which we are creating the measurement records

displayNamestring

Ex: Trader Joe's Bedtime Tea