NAV
shell javascript

Introduction


# Each endpoint will show an example request with demo data.

# You can use this demo data when developing your application.
# See the guide for more info: http://hub.humanapi.co/docs/demo-data

# Example Human API request...
curl "https://api.humanapi.co/v1/human/<resource>?access_token=demo"

# which would return a JSON payload similar to:

{
  "id": "5510259685cc310900f67753",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "source": "<sourcename>",
  "sourceData": {},
    ...
  "createdAt": "2015-10-11T14:39:19.065Z",
  "updatedAt": "2015-10-11T14:39:19.065Z"
}

// Each endpoint will have an example request with demo data demo data.

// You can use this demo data when developing your application.
// See the guide for more info: http://hub.humanapi.co/docs/demo-data

// Example Human API request in nodejs...
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/<resource>?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// which would return a JSON payload similar to:

{
  "id": "5510259685cc310900f67753",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "source": "<sourcename>",
  "sourceData": {},
    ...
  "createdAt": "2015-10-11T14:39:19.065Z",
  "updatedAt": "2015-10-11T14:39:19.065Z"
}

Welcome to Human API!

You can use Human API to retrieve normalized health data from your app’s users from thousands of unique sources.

Getting Started

Before you’ll be able to use Human API to query real data, you’ll need to create an account and implement Human Connect to authenticate external sources.


What are you waiting for? Get Started!

Common Record Properties

Regardless of the type, most data records have a few standard properties:

Property Type Description
id String The Id of the Human API record
humanId String Unique Human API user identifier
source String The name of the originating source (all lowercase, no spaces)
sourceData Object Unique properties from a source that do not fit the main data model
createdAt Date The time the record was created on the Human API server
updatedAt Date The time the record was updated on the Human API server

If you have not already, we highly recommend reading the API Patterns & Conventions guide to familiarize yourself with how to filter for these parameters so you only get the data that you need. In general, data records contain information from the data source that has been normalized to standard units and parameters. Any source-specific information will be passed through via the optional sourceData object.

For the full documentation including step-by-step implementation guides and information on data sources, see http://hub.humanapi.co

HAPI coding!

Medical API

# Codes Array
"codes": [
    {
        "code": "10831",
        "codeSystem": "2.16.840.1.113883.6.88",
        "codeSystemName": "RxNorm",
        "name": "Bactrim"
    },
    {
        "code": "N0000008034",
        "codeSystem": "2.16.840.1.113883.3.26.1.5",
        "codeSystemName": "NDF-RT",
        "name": "Sulfa (Sulfonamide Antibiotics)"
    }
]

# Organization Object
"organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  }

// Codes Array
"codes": [
    {
        "code": "10831",
        "codeSystem": "2.16.840.1.113883.6.88",
        "codeSystemName": "RxNorm",
        "name": "Bactrim"
    },
    {
        "code": "N0000008034",
        "codeSystem": "2.16.840.1.113883.3.26.1.5",
        "codeSystemName": "NDF-RT",
        "name": "Sulfa (Sulfonamide Antibiotics)"
    }
]

// Organization Object
"organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  }

The Medical API provides access to user’s medical records from health providers. In this section you will see some common objects to many of the Medical API endpoints. If you are interested accessing the Medical API, send us an email at enterprise@humanapi.co.

Codes Object

The codes array provides code objects with specific classifications from medical coding systems (when available).

Property Type Description
code String Medical code
codeSystem String The identifier of the code system that the code belongs to
codeSystemName String The name of the code system that the code belongs to
name String The name of the code

Organization Object

Property Type Description
id String The Id of the organization
name String The name of the organization
href String Human API organizations endpoint URL to retrieve full details

See organizations for more information.

Allergies

# Get all allergies associated with the user
curl "https://api.humanapi.co/v1/human/medical/allergies?access_token=demo"

# Returns a json array of allergies:
[
    {
        "createdAt": "2014-10-19T21:02:17.949Z",
        "id": "544323ae5b48098829dcc437",
        "name": "Oxycodone",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "patient": {
            "name": "Maxwell Forrest"
        },
        "reactionsFull": [],
        "source": "emr-1-320",
        "updatedAt": "2014-10-19T21:02:17.949Z"
        "allergen": {
            "codes": []
        },
        "codes": [
            {
                "code": "10831",
                "codeSystem": "2.16.840.1.113883.6.88",
                "codeSystemName": "RxNorm",
                "name": "Bactrim"
            },
            {
                "code": "N0000008034",
                "codeSystem": "2.16.840.1.113883.3.26.1.5",
                "codeSystemName": "NDF-RT",
                "name": "Sulfa (Sulfonamide Antibiotics)"
            }
        ]
    },
    {
        "id": "544323ae5b48098829dcc438",
        "name": "Metaxalone",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "patient": {
            "name": "Maxwell Forrest"
        },
        "reactionsFull": [],
        "source": "emr-1-320",       
        "createdAt": "2014-10-19T21:02:17.949Z",
        "updatedAt": "2014-10-19T21:02:17.949Z",
        "allergen": {
            "codes": []
        },
        "codes": [
            {
                "code": "10831",
                "codeSystem": "2.16.840.1.113883.6.88",
                "codeSystemName": "RxNorm",
                "name": "Bactrim"
            },
            {
                "code": "N0000008034",
                "codeSystem": "2.16.840.1.113883.3.26.1.5",
                "codeSystemName": "NDF-RT",
                "name": "Sulfa (Sulfonamide Antibiotics)"
            }
        ]
    }
]

# Get an allergy by id
curl "https://api.humanapi.co/v1/human/medical/allergies/544323ae5b48098829dcc437?access_token=demo"
{
    "id": "544323ae5b48098829dcc437",
    "createdAt": "2014-10-19T21:02:17.949Z",
    "updatedAt": "2014-10-19T21:02:17.949Z"
    "name": "Oxycodone",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "reactionsFull": [],
    "source": "emr-1-320",
    "allergen": {
        "codes": []
    },
    "codes": [
        {
            "code": "10831",
            "codeSystem": "2.16.840.1.113883.6.88",
            "codeSystemName": "RxNorm",
            "name": "Bactrim"
        },
        {
            "code": "N0000008034",
            "codeSystem": "2.16.840.1.113883.3.26.1.5",
            "codeSystemName": "NDF-RT",
            "name": "Sulfa (Sulfonamide Antibiotics)"
        }
    ]
}
// Get all allergies associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/allergies?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of allergies:
[
    {
        "createdAt": "2014-10-19T21:02:17.949Z",
        "id": "544323ae5b48098829dcc437",
        "name": "Oxycodone",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "patient": {
            "name": "Maxwell Forrest"
        },
        "reactionsFull": [],
        "source": "emr-1-320",
        "updatedAt": "2014-10-19T21:02:17.949Z"
        "allergen": {
            "codes": []
        },
        "codes": [
            {
                "code": "10831",
                "codeSystem": "2.16.840.1.113883.6.88",
                "codeSystemName": "RxNorm",
                "name": "Bactrim"
            },
            {
                "code": "N0000008034",
                "codeSystem": "2.16.840.1.113883.3.26.1.5",
                "codeSystemName": "NDF-RT",
                "name": "Sulfa (Sulfonamide Antibiotics)"
            }
        ]
    },
    {
        "id": "544323ae5b48098829dcc438",
        "name": "Metaxalone",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "patient": {
            "name": "Maxwell Forrest"
        },
        "reactionsFull": [],
        "source": "emr-1-320",       
        "createdAt": "2014-10-19T21:02:17.949Z",
        "updatedAt": "2014-10-19T21:02:17.949Z",
        "allergen": {
            "codes": []
        },
        "codes": [
            {
                "code": "10831",
                "codeSystem": "2.16.840.1.113883.6.88",
                "codeSystemName": "RxNorm",
                "name": "Bactrim"
            },
            {
                "code": "N0000008034",
                "codeSystem": "2.16.840.1.113883.3.26.1.5",
                "codeSystemName": "NDF-RT",
                "name": "Sulfa (Sulfonamide Antibiotics)"
            }
        ]
    }
]

// Get an allergy by id
request
.get('https://api.humanapi.co/v1/human/medical/allergies/544323ae5b48098829dcc437?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as allergy:
{
    "id": "544323ae5b48098829dcc437",
    "createdAt": "2014-10-19T21:02:17.949Z",
    "updatedAt": "2014-10-19T21:02:17.949Z"
    "name": "Oxycodone",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "reactionsFull": [],
    "source": "emr-1-320",
    "allergen": {
        "codes": []
    },
    "codes": [
        {
            "code": "10831",
            "codeSystem": "2.16.840.1.113883.6.88",
            "codeSystemName": "RxNorm",
            "name": "Bactrim"
        },
        {
            "code": "N0000008034",
            "codeSystem": "2.16.840.1.113883.3.26.1.5",
            "codeSystemName": "NDF-RT",
            "name": "Sulfa (Sulfonamide Antibiotics)"
        }
    ]
}

Get a list of medical allergies the user has had so far

Get Allergies

Returns a list of medical allergies

GET https://api.humanapi.co/v1/human/medical/allergies

Returns a single allergy

GET https://api.humanapi.co/v1/human/medical/allergies/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the resource
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
name String The name of the allergy (e.g. ‘Etomidate’, 'Fluconazole’, 'Metaxalone’)
patient Object Patient information (“name” and other optional attributes)
organization Object Hospital information (See organizations)
reactionsFull Array[Object] Reactions information (see below)
allergen Object Allergen information (see below)
status String The status of the allergy
severity String The severity of the allergy
dateRange Object Date Range information (see below)
codes Object See codes object

Allergen Object

Property Type Description
name String Name of the allergen
codes Object See codes object

Reactions Object

Property Type Description
name String Name of the allergen
codes Object See codes object
reactionType Object Reaction type information (see below)

ReactionType Object

Property Type Description
name String Name of the reaction
codes Object See codes object

Date Range Object

Property Type Description
start Date Start date
end date End date

Encounters

# Get all encounters associated with the user
curl "https://api.humanapi.co/v1/human/medical/encounters?access_token=demo"

# Returns a json array of encounters:
[{
  "id": "54442e1f8bbb040d5388e842",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:19.971Z",
  "createdAt": "2014-10-19T21:33:19.971Z",
  "dateTime": "2014-07-21T17:30:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Cardiomyopathy (HCC) - Primary",
      "href": "/medical/issues/5524a98cg684832301dfc760"
    }
  ],
  "prescriptions": [
    {
      "name": "metolazone 2 MG tablet",
      "href": "/medical/medications/5724a91ef682832301dfc193"
    }
  ],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "LAB",
    "departmentName": "Asheville Goosetown Laboratory"
  },
  "reasons": ["Ear Problem"],
  "orders": [{
    "name": "LIPID PROFILE",
    "codeType": "Custom",
    "expectedDate": "2012-01-19T05:00:00.000Z",
    "expireDate": "2013-01-18T05:00:00.000Z",
    "procedureCode": "LABLIPID",
    "type": "LAB CHEMISTRY"
  }],
  "medications": [{
    "canRefill": false,
    "genericProductIndicator": "42200032301810",
    "hasPendingRefill": false,
    "name": "FLUTICASONE PROPIONATE (NASAL) 50 MCG/ACT NA SUSP",
    "ndcCode": "0054-3270-99",
    "startDate": "2010-09-17T04:00:00.000Z"
  }, {
    "canRefill": false,
    "genericProductIndicator": "01200010100315",
    "hasPendingRefill": false,
    "name": "Amoxicillin 875 MG OR TABS",
    "ndcCode": "0093-2264-01",
    "startDate": "2010-09-17T04:00:00.000Z"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54442e2bde98810f537ba16f",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:31.112Z",
  "createdAt": "2014-10-19T21:33:31.112Z",
  "dateTime": "2011-04-04T18:15:00.000Z",
  "visitType": "Hospital Outpatient Visit",
  "diagnoses": [
    {
      "name": "Senile Nuclear Sclerosis"
      "href": "/medical/issues/5723d9a5f683891300dfbd90",
    }, {
      "name": "Dermatochalasis"
      "href": "/medical/issues/5723d9a5f6838913s9d8fd61",
    }
  ],
  "prescriptions": [],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "Lenard Linkovich, MD",
    "departmentName": "Physiatry"
  },
  "reasons": [],
  "orders": [],
  "medications": [],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}, {
  "id": "54442e34afe02911538d01e9",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:40.086Z",
  "createdAt": "2014-10-19T21:33:40.086Z",
  "dateTime": "2013-01-25T05:00:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Unspecified Constipation",
      "href": "/medical/issues/5723d9a5f683891300dfbd90",
    }, {
      "name": "Rectal Bleeding",
      "href": "/medical/issues/5723d9a5f683891300dfbd90",

    }
    ],
  "prescriptions": [],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "Jarred Bancroft, MD",
    "departmentName": "Dermatology"
  },
  "reasons": [],
  "orders": [{
    "name": "Multi-test Laboratory Panels",
    "codeType": "CPT(R)",
    "procedureCode": "80053",
    "type": "Lab"
  }, {
    "name": "Multi-test Laboratory Panels",
    "codeType": "CPT(R)",
    "procedureCode": "80061",
    "type": "Lab"
  }, {
    "name": "Hemoglobin A1C level",
    "codeType": "CPT(R)",
    "procedureCode": "83036",
    "type": "Lab"
  }, {
    "name": "Specimen Collection: Phlebotomy",
    "codeType": "CPT(R)",
    "procedureCode": "36415",
    "type": "Other"
  }, {
    "name": "Blood Counts",
    "codeType": "CPT(R)",
    "procedureCode": "85025",
    "type": "Lab"
  }, {
    "name": "MYCHART ACTIVATION",
    "codeType": "Custom",
    "procedureCode": "00001.000",
    "type": "Procedures"
  }, {
    "name": "Urine microalbumin (protein) level",
    "codeType": "CPT(R)",
    "procedureCode": "82043",
    "type": "Lab"
  }, {
    "name": "REFERRAL TO OPHTHALMOLOGY - GENERAL OPHTHALMOLOGY",
    "codeType": "Custom",
    "procedureCode": "9024",
    "type": "Referral"
  }, {
    "name": "Analysis for antibody to HIV-1 and HIV-2 virus",
    "codeType": "CPT(R)",
    "procedureCode": "86703",
    "type": "Lab"
  }, {
    "name": "AUTO DIFFERENTIAL",
    "codeType": "Custom",
    "procedureCode": "01001.069",
    "type": "Lab"
  }, {
    "name": "Blood creatinine level",
    "codeType": "CPT(R)",
    "procedureCode": "82565",
    "type": "Lab"
  }],
  "medications": [],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}]
# Get an encounter by id
curl "https://api.humanapi.co/v1/human/medical/encounters/54442e34afe02911538d01e9?access_token=demo"

{
  "id": "54442e1f8bbb040d5388e842",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:19.971Z",
  "createdAt": "2014-10-19T21:33:19.971Z",
  "dateTime": "2014-07-21T17:30:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Cardiomyopathy (HCC) - Primary",
      "href": "/medical/issues/5524a98cg684832301dfc760"
    }
  ],
  "prescriptions": [
    {
      "name": "metolazone 2 MG tablet",
      "href": "/medical/medications/5724a91ef682832301dfc193"
    }
  ],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "LAB",
    "departmentName": "Asheville Goosetown Laboratory"
  },
  "reasons": ["Ear Problem"],
  "orders": [{
    "name": "LIPID PROFILE",
    "codeType": "Custom",
    "expectedDate": "2012-01-19T05:00:00.000Z",
    "expireDate": "2013-01-18T05:00:00.000Z",
    "procedureCode": "LABLIPID",
    "type": "LAB CHEMISTRY"
  }],
  "medications": [{
    "canRefill": false,
    "genericProductIndicator": "42200032301810",
    "hasPendingRefill": false,
    "name": "FLUTICASONE PROPIONATE (NASAL) 50 MCG/ACT NA SUSP",
    "ndcCode": "0054-3270-99",
    "startDate": "2010-09-17T04:00:00.000Z"
  }, {
    "canRefill": false,
    "genericProductIndicator": "01200010100315",
    "hasPendingRefill": false,
    "name": "Amoxicillin 875 MG OR TABS",
    "ndcCode": "0093-2264-01",
    "startDate": "2010-09-17T04:00:00.000Z"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
},
"codes": []
// Get all encounters associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/encounters?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of encounters:
[{
  "id": "54442e1f8bbb040d5388e842",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:19.971Z",
  "createdAt": "2014-10-19T21:33:19.971Z",
  "dateTime": "2014-07-21T17:30:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Cardiomyopathy (HCC) - Primary",
      "href": "/medical/issues/5524a98cg684832301dfc760"
    }
  ],
  "prescriptions": [
    {
      "name": "metolazone 2 MG tablet",
      "href": "/medical/medications/5724a91ef682832301dfc193"
    }
  ],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "LAB",
    "departmentName": "Asheville Goosetown Laboratory"
  },
  "reasons": ["Ear Problem"],
  "orders": [{
    "name": "LIPID PROFILE",
    "codeType": "Custom",
    "expectedDate": "2012-01-19T05:00:00.000Z",
    "expireDate": "2013-01-18T05:00:00.000Z",
    "procedureCode": "LABLIPID",
    "type": "LAB CHEMISTRY"
  }],
  "medications": [{
    "canRefill": false,
    "genericProductIndicator": "42200032301810",
    "hasPendingRefill": false,
    "name": "FLUTICASONE PROPIONATE (NASAL) 50 MCG/ACT NA SUSP",
    "ndcCode": "0054-3270-99",
    "startDate": "2010-09-17T04:00:00.000Z"
  }, {
    "canRefill": false,
    "genericProductIndicator": "01200010100315",
    "hasPendingRefill": false,
    "name": "Amoxicillin 875 MG OR TABS",
    "ndcCode": "0093-2264-01",
    "startDate": "2010-09-17T04:00:00.000Z"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54442e2bde98810f537ba16f",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:31.112Z",
  "createdAt": "2014-10-19T21:33:31.112Z",
  "dateTime": "2011-04-04T18:15:00.000Z",
  "visitType": "Hospital Outpatient Visit",
  "diagnoses": [
    {
      "name": "Senile Nuclear Sclerosis"
      "href": "/medical/issues/5723d9a5f683891300dfbd90",
    }, {
      "name": "Dermatochalasis"
      "href": "/medical/issues/5723d9a5f6838913s9d8fd61",
    }
  ],
  "prescriptions": [],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "Lenard Linkovich, MD",
    "departmentName": "Physiatry"
  },
  "reasons": [],
  "orders": [],
  "medications": [],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}, {
  "id": "54442e34afe02911538d01e9",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:40.086Z",
  "createdAt": "2014-10-19T21:33:40.086Z",
  "dateTime": "2013-01-25T05:00:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Unspecified Constipation",
      "href": "/medical/issues/5723d9a5f683891300dfbd90",
    }, {
      "name": "Rectal Bleeding",
      "href": "/medical/issues/5723d9a5f683891300dfbd90",
    }
  ],
  "prescriptions": [],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "Jarred Bancroft, MD",
    "departmentName": "Dermatology"
  },
  "reasons": [],
  "orders": [{
    "name": "Multi-test Laboratory Panels",
    "codeType": "CPT(R)",
    "procedureCode": "80053",
    "type": "Lab"
  }, {
    "name": "Multi-test Laboratory Panels",
    "codeType": "CPT(R)",
    "procedureCode": "80061",
    "type": "Lab"
  }, {
    "name": "Hemoglobin A1C level",
    "codeType": "CPT(R)",
    "procedureCode": "83036",
    "type": "Lab"
  }, {
    "name": "Specimen Collection: Phlebotomy",
    "codeType": "CPT(R)",
    "procedureCode": "36415",
    "type": "Other"
  }, {
    "name": "Blood Counts",
    "codeType": "CPT(R)",
    "procedureCode": "85025",
    "type": "Lab"
  }, {
    "name": "MYCHART ACTIVATION",
    "codeType": "Custom",
    "procedureCode": "00001.000",
    "type": "Procedures"
  }, {
    "name": "Urine microalbumin (protein) level",
    "codeType": "CPT(R)",
    "procedureCode": "82043",
    "type": "Lab"
  }, {
    "name": "REFERRAL TO OPHTHALMOLOGY - GENERAL OPHTHALMOLOGY",
    "codeType": "Custom",
    "procedureCode": "9024",
    "type": "Referral"
  }, {
    "name": "Analysis for antibody to HIV-1 and HIV-2 virus",
    "codeType": "CPT(R)",
    "procedureCode": "86703",
    "type": "Lab"
  }, {
    "name": "AUTO DIFFERENTIAL",
    "codeType": "Custom",
    "procedureCode": "01001.069",
    "type": "Lab"
  }, {
    "name": "Blood creatinine level",
    "codeType": "CPT(R)",
    "procedureCode": "82565",
    "type": "Lab"
  }],
  "medications": [],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}]

// Get an encounter by id
request
.get('https://api.humanapi.co/v1/human/medical/encounters/54442e1f8bbb040d5388e842?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as encounter:
{
  "id": "54442e1f8bbb040d5388e842",
  "source": "emr-1-320",
  "updatedAt": "2014-10-19T21:33:19.971Z",
  "createdAt": "2014-10-19T21:33:19.971Z",
  "dateTime": "2014-07-21T17:30:00.000Z",
  "visitType": "Office Visit",
  "diagnoses": [
    {
      "name": "Cardiomyopathy (HCC) - Primary",
      "href": "/medical/issues/5524a98cg684832301dfc760"
    }
  ],
  "prescriptions": [
    {
      "name": "metolazone 2 MG tablet",
      "href": "/medical/medications/5724a91ef682832301dfc193"
    }
  ],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "provider": {
    "name": "LAB",
    "departmentName": "Asheville Goosetown Laboratory"
  },
  "reasons": ["Ear Problem"],
  "orders": [{
    "name": "LIPID PROFILE",
    "codeType": "Custom",
    "expectedDate": "2012-01-19T05:00:00.000Z",
    "expireDate": "2013-01-18T05:00:00.000Z",
    "procedureCode": "LABLIPID",
    "type": "LAB CHEMISTRY"
  }],
  "medications": [{
    "canRefill": false,
    "genericProductIndicator": "42200032301810",
    "hasPendingRefill": false,
    "name": "FLUTICASONE PROPIONATE (NASAL) 50 MCG/ACT NA SUSP",
    "ndcCode": "0054-3270-99",
    "startDate": "2010-09-17T04:00:00.000Z"
  }, {
    "canRefill": false,
    "genericProductIndicator": "01200010100315",
    "hasPendingRefill": false,
    "name": "Amoxicillin 875 MG OR TABS",
    "ndcCode": "0093-2264-01",
    "startDate": "2010-09-17T04:00:00.000Z"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}

Get a list of medical encounters the user has had so far

Get Encounters

Returns a list of medical encounters

GET https://api.humanapi.co/v1/human/medical/encounters

Returns a single encounter

GET https://api.humanapi.co/v1/human/medical/encounters/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the encounter record
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime Date The date of the encounter
visitType String The type of visit
provider Object The provider for the encounter (see provider object below)
diagnoses Array[Object] A list of diagnoses for the encounter (See link objects below)
prescriptions Array[Object] A list of prescriptions for the encounter (See link objects below)
reasons Array[String] A list of reasons for the encounter (e.g. ‘Follow-up’, 'Consult’, 'Back Pain’)
vitals Object Vitals captured during the encounter (See vitals)
orders Array[Object] A list of orders prescribed for the patient (see orders below)
medications Array[Object] A list of prescribed medications (See medications)
followUpInstructions String Optional follow-up instructions
patientInstruction String Optional patient instructions
patient Object Patient information (“name” and other optional attributes)
organization Object Hospital information (See organizations)
codes Object See codes object

Orders Object

Property Type Description
name String The name of the order
codeType String The code type of the order (e.g. “CPT( R )”, “Custom”)
expectedDate Date The date the order is expected
expireDate Date The date the order expires
procedureCode String The procedure code of the order
type String The type of the order (e.g. “Lab”, “Procedures”)

Provider Object

Property Type Description
name String Name of the provider
departmentName String Name of the provider department

Link objects are used to associate records from other endpoints to the encounter.

Property Type Description
name String Name of the data element
href String API path to the full data object

Functional Statuses

# Get all functional statuses associated with the user
curl "https://api.humanapi.co/v1/human/medical/functional_statuses?access_token=demo"

# Returns a json array of functional statuses:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2014-09-01T21:42:09.969Z",
        "updatedAt": "2014-09-01T21:42:10.072Z",
        "dateTime": "2014-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "name": "Memory impairment",
        "codes": []
    }
]

# Get a functional status by id
curl "https://api.humanapi.co/v1/human/medical/functional_statuses/55e692d20c7deefb7cfe90f8?access_token=demo"

# Returns a functional status object
{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2014-09-01T21:42:09.969Z",
    "updatedAt": "2014-09-01T21:42:10.072Z",
    "dateTime": "2014-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "name": "Memory impairment",
    "codes": []
}
// Get all functional statuses associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/functional_statuses?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of functional statuses:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2014-09-01T21:42:09.969Z",
        "updatedAt": "2014-09-01T21:42:10.072Z",
        "dateTime": "2014-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "name": "Memory impairment",
        "codes": []
    }
]


// Get a functional status by id
request
.get('https://api.humanapi.co/v1/human/medical/functional_statuses/55e692d20c7deefb7cfe90f8?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as a functional status:
{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2014-09-01T21:42:09.969Z",
    "updatedAt": "2014-09-01T21:42:10.072Z",
    "dateTime": "2014-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "name": "Memory impairment",
    "codes": []
}

Get a list of medical functional statuses associated with the user

Get Procedures

Returns a list of medical functional statuses

GET https://api.humanapi.co/v1/human/medical/functional_statuses

Returns a single functional status

GET https://api.humanapi.co/v1/human/medical/functional_statuses/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the functional status
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime Date The date of the functional status
name String The name of the functional status
codes Object See codes object

Immunizations

# Get all immunizations associated with the user
curl "https://api.humanapi.co/v1/human/medical/immunizations?access_token=demo"

# Returns a json array of immunizations:
[{
  "id": "5443d24d0d2a0e0c4b3672e8",
  "name": "Tetanus+Dip ADULT (Td)",
  "source": "emr-1-320",
  "dates": ["2005-09-27T04:00:00.000Z", "1995-01-01T05:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "5443d24d0d2a0e0c4b3672eb",
  "name": "Pneumococcal Conjugate PCV13",
  "source": "emr-1-320",
  "dates": ["2014-03-14T04:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}]

# Get an immunization by id
curl "https://api.humanapi.co/v1/human/medical/immunizations/5443d24d0d2a0e0c4b3672eb?access_token=demo"

{
  "id": "5443d24d0d2a0e0c4b3672eb",
  "name": "Pneumococcal Conjugate PCV13",
  "source": "emr-1-320",
  "dates": ["2014-03-14T04:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}
// Get all immunizations associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/immunizations?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of immunizations:
[{
  "id": "5443d24d0d2a0e0c4b3672e8",
  "name": "Tetanus+Dip ADULT (Td)",
  "source": "emr-1-320",
  "dates": ["2005-09-27T04:00:00.000Z", "1995-01-01T05:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "5443d24d0d2a0e0c4b3672eb",
  "name": "Pneumococcal Conjugate PCV13",
  "source": "emr-1-320",
  "dates": ["2014-03-14T04:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}]

// Get an immunization by id
request
.get('https://api.humanapi.co/v1/human/medical/immunizations/5443d24d0d2a0e0c4b3672eb?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as immunization:
{
  "id": "5443d24d0d2a0e0c4b3672eb",
  "name": "Pneumococcal Conjugate PCV13",
  "source": "emr-1-320",
  "dates": ["2014-03-14T04:00:00.000Z"],
  "patient": {
    "name": "Maxwell Forrest"
  },
  "updatedAt": "2014-10-19T21:02:17.949Z",
  "createdAt": "2014-10-19T21:02:17.949Z",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  },
  "codes": []
}

Get a list of immunizations the user has had so far

Get Immunizations

Returns a list of medical immunizations

GET https://api.humanapi.co/v1/human/medical/immunizations

Returns a single immunization

GET https://api.humanapi.co/v1/human/medical/immunizations/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the immunization record
name String The name of the immunization (e.g. ‘Tetanus+Dip ADULT (Td)’, 'Varicella’, 'Influenza Virus Vaccine’)
source String The name of the originating service
dates Array[Date] The dates immunization was givin
patient Object Patient information (“name” and other optional attributes)
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
organization Object Hospital information (See organizations)
codes Object See codes object

Instructions

# Get all instructions associated with the user
curl "https://api.humanapi.co/v1/human/medical/instructions?access_token=demo"

# Returns a json array of instructions:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2015-09-01T21:42:09.969Z",
        "updatedAt": "2015-09-01T21:42:10.072Z",
        "dateTime": "2015-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "name": "Instructions",
        "text": "Please forward scans to \nDr. Reddy\nDepartment of Children's medicine\n 123 Main St.\nCedarCity, CA 00000\n\nI encourage you to visit my website",
        "codes": []
    }
]

# Get an instruction by id
curl "https://api.humanapi.co/v1/human/medical/instructions/55e692d20c7deefb7cfe90f8?access_token=demo"

{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2015-09-01T21:42:09.969Z",
    "updatedAt": "2015-09-01T21:42:10.072Z",
    "dateTime": "2015-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "name": "Instructions",
    "text": "Please forward scans to \nDr. Reddy\nDepartment of Children's medicine\n  123 Main St.\nCedarCity, CA 00000\n\nI encourage you to visit my website",
    "codes": []
}
// Get all instructions associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/instructions?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of instructions:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2015-09-01T21:42:09.969Z",
        "updatedAt": "2015-09-01T21:42:10.072Z",
        "dateTime": "2015-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "name": "Instructions",
        "text": "Please forward scans to \nDr. Reddy\nDepartment of Children's medicine\n 123 Main St.\nCedarCity, CA 00000\n\nI encourage you to visit my website",
        "codes": []
    }
]

// Get an instruction by id
request
.get('https://api.humanapi.co/v1/human/medical/instructions/55e692d20c7deefb7cfe90f8?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as an instruction:
{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2015-09-01T21:42:09.969Z",
    "updatedAt": "2015-09-01T21:42:10.072Z",
    "dateTime": "2015-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "name": "Instructions",
    "text": "Please forward scans to \nDr. Reddy\nDepartment of Children's medicine\n123 Main St.\nCedarCity, CA 00000\n\nI encourage you to visit my website.",
    "codes": []
}

Get a list of medical instructions associated with the user

Get Instructions

Returns a list of medical instructions

GET https://api.humanapi.co/v1/human/medical/instructions

Returns a single instruction

GET https://api.humanapi.co/v1/human/medical/instructions/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the instruction
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime String The date of the instruction
name String The name of the instruction (ex. “instructions”, or “discharge instructions”, etc.)
text String Text content of the instruction
codes Object See codes object

Medications

# Get all medications associated with the user
curl "https://api.humanapi.co/v1/human/medical/medications?access_token=demo"

# Returns a json array of medications:
[{
  "id": "55a2ff2d197f25c42f2e84b7",
  "updatedAt": "2014-12-09T18:06:42.100Z",
  "createdAt": "2014-12-09T18:06:42.100Z",
  "commonBrandName": "CLARITIN",
  "details": {
      "dosage": {
          "form": "tablet",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "as-needed"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "10",
          "unit": "mg"
      }
  },
  "dosageInfo": "10 MG tablet",
  "genericProductIndicator": "41550030000320",
  "instructions": "Take 1 tab by mouth as needed (allergies).",
  "name": "loratadine (CLARITIN) 10 MG tablet",
  "ndcCode": "0781-5077-01",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "loratadine",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "source": "emr-1-320",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "codes": []
},
{
  "id": "55a2fef4197f25c42f2e849f",
  "updatedAt": "2014-12-09T18:06:42.100Z"
  "createdAt": "2014-12-09T18:06:42.100Z",
  "commonBrandName": "LEXAPRO",
  "details": {
      "dosage": {
          "form": "tablet",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "day"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "5",
          "unit": "mg"
      }
  },
  "dosageInfo": "5 mg tablet",
  "genericProductIndicator": "58160034100310",
  "instructions": "Take 1 tablet by mouth every day",
  "name": "escitalopram (LEXAPRO) 5 mg tablet",
  "ndcCode": "0378-3855-77",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "escitalopram",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "source": "emr-1-320",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "codes": []
}]

# Get an medication by id
curl "https://api.humanapi.co/v1/human/medical/medications/55a2ffffae49064805446259?access_token=demo"

{
  "id": "55a2ffffae49064805446259",
  "updatedAt": "2015-02-13T18:06:42.100Z",
  "createdAt": "2015-02-13T18:06:42.100Z",
  "commonBrandName": "ADDERALL XR",
  "details": {
      "dosage": {
          "form": "capsule",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "day"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "15",
          "unit": "mg"
      }
  },
  "dosageInfo": "15 mg 24 hr capsule",
  "genericProductIndicator": "443805",
  "instructions": "Take 1 capsule by mouth every morning for 30 days.",
  "name": "dextroamphetamine-amphetamine (ADDERALL XR) 15 mg 24 hr capsule",
  "ndcCode": "0115-1330-01",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "dextroamphetamine-amphetamine",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "source": "emr-1-320",
  "codes": [
    {
        "code": "1000114",
        "codeSystem": "2.16.840.1.113883.6.88",
        "codeSystemName": "RxNorm",
        "name": "Medroxyprogesterone 10 Mg Oral Tab"
    },
    {
        "code": "55289-160-05",
        "codeSystem": "2.16.840.1.113883.6.69",
        "codeSystemName": "NDC",
        "name": "Medroxyprogesterone 10 Mg Oral Tab"
    }
  ]
}
// Get all medications associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/medications?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of medications:
[{
  "id": "55a2ff2d197f25c42f2e84b7",
  "updatedAt": "2014-12-09T18:06:42.100Z",
  "createdAt": "2014-12-09T18:06:42.100Z",
  "commonBrandName": "CLARITIN",
  "details": {
      "dosage": {
          "form": "tablet",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "as-needed"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "10",
          "unit": "mg"
      }
  },
  "dosageInfo": "10 MG tablet",
  "genericProductIndicator": "41550030000320",
  "instructions": "Take 1 tab by mouth as needed (allergies).",
  "name": "loratadine (CLARITIN) 10 MG tablet",
  "ndcCode": "0781-5077-01",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "loratadine",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "source": "emr-1-320",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "codes": []
},
{
  "id": "55a2fef4197f25c42f2e849f",
  "updatedAt": "2014-12-09T18:06:42.100Z"
  "createdAt": "2014-12-09T18:06:42.100Z",
  "commonBrandName": "LEXAPRO",
  "details": {
      "dosage": {
          "form": "tablet",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "day"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "5",
          "unit": "mg"
      }
  },
  "dosageInfo": "5 mg tablet",
  "genericProductIndicator": "58160034100310",
  "instructions": "Take 1 tablet by mouth every day",
  "name": "escitalopram (LEXAPRO) 5 mg tablet",
  "ndcCode": "0378-3855-77",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "escitalopram",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "source": "emr-1-320",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "codes": []
}]

// Get an medication by id
request
.get('https://api.humanapi.co/v1/human/medical/medications/55a2ffffae49064805446259?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as medication:
{
  "id": "55a2ffffae49064805446259",
  "updatedAt": "2015-02-13T18:06:42.100Z",
  "createdAt": "2015-02-13T18:06:42.100Z",
  "commonBrandName": "ADDERALL XR",
  "details": {
      "dosage": {
          "form": "capsule",
          "value": "1"
      },
      "frequency": {
          "number": "1",
          "unit": "day"
      },
      "route": "enteral_oral",
      "strength": {
          "number": "15",
          "unit": "mg"
      }
  },
  "dosageInfo": "15 mg 24 hr capsule",
  "genericProductIndicator": "443805",
  "instructions": "Take 1 capsule by mouth every morning for 30 days.",
  "name": "dextroamphetamine-amphetamine (ADDERALL XR) 15 mg 24 hr capsule",
  "ndcCode": "0115-1330-01",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "productName": "dextroamphetamine-amphetamine",
  "provider": "Isaias Kingston, MD",
  "providerID": "34665",
  "source": "emr-1-320",
  "startDate": "2012-01-26T00:00:00.000Z",
  "endDate": "2014-01-26T00:00:00.000Z",
  "codes": [
    {
        "code": "1000114",
        "codeSystem": "2.16.840.1.113883.6.88",
        "codeSystemName": "RxNorm",
        "name": "Medroxyprogesterone 10 Mg Oral Tab"
    },
    {
        "code": "55289-160-05",
        "codeSystem": "2.16.840.1.113883.6.69",
        "codeSystemName": "NDC",
        "name": "Medroxyprogesterone 10 Mg Oral Tab"
    }
  ]
}

Get a list of medical medications the user has had so far

Get Medications

Returns a list of medical medications

GET https://api.humanapi.co/v1/human/medical/medications

Returns a single medication

GET https://api.humanapi.co/v1/human/medical/medications/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the medication record
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
instructions String The instructions provided for the medication (e.g. ‘Take 1 tablet by mouth daily.’)
details Object Parsed dosage and instruction information (see below)
genericProductIndicator String The Generic Product Identifier of the medication
patient Object Patient information (“name” and other optional attributes)
name String The name of the medication (e.g. 'Cyanocobalamin (VITAMIN B12 PO)’)
provider String The name of the provider - if available (e.g. 'Jacob Smith, MD’, 'Outside Provider’, 'Unknown’)
providerID String The id of the provider
ndcCode String The National Drug Code of the medication (if provided)
productName String The product name of the medication - if provided (e.g. 'zolpidem’, 'gabapentin’, 'aspirin’)
commonBrandName String The common brand name of the medication - if provided (e.g. 'NORCO’, 'XANAX’, 'NEURONTIN’)
dosageInfo String The dosage information - if provided (e.g. '10 MG tablet’, '100 UNIT/ML injection’, '5mg Tab’)
pharmacy Object Pharmacy information - if provided (see pharmacy below)
organization Object Hospital information (See organizations)
expiration Date The expiration date of the medication - if provided
refillsRemaining Number The number of refills remaining - if available
refillsTotal Number The total number of refills - if available
startDate Date Start date of the medication
endDate Date End date of the medication
codes Object See codes object

Pharmacy Object

Property Type Description
iD String The Id of the pharmacy
name String The name of the pharmacy
address String The address of the pharmacy
phone String The phone number of the pharmacy
hours String The opening hours of the pharmacy (if provided)

Details Object

Property Type Description
dosage Object The 'form’ and 'value’ of a dosage if applicable (ex. form:'tablet’, 'patch’, 'drops’, etc.)
frequency Object The frequency that the medication should be taken (consists of 'number’ and 'unit’)
route String The route the medication is taken (ex. 'enteral_oral’)
strength Object The strength of the dosage (consists of 'number’ and 'unit’)

Narratives

# Get all narratives associated with the user
curl "https://api.humanapi.co/v1/human/medical/narratives?access_token=demo"

# Returns a json array of narratives:
[{
  "id": "54e3521f79192a2e4993dfdc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-11T06:26:53.217Z",
  "createdAt": "2015-02-11T06:26:53.217Z",
  "dateTime": "Mon Jul 07 2014 14:40:26 GMT-0700 (PDT)",
  "author": "Christine Johnson",
  "entries": [{
    "title": "Note from Sutter Health Affiliates and Community Connect Practices",
    "text": "This document contains information that was shared with Maxwell Forrest. It may not contain the entire record from Sutter Health Affiliates and Community Connect Practices."
  }, {
    "title": "Reason for Visit",
    "text": "Reason Comments Diarrhea"
  }, {
    "title": "Encounter Details",
    "text": "Date Type Department Care Team 07/07/2014 Office Visit Palo Alto Family Medicine 795 El Camino Real Palo Alto, CA 94301 650-333-4444 Johnson, Christine, NP 795 EL CAMINO REAL Palo Alto, CA 94301 650-333-4444 650-333-4444 (Fax)"
  }, {
    "title": "Active Allergies and Adverse Reactions - as of 02/09/2015",
    "text": "No Known Allergies"
  }, {
    "title": "Current Medications - as of 02/09/2015",
    "text": "No known medications"
  }, {
    "title": "Active Problems - as of 02/09/2015",
    "text": "Problem Noted Date No Active Medical Problems 04/14/2014"
  }, {
    "title": "Social History - as of 02/09/2015",
    "text": "Tobacco Use Types Packs/Day Years Used Date Never smoker 0 0 Alcohol Use Drinks/Week oz/Week Yes 1 Drinks containing 0.5 oz of alcohol 0.5"
  }, {
    "title": "Last Filed Vital Signs",
    "text": "Vital Sign Reading Time Taken Blood Pressure 120 / 70 07/07/2014  2:47 PM PDT Pulse 75 07/07/2014  2:47 PM PDT Temperature 36.4 °C (97.6 °F) 07/07/2014  2:47 PM PDT Respiratory Rate - - Height - - Weight 84.823 kg (187 lb) 07/07/2014  2:47 PM PDT Body Mass Index 23.52 07/07/2014  2:47 PM PDT Oxygen Saturation 98% 07/07/2014  2:47 PM PDT"
  }, {
    "title": "Plan of Care",
    "text": "Not on file"
  }, {
    "title": "Procedures",
    "text": ""
  }, {
    "title": "Results",
    "text": "Not on file"
  }, {
    "title": "Visit Diagnoses",
    "text": "Viral enteritis - Primary Intestinal infection due to other organism, not elsewhere classified Diarrhea Diarrhea"
  }, {
    "title": "Insurance",
    "text": "Payer Benefit Plan / Group Subscriber ID Type Phone Address BLUE SHIELD BLUE SHIELD PPO XEK901245582 PRIVATE FFS PPO/EPO PO BOX 272550 CHICO, CA 95927 Guarantor Name Account Type Relation to Patient Date of Birth Phone Billing Address FORREST,MAXWELL Personal/Family Self 05/30/1978 Work: +1-650-333-4444 Home: +1-650-333-4444 1 MILKY WAY WAY APT E MENLO PARK, CA 94025"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]

# Get a narrative by id
curl "https://api.humanapi.co/v1/human/medical/narratives/54e3521f79192a2e4993dfdc?access_token=demo"

{
  "id": "54e3521f79192a2e4993dfdc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-11T06:26:53.217Z",
  "createdAt": "2015-02-11T06:26:53.217Z",
  "dateTime": "Mon Jul 07 2014 14:40:26 GMT-0700 (PDT)",
  "author": "Christine Johnson",
  "entries": [{
    "title": "Note from Sutter Health Affiliates and Community Connect Practices",
    "text": "This document contains information that was shared with Maxwell Forrest. It may not contain the entire record from Sutter Health Affiliates and Community Connect Practices."
  }, {
    "title": "Reason for Visit",
    "text": "Reason Comments Diarrhea"
  }, {
    "title": "Encounter Details",
    "text": "Date Type Department Care Team 07/07/2014 Office Visit Palo Alto Family Medicine 795 El Camino Real Palo Alto, CA 94301 650-333-4444 Johnson, Christine, NP 795 EL CAMINO REAL Palo Alto, CA 94301 650-333-4444 650-333-4444 (Fax)"
  }, {
    "title": "Active Allergies and Adverse Reactions - as of 02/09/2015",
    "text": "No Known Allergies"
  }, {
    "title": "Current Medications - as of 02/09/2015",
    "text": "No known medications"
  }, {
    "title": "Active Problems - as of 02/09/2015",
    "text": "Problem Noted Date No Active Medical Problems 04/14/2014"
  }, {
    "title": "Social History - as of 02/09/2015",
    "text": "Tobacco Use Types Packs/Day Years Used Date Never smoker 0 0 Alcohol Use Drinks/Week oz/Week Yes 1 Drinks containing 0.5 oz of alcohol 0.5"
  }, {
    "title": "Last Filed Vital Signs",
    "text": "Vital Sign Reading Time Taken Blood Pressure 120 / 70 07/07/2014  2:47 PM PDT Pulse 75 07/07/2014  2:47 PM PDT Temperature 36.4 °C (97.6 °F) 07/07/2014  2:47 PM PDT Respiratory Rate - - Height - - Weight 84.823 kg (187 lb) 07/07/2014  2:47 PM PDT Body Mass Index 23.52 07/07/2014  2:47 PM PDT Oxygen Saturation 98% 07/07/2014  2:47 PM PDT"
  }, {
    "title": "Plan of Care",
    "text": "Not on file"
  }, {
    "title": "Procedures",
    "text": ""
  }, {
    "title": "Results",
    "text": "Not on file"
  }, {
    "title": "Visit Diagnoses",
    "text": "Viral enteritis - Primary Intestinal infection due to other organism, not elsewhere classified Diarrhea Diarrhea"
  }, {
    "title": "Insurance",
    "text": "Payer Benefit Plan / Group Subscriber ID Type Phone Address BLUE SHIELD BLUE SHIELD PPO XEK901245582 PRIVATE FFS PPO/EPO PO BOX 272550 CHICO, CA 95927 Guarantor Name Account Type Relation to Patient Date of Birth Phone Billing Address FORREST,MAXWELL Personal/Family Self 05/30/1978 Work: +1-650-333-4444 Home: +1-650-333-4444 1 MILKY WAY WAY APT E MENLO PARK, CA 94025"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}
// Get all narratives associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/narratives?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of narratives:
[{
  "id": "54e3521f79192a2e4993dfdc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-11T06:26:53.217Z",
  "createdAt": "2015-02-11T06:26:53.217Z",
  "dateTime": "Mon Jul 07 2014 14:40:26 GMT-0700 (PDT)",
  "author": "Christine Johnson",
  "entries": [{
    "title": "Note from Sutter Health Affiliates and Community Connect Practices",
    "text": "This document contains information that was shared with Maxwell Forrest. It may not contain the entire record from Sutter Health Affiliates and Community Connect Practices."
  }, {
    "title": "Reason for Visit",
    "text": "Reason Comments Diarrhea"
  }, {
    "title": "Encounter Details",
    "text": "Date Type Department Care Team 07/07/2014 Office Visit Palo Alto Family Medicine 795 El Camino Real Palo Alto, CA 94301 650-333-4444 Johnson, Christine, NP 795 EL CAMINO REAL Palo Alto, CA 94301 650-333-4444 650-333-4444 (Fax)"
  }, {
    "title": "Active Allergies and Adverse Reactions - as of 02/09/2015",
    "text": "No Known Allergies"
  }, {
    "title": "Current Medications - as of 02/09/2015",
    "text": "No known medications"
  }, {
    "title": "Active Problems - as of 02/09/2015",
    "text": "Problem Noted Date No Active Medical Problems 04/14/2014"
  }, {
    "title": "Social History - as of 02/09/2015",
    "text": "Tobacco Use Types Packs/Day Years Used Date Never smoker 0 0 Alcohol Use Drinks/Week oz/Week Yes 1 Drinks containing 0.5 oz of alcohol 0.5"
  }, {
    "title": "Last Filed Vital Signs",
    "text": "Vital Sign Reading Time Taken Blood Pressure 120 / 70 07/07/2014  2:47 PM PDT Pulse 75 07/07/2014  2:47 PM PDT Temperature 36.4 °C (97.6 °F) 07/07/2014  2:47 PM PDT Respiratory Rate - - Height - - Weight 84.823 kg (187 lb) 07/07/2014  2:47 PM PDT Body Mass Index 23.52 07/07/2014  2:47 PM PDT Oxygen Saturation 98% 07/07/2014  2:47 PM PDT"
  }, {
    "title": "Plan of Care",
    "text": "Not on file"
  }, {
    "title": "Procedures",
    "text": ""
  }, {
    "title": "Results",
    "text": "Not on file"
  }, {
    "title": "Visit Diagnoses",
    "text": "Viral enteritis - Primary Intestinal infection due to other organism, not elsewhere classified Diarrhea Diarrhea"
  }, {
    "title": "Insurance",
    "text": "Payer Benefit Plan / Group Subscriber ID Type Phone Address BLUE SHIELD BLUE SHIELD PPO XEK901245582 PRIVATE FFS PPO/EPO PO BOX 272550 CHICO, CA 95927 Guarantor Name Account Type Relation to Patient Date of Birth Phone Billing Address FORREST,MAXWELL Personal/Family Self 05/30/1978 Work: +1-650-333-4444 Home: +1-650-333-4444 1 MILKY WAY WAY APT E MENLO PARK, CA 94025"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]

// Get an narrative by id
request
.get('https://api.humanapi.co/v1/human/medical/narratives/54e3521f79192a2e4993dfdc?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as narrative:
{
  "id": "54e3521f79192a2e4993dfdc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-11T06:26:53.217Z",
  "createdAt": "2015-02-11T06:26:53.217Z",
  "dateTime": "Mon Jul 07 2014 14:40:26 GMT-0700 (PDT)",
  "author": "Christine Johnson",
  "entries": [{
    "title": "Note from Sutter Health Affiliates and Community Connect Practices",
    "text": "This document contains information that was shared with Maxwell Forrest. It may not contain the entire record from Sutter Health Affiliates and Community Connect Practices."
  }, {
    "title": "Reason for Visit",
    "text": "Reason Comments Diarrhea"
  }, {
    "title": "Encounter Details",
    "text": "Date Type Department Care Team 07/07/2014 Office Visit Palo Alto Family Medicine 795 El Camino Real Palo Alto, CA 94301 650-333-4444 Johnson, Christine, NP 795 EL CAMINO REAL Palo Alto, CA 94301 650-333-4444 650-333-4444 (Fax)"
  }, {
    "title": "Active Allergies and Adverse Reactions - as of 02/09/2015",
    "text": "No Known Allergies"
  }, {
    "title": "Current Medications - as of 02/09/2015",
    "text": "No known medications"
  }, {
    "title": "Active Problems - as of 02/09/2015",
    "text": "Problem Noted Date No Active Medical Problems 04/14/2014"
  }, {
    "title": "Social History - as of 02/09/2015",
    "text": "Tobacco Use Types Packs/Day Years Used Date Never smoker 0 0 Alcohol Use Drinks/Week oz/Week Yes 1 Drinks containing 0.5 oz of alcohol 0.5"
  }, {
    "title": "Last Filed Vital Signs",
    "text": "Vital Sign Reading Time Taken Blood Pressure 120 / 70 07/07/2014  2:47 PM PDT Pulse 75 07/07/2014  2:47 PM PDT Temperature 36.4 °C (97.6 °F) 07/07/2014  2:47 PM PDT Respiratory Rate - - Height - - Weight 84.823 kg (187 lb) 07/07/2014  2:47 PM PDT Body Mass Index 23.52 07/07/2014  2:47 PM PDT Oxygen Saturation 98% 07/07/2014  2:47 PM PDT"
  }, {
    "title": "Plan of Care",
    "text": "Not on file"
  }, {
    "title": "Procedures",
    "text": ""
  }, {
    "title": "Results",
    "text": "Not on file"
  }, {
    "title": "Visit Diagnoses",
    "text": "Viral enteritis - Primary Intestinal infection due to other organism, not elsewhere classified Diarrhea Diarrhea"
  }, {
    "title": "Insurance",
    "text": "Payer Benefit Plan / Group Subscriber ID Type Phone Address BLUE SHIELD BLUE SHIELD PPO XEK901245582 PRIVATE FFS PPO/EPO PO BOX 272550 CHICO, CA 95927 Guarantor Name Account Type Relation to Patient Date of Birth Phone Billing Address FORREST,MAXWELL Personal/Family Self 05/30/1978 Work: +1-650-333-4444 Home: +1-650-333-4444 1 MILKY WAY WAY APT E MENLO PARK, CA 94025"
  }],
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}

Get a list of medical narratives associated with the user

Get Narratives

Returns a list of medical narratives

GET https://api.humanapi.co/v1/human/medical/narratives

Returns a single narrative

GET https://api.humanapi.co/v1/human/medical/narratives/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the narrative
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime String The date of the narrative
author String The name of the author
entries Array[Object] Array of entry objects (See below)
organization Object Hospital information (See organizations)

Entry Object

Property Type Description
title String The title of the entry
text String The description text of the entry

Organizations

# Get an organization by id
curl "https://api.humanapi.co/v1/human/medical/organizations/53c050ae51c69003200aaa29?access_token=demo"

{
  "id": "53c050ae51c69003200aaa29",
  "name": "Singing River Health System"
}

// Get an organization by id
request
.get('https://api.humanapi.co/v1/human/medical/organizations/53c050ae51c69003200aaa29?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as organization:
{
  "id": "53c050ae51c69003200aaa29",
  "name": "Singing River Health System"
}

Get a list of medical organizations in Human API associated with the user

Get Organizations

Returns a single organization

GET https://api.humanapi.co/v1/human/medical/organizations/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the organization
name String The name of the organization

Organization Object (other endpoints)

Property Type Description
id String The Id of the organization
name String The name of the organization
href String Human API organizations endpoint URL to retrieve full details

Plans of Care

# Get all plans of care associated with the user
curl "https://api.humanapi.co/v1/human/medical/plans_of_care?access_token=demo"

# Returns a json array of plans of care:
[ {
    "id": "55e692540c7deefb7cfe90f7",
    "createdAt": "2014-09-01T20:46:35.731Z",
    "updatedAt": "2014-09-01T20:46:35.731Z",
    "source": "emr-1-320",
    "name": "encounter",
    "text": "11/13/2015 Appointment Physical Therapy ",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "codes": []
} ]


# Get a plan of care by id
curl "https://api.humanapi.co/v1/human/medical/plans_of_care/55e692540c7deefb7cfe90f7?access_token=demo"

{
  "id": "55e692540c7deefb7cfe90f7",
  "createdAt": "2014-09-01T20:46:35.731Z",
  "updatedAt": "2014-09-01T20:46:35.731Z",
  "source": "emr-1-320",
  "name": "encounter",
  "text": "11/13/2015 Appointment Physical Therapy ",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "codes": []
}
// Get all plans of care associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/plans_of_care?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of plans of care:
[ {
    "id": "55e692540c7deefb7cfe90f7",
    "createdAt": "2014-09-01T20:46:35.731Z",
    "updatedAt": "2014-09-01T20:46:35.731Z",
    "source": "emr-1-320",
    "name": "encounter",
    "text": "11/13/2015 Appointment Physical Therapy ",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "codes": []
} ]

// Get a plan of care by id
request
.get('https://api.humanapi.co/v1/human/medical/plans_of_care/55e692540c7deefb7cfe90f7?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as a plan of care:
{
  "id": "55e692540c7deefb7cfe90f7",
  "createdAt": "2014-09-01T20:46:35.731Z",
  "updatedAt": "2014-09-01T20:46:35.731Z",
  "source": "emr-1-320",
  "name": "encounter",
  "text": "11/13/2015 Appointment Physical Therapy ",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "codes": []
}

Get a list of medical plans of care associated with the user

Get Plans of Cares

Returns a list of medical plans of care

GET https://api.humanapi.co/v1/human/medical/plans_of_care

Returns a single plan of care

GET https://api.humanapi.co/v1/human/medical/plans_of_care/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the plan of care
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
source String The name of the originating service
name String The name of the plan of care
text String The text description of the author
date Date The date of the plan of care
type String The type of the plan of care
specialty String The specialty of the plan of care
organization Object Hospital information (See organizations)
codes Object See codes object

Problems

# Get all problems associated with the user
curl "https://api.humanapi.co/v1/human/medical/issues?access_token=demo"

# Returns a json array of problems:
[
  {
      "codes": [
          {
              "code": "729.89",
              "codeSystem": "2.16.840.1.113883.6.103",
              "codeSystemName": "ICD-9CM",
              "name": "WEAKNESS OF LEFT LEG"
          },
          {
              "code": "R53.1",
              "codeSystem": "2.16.840.1.113883.6.90",
              "codeSystemName": "ICD-10-CM",
              "name": "WEAKNESS OF LEFT LEG"
          }
      ],
      "createdAt": "2014-10-19T21:02:17.949Z",
      "id": "5443d6ca71b5c7f1a243879e",
      "name": "Limb pain",
      "organization": {
          "href": "/medical/organizations/53c050ac51c69003200aa998",
          "id": "53c050ac51c69003200aa998",
          "name": "Cleveland Clinic"
      },
      "patient": {
          "name": "Maxwell Forrest"
      },
      "source": "emr-1-320",
      "updatedAt": "2014-10-19T21:02:17.949Z"
  },
  {
      "codes": [
          {
              "code": "729.89",
              "codeSystem": "2.16.840.1.113883.6.103",
              "codeSystemName": "ICD-9CM",
              "name": "WEAKNESS OF LEFT LEG"
          },
          {
              "code": "R53.1",
              "codeSystem": "2.16.840.1.113883.6.90",
              "codeSystemName": "ICD-10-CM",
              "name": "WEAKNESS OF LEFT LEG"
          }
      ],
      "createdAt": "2014-10-19T21:02:17.949Z",
      "id": "5443d6ca71b5c7f1a243879f",
      "name": "Exophthalmos",
      "organization": {
          "href": "/medical/organizations/53c050ac51c69003200aa998",
          "id": "53c050ac51c69003200aa998",
          "name": "Cleveland Clinic"
      },
      "patient": {
          "name": "Maxwell Forrest"
      },
      "source": "emr-1-320",
      "updatedAt": "2014-10-19T21:02:17.949Z"
  }
]

# Get an problem by id
curl "https://api.humanapi.co/v1/human/medical/issues/5443d6ca71b5c7f1a243879f?access_token=demo"

{
    "codes": [
        {
            "code": "729.89",
            "codeSystem": "2.16.840.1.113883.6.103",
            "codeSystemName": "ICD-9CM",
            "name": "WEAKNESS OF LEFT LEG"
        },
        {
            "code": "R53.1",
            "codeSystem": "2.16.840.1.113883.6.90",
            "codeSystemName": "ICD-10-CM",
            "name": "WEAKNESS OF LEFT LEG"
        }
    ],
    "createdAt": "2014-10-19T21:02:17.949Z",
    "id": "5443d6ca71b5c7f1a243879f",
    "name": "Exophthalmos",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "source": "emr-1-320",
    "updatedAt": "2014-10-19T21:02:17.949Z"
}

// Get all problems associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/issues?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of problems:
[
  {
      "codes": [
          {
              "code": "729.89",
              "codeSystem": "2.16.840.1.113883.6.103",
              "codeSystemName": "ICD-9CM",
              "name": "WEAKNESS OF LEFT LEG"
          },
          {
              "code": "R53.1",
              "codeSystem": "2.16.840.1.113883.6.90",
              "codeSystemName": "ICD-10-CM",
              "name": "WEAKNESS OF LEFT LEG"
          }
      ],
      "createdAt": "2014-10-19T21:02:17.949Z",
      "id": "5443d6ca71b5c7f1a243879e",
      "name": "Limb pain",
      "organization": {
          "href": "/medical/organizations/53c050ac51c69003200aa998",
          "id": "53c050ac51c69003200aa998",
          "name": "Cleveland Clinic"
      },
      "patient": {
          "name": "Maxwell Forrest"
      },
      "source": "emr-1-320",
      "updatedAt": "2014-10-19T21:02:17.949Z"
  },
  {
      "codes": [
          {
              "code": "729.89",
              "codeSystem": "2.16.840.1.113883.6.103",
              "codeSystemName": "ICD-9CM",
              "name": "WEAKNESS OF LEFT LEG"
          },
          {
              "code": "R53.1",
              "codeSystem": "2.16.840.1.113883.6.90",
              "codeSystemName": "ICD-10-CM",
              "name": "WEAKNESS OF LEFT LEG"
          }
      ],
      "createdAt": "2014-10-19T21:02:17.949Z",
      "id": "5443d6ca71b5c7f1a243879f",
      "name": "Exophthalmos",
      "organization": {
          "href": "/medical/organizations/53c050ac51c69003200aa998",
          "id": "53c050ac51c69003200aa998",
          "name": "Cleveland Clinic"
      },
      "patient": {
          "name": "Maxwell Forrest"
      },
      "source": "emr-1-320",
      "updatedAt": "2014-10-19T21:02:17.949Z"
  }
]

// Get an problem by id
request
.get('https://api.humanapi.co/v1/human/medical/issues/5443d6ca71b5c7f1a243879f?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as problem:
{
    "codes": [
        {
            "code": "729.89",
            "codeSystem": "2.16.840.1.113883.6.103",
            "codeSystemName": "ICD-9CM",
            "name": "WEAKNESS OF LEFT LEG"
        },
        {
            "code": "R53.1",
            "codeSystem": "2.16.840.1.113883.6.90",
            "codeSystemName": "ICD-10-CM",
            "name": "WEAKNESS OF LEFT LEG"
        }
    ],
    "createdAt": "2014-10-19T21:02:17.949Z",
    "id": "5443d6ca71b5c7f1a243879f",
    "name": "Exophthalmos",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "source": "emr-1-320",
    "updatedAt": "2014-10-19T21:02:17.949Z"
}

Get a list of medical problems the user has had so far

Get Problems

Returns a list of medical problems

GET https://api.humanapi.co/v1/human/medical/issues

Returns a single problem

GET https://api.humanapi.co/v1/human/medical/issues/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the problem
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
name String The name of the problem
patient Object Patient information (“name” and other optional attributes)
organization Object Hospital information (See organizations)
codes Object See codes object

Procedures

# Get all procedures associated with the user
curl "https://api.humanapi.co/v1/human/medical/procedures?access_token=demo"

# Returns a json array of procedures:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2014-09-01T21:42:09.969Z",
        "updatedAt": "2014-09-01T21:42:10.072Z",
        "dateTime": "2014-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "device": null,
        "deviceCodes": [],
        "name": "HCHG CYSTOURETHROSCOPY",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "performer": {
            "address": null,
            "organizationName": null,
            "phone": null
        },
        "specimen": null,
        "specimenCodes": [],
        "codes": [
            {
                "code": "52000",
                "codeSystem": "2.16.840.1.113883.6.12",
                "codeSystemName": "CPT-4",
                "name": "HCHG CYSTOURETHROSCOPY"
            }
        ]
    }
]

# Get a procedure by id
curl "https://api.humanapi.co/v1/human/medical/procedures/55e692d20c7deefb7cfe90f8?access_token=demo"

{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2014-09-01T21:42:09.969Z",
    "updatedAt": "2014-09-01T21:42:10.072Z",
    "dateTime": "2014-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "device": null,
    "deviceCodes": [],
    "name": "HCHG CYSTOURETHROSCOPY",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "performer": {
        "address": null,
        "organizationName": null,
        "phone": null
    },
    "specimen": null,
    "specimenCodes": [],
    "codes": [
        {
            "code": "52000",
            "codeSystem": "2.16.840.1.113883.6.12",
            "codeSystemName": "CPT-4",
            "name": "HCHG CYSTOURETHROSCOPY"
        }
    ]
}
// Get all procedures associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/procedures?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of procedures:
[
    {
        "id": "55e692d20c7deefb7cfe90f8",
        "createdAt": "2014-09-01T21:42:09.969Z",
        "updatedAt": "2014-09-01T21:42:10.072Z",
        "dateTime": "2014-02-11T09:30:00.000Z",
        "source": "emr-1-320",
        "device": null,
        "deviceCodes": [],
        "name": "HCHG CYSTOURETHROSCOPY",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "performer": {
            "address": null,
            "organizationName": null,
            "phone": null
        },
        "specimen": null,
        "specimenCodes": [],
        "codes": [
            {
                "code": "52000",
                "codeSystem": "2.16.840.1.113883.6.12",
                "codeSystemName": "CPT-4",
                "name": "HCHG CYSTOURETHROSCOPY"
            }
        ]
    }
]

// Get a procedure by id
request
.get('https://api.humanapi.co/v1/human/medical/procedures/55e692d20c7deefb7cfe90f8?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as a procedure:
{
    "id": "55e692d20c7deefb7cfe90f8",
    "createdAt": "2014-09-01T21:42:09.969Z",
    "updatedAt": "2014-09-01T21:42:10.072Z",
    "dateTime": "2014-02-11T09:30:00.000Z",
    "source": "emr-1-320",
    "device": null,
    "deviceCodes": [],
    "name": "HCHG CYSTOURETHROSCOPY",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "performer": {
        "address": null,
        "organizationName": null,
        "phone": null
    },
    "specimen": null,
    "specimenCodes": [],
    "codes": [
        {
            "code": "52000",
            "codeSystem": "2.16.840.1.113883.6.12",
            "codeSystemName": "CPT-4",
            "name": "HCHG CYSTOURETHROSCOPY"
        }
    ]
}

Get a list of medical procedures associated with the user

Get Procedures

Returns a list of medical procedures

GET https://api.humanapi.co/v1/human/medical/procedures

Returns a single procedure

GET https://api.humanapi.co/v1/human/medical/procedures/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the procedure
createdAt Date The time the record was created on the Human API server
updatedAt Date The time the record was updated on the Human API server
dateTime String The date of the procedure
source String The name of the originating service
device String Device (if applicable)
deviceCodes Array[] Device codes (when available)
name String Name of the procedure
organization Object Hospital information (See organizations)
performer Object Performer information (see below)
specimen String Specimen related to the procedure (if applicable)
specimenCodes Array[] Specimen codes (when available)
codes Object See codes object

Performer Object

Property Type Description
address String Address of the performer
organizationName String Name of the performer’s organization
phone String Phone number of the performer

Profile

# Get user's medical profile
curl "https://api.humanapi.co/v1/human/medical/profile?access_token=demo"

# Returns a json object as profile:
{
  "id": "54e344fa79192a2e4993dfda",
  "updatedAt": "2015-02-13T21:27:42.078Z",
  "createdAt": "2015-02-13T21:27:42.078Z",
  "demographics": {
    "address": {
      "city": "Vulcun City",
      "country": "USA",
      "state": "CA",
      "street": ["1 Milky way"],
      "zip": "94025"
    },
    "ethnicity": "Non Hispanic",
    "gender": "male",
    "language": "ENG",
    "race": "White/Caucasian",
    "dob": "03-05-1985",
    "name": {
      "family": "Forrest",
      "given": ["Maxwell"]
    }
  },
  "alcohol": {
    "use": "yes"
  },
  "smoking": {
    "status": "Never smoker"
  }
}
// Get all profile associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/profile?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as profile:
{
  "id": "54e344fa79192a2e4993dfda",
  "updatedAt": "2015-02-13T21:27:42.078Z",
  "createdAt": "2015-02-13T21:27:42.078Z",
  "demographics": {
    "address": {
      "city": "Vulcun City",
      "country": "USA",
      "state": "CA",
      "street": ["1 Milky way"],
      "zip": "94025"
    },
    "ethnicity": "Non Hispanic",
    "gender": "male",
    "language": "ENG",
    "race": "White/Caucasian",
    "dob": "03-05-1985",
    "name": {
      "family": "Forrest",
      "given": ["Maxwell"]
    }
  },
  "alcohol": {
    "use": "yes"
  },
  "smoking": {
    "status": "Never smoker"
  }
}

Get the current medical health profile of the user. Returns user’s data that most likely doesn’t change: demographics, smoking status, alcohol use, etc.

Get Profile

Returns a list of medical profile

GET https://api.humanapi.co/v1/human/medical/profile

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the profile
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
demographics Object The demographics of the user (see below)
alcohol Object The user’s alcohol usage
smoking Object The user’s smoking habits

Demographics Object

Property Type Description
address Object The address information of the user
ethnicity String The ethnicity of the user
gender String The user’s gender
language String The user’s primary language
race String the users’s race
dob String The user’s date of birth
name Object The user’s name

Alcohol Object

Property Type Description
use String The user’s alcohol usage (e.g. “yes”, “no”)

Smoking Object

Property Type Description
status String The user’s smoking status (e.g. “Never Smoker”)

Test Results

# Get all test_results associated with the user
curl "https://api.humanapi.co/v1/human/medical/test_results?access_token=demo"

# Returns a json array of test_results:
[  {
    "allResults": [ ],
    "components": [
        {
            "codes": [],
            "high": "8.3",
            "low": "5.7",
            "name": "Protein Total, Serum",
            "unit": "g/dL",
            "value": "7.1"
        },
        {
            "codes": [],
            "high": "5.0",
            "low": "3.4",
            "name": "Albumin (Serum)",
            "unit": "g/dL",
            "value": "4.3"
        },
        {
            "codes": [],
            "high": "3.9",
            "low": "1.8",
            "name": "Globulin Serum",
            "unit": "g/dL",
            "value": "2.8"
        }
    ],
    "codes": [
        {
            "codeSystem": "2.16.840.1.113883.6.1",
            "codeSystemName": "LOINC",
            "name": "DIAGNOSIS"
        }
    ],
    "createdAt": "2014-10-30T21:02:17.956Z",
    "id": "546d44478a6d23e01a72865a",
    "name": "LAB TOTAL PROTEIN+ALB",
    "orderedBy": "James Kirk, MD",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "recipients": [
        {
            "isPCP": true,
            "name": "Jean-Luc Picard, MD",
            "objectID": "50006",
            "recipTemplate": "WPMessageRecipientTemplateUnknown"
        }
    ],
    "resultDateTime": "2010-09-10T04:00:00.000Z",
    "source": "emr-1-320",
    "status": "Final result",
    "updatedAt": "2014-10-20T21:02:17.956Z"
}]

# Get a test results by id
curl "https://api.humanapi.co/v1/human/medical/test_results/546d44478a6d23e01a72865a?access_token=demo"

{
  "allResults": [ ],
  "components": [
      {
          "codes": [],
          "high": "8.3",
          "low": "5.7",
          "name": "Protein Total, Serum",
          "unit": "g/dL",
          "value": "7.1"
      },
      {
          "codes": [],
          "high": "5.0",
          "low": "3.4",
          "name": "Albumin (Serum)",
          "unit": "g/dL",
          "value": "4.3"
      },
      {
          "codes": [],
          "high": "3.9",
          "low": "1.8",
          "name": "Globulin Serum",
          "unit": "g/dL",
          "value": "2.8"
      }
  ],
  "codes": [
      {
          "codeSystem": "2.16.840.1.113883.6.1",
          "codeSystemName": "LOINC",
          "name": "DIAGNOSIS"
      }
  ],
  "createdAt": "2014-10-30T21:02:17.956Z",
  "id": "546d44478a6d23e01a72865a",
  "name": "LAB TOTAL PROTEIN+ALB",
  "orderedBy": "James Kirk, MD",
  "organization": {
      "href": "/medical/organizations/53c050ac51c69003200aa998",
      "id": "53c050ac51c69003200aa998",
      "name": "Cleveland Clinic"
  },
  "patient": {
      "name": "Maxwell Forrest"
  },
  "recipients": [
      {
          "isPCP": true,
          "name": "Jean-Luc Picard, MD",
          "objectID": "50006",
          "recipTemplate": "WPMessageRecipientTemplateUnknown"
      }
  ],
  "resultDateTime": "2010-09-10T04:00:00.000Z",
  "source": "emr-1-320",
  "status": "Final result",
  "updatedAt": "2014-10-20T21:02:17.956Z"
}
// Get all test_results associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/test_results?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of test_results:
[ {
    "allResults": [ ],
    "components": [
        {
            "codes": [],
            "high": "8.3",
            "low": "5.7",
            "name": "Protein Total, Serum",
            "unit": "g/dL",
            "value": "7.1"
        },
        {
            "codes": [],
            "high": "5.0",
            "low": "3.4",
            "name": "Albumin (Serum)",
            "unit": "g/dL",
            "value": "4.3"
        },
        {
            "codes": [],
            "high": "3.9",
            "low": "1.8",
            "name": "Globulin Serum",
            "unit": "g/dL",
            "value": "2.8"
        }
    ],
    "codes": [
        {
            "codeSystem": "2.16.840.1.113883.6.1",
            "codeSystemName": "LOINC",
            "name": "DIAGNOSIS"
        }
    ],
    "createdAt": "2014-10-30T21:02:17.956Z",
    "id": "546d44478a6d23e01a72865a",
    "name": "LAB TOTAL PROTEIN+ALB",
    "orderedBy": "James Kirk, MD",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "patient": {
        "name": "Maxwell Forrest"
    },
    "recipients": [
        {
            "isPCP": true,
            "name": "Jean-Luc Picard, MD",
            "objectID": "50006",
            "recipTemplate": "WPMessageRecipientTemplateUnknown"
        }
    ],
    "resultDateTime": "2010-09-10T04:00:00.000Z",
    "source": "emr-1-320",
    "status": "Final result",
    "updatedAt": "2014-10-20T21:02:17.956Z"
  }]

// Get an test results by id
request
.get('https://api.humanapi.co/v1/human/medical/test_results/546d44478a6d23e01a72865a?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as test results:
{
      "allResults": [ ],
      "components": [
          {
              "codes": [],
              "high": "8.3",
              "low": "5.7",
              "name": "Protein Total, Serum",
              "unit": "g/dL",
              "value": "7.1"
          },
          {
              "codes": [],
              "high": "5.0",
              "low": "3.4",
              "name": "Albumin (Serum)",
              "unit": "g/dL",
              "value": "4.3"
          },
          {
              "codes": [],
              "high": "3.9",
              "low": "1.8",
              "name": "Globulin Serum",
              "unit": "g/dL",
              "value": "2.8"
          }
      ],
      "codes": [
          {
              "codeSystem": "2.16.840.1.113883.6.1",
              "codeSystemName": "LOINC",
              "name": "DIAGNOSIS"
          }
      ],
      "createdAt": "2014-10-30T21:02:17.956Z",
      "id": "546d44478a6d23e01a72865a",
      "name": "LAB TOTAL PROTEIN+ALB",
      "orderedBy": "James Kirk, MD",
      "organization": {
          "href": "/medical/organizations/53c050ac51c69003200aa998",
          "id": "53c050ac51c69003200aa998",
          "name": "Cleveland Clinic"
      },
      "patient": {
          "name": "Maxwell Forrest"
      },
      "recipients": [
          {
              "isPCP": true,
              "name": "Jean-Luc Picard, MD",
              "objectID": "50006",
              "recipTemplate": "WPMessageRecipientTemplateUnknown"
          }
      ],
      "resultDateTime": "2010-09-10T04:00:00.000Z",
      "source": "emr-1-320",
      "status": "Final result",
      "updatedAt": "2014-10-20T21:02:17.956Z"
  }

Get a list of medical lab’s results from a user’s medical record

Get Test Results

Returns a list of medical test_results

GET https://api.humanapi.co/v1/human/medical/test_results

Returns a single test results

GET https://api.humanapi.co/v1/human/medical/test_results/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the test result record
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
components Array[Object] A list of components of the test (See component below)
name String The name of the test preformed (e.g. ‘COMPREHENSIVE METABOLIC PANEL’, 'LIPID PANEL’, 'URINE CULTURE’)
patient Object Patient information (“name” and other optional attributes)
orderedBy String The name of the ordering physician or entity
recipients Array[Object] A list of recipients of the test - if provided (see recipient object below)
resultDateTime Date The date of the test result
status String The status of the test result (e.g. 'Final result’, 'Edited’, 'Edited Result - FINAL’)
allResults Array[Object] [Deprecated] Use components instead.
comments String Optional comments for the test result
narrative String Optional narrative for the test result
impression String Optional impression for the test result
transcriptions String Optional transcriptions for the test result
organization Object Hospital information (See organizations)
codes Object See codes object

Component Object

Property Type Description
name String The name of the test component (e.g. 'Potassium’, 'MCHC’, 'MCV’)
value String The test result value
unit String The unit of the value - if provided (e.g. 'mg/dL’, ’%’, 'mmol/L’)
low String The low value for the component - if provided
high String The high value for the component - if provided
refRange String The reference range for the value - if provided (e.g. 'Negative’, ’>60’, ’<150’)
componentComments String Optional comments provided for the component
codes Object See codes object

Recipient Object

Property Type Description
objectID String The id of the recipient
name String The name of the recipient
isPCP Boolean Indicates if the provider is the Primary Care Provider of the user
recipTemplate String The recipient template (e.g. 'WPMessageRecipientTemplateUnknown’)

Timeline

# Get all timeline associated with the user
curl "https://api.humanapi.co/v1/human/medical/timeline?access_token=demo"

# Returns a json array of timeline:
[{
  "id": "54e4bba074874bfc058cc56b",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.002Z",
  "createdAt": "2015-02-18T16:19:45.002Z",
  "type": "encounters",
  "dateTime": "Wed Sep 26 2012 18:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Radiology",
  "href": "/medical/encounters/54442e3ea1d1261353c16962",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc57d",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.243Z",
  "createdAt": "2015-02-18T16:19:45.243Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "n/a",
  "href": "/medical/test_results/546d43db8a6d23e01a728659",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc581",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.253Z",
  "createdAt": "2015-02-18T16:19:45.253Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ASPARTATE AMINOTRANSFERASE",
  "href": "/medical/test_results/546d43508a6d23e01a728658",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc584",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.274Z",
  "createdAt": "2015-02-18T16:19:45.274Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/546d45838a6d23e01a72865c",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc68f",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.080Z",
  "createdAt": "2015-02-18T16:19:46.080Z",
  "type": "immunizations",
  "dateTime": "Wed Sep 07 2011 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Influenza vaccine 3+ YEARS",
  "href": "/medical/immunizations/5443d24d0d2a0e0c4b3672ec",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc572",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.211Z",
  "createdAt": "2015-02-18T16:19:45.211Z",
  "type": "test_results",
  "dateTime": "Wed Oct 08 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/546d376b8a6d23e01a72864a",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc58a",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.289Z",
  "createdAt": "2015-02-18T16:19:45.289Z",
  "type": "test_results",
  "dateTime": "Wed Nov 05 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/546d326c8a6d23e01a728648",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc58c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.294Z",
  "createdAt": "2015-02-18T16:19:45.294Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC W/AUTO DIFF",
  "href": "/medical/test_results/547685b8412813fc27974809",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc594",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.322Z",
  "createdAt": "2015-02-18T16:19:45.322Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "US Abdomen Retroperitoneal",
  "href": "/medical/test_results/547685b8412813fc27974811",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc59c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.355Z",
  "createdAt": "2015-02-18T16:19:45.355Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "DUPLEX ABDOMEN/PELVIS/RETROPERITONEAL LIMITED",
  "href": "/medical/test_results/547685b8412813fc27974819",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5a4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.373Z",
  "createdAt": "2015-02-18T16:19:45.373Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC BATTERY",
  "href": "/medical/test_results/547685b8412813fc27974821",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ac",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.393Z",
  "createdAt": "2015-02-18T16:19:45.393Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "EMG(NEURO/NI)",
  "href": "/medical/test_results/547685b8412813fc27974829",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5b4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.424Z",
  "createdAt": "2015-02-18T16:19:45.424Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc27974831",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5bc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.440Z",
  "createdAt": "2015-02-18T16:19:45.440Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/547685b8412813fc27974839",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5c4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.459Z",
  "createdAt": "2015-02-18T16:19:45.459Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "MICROALBUMIN/CREAT URINE RATIO",
  "href": "/medical/test_results/547685b8412813fc27974841",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5cc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.491Z",
  "createdAt": "2015-02-18T16:19:45.491Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974849",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5d4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.511Z",
  "createdAt": "2015-02-18T16:19:45.511Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE, RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974851",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5dc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.532Z",
  "createdAt": "2015-02-18T16:19:45.532Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB GLUCOSE",
  "href": "/medical/test_results/547685b8412813fc27974859",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5e4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.557Z",
  "createdAt": "2015-02-18T16:19:45.557Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Blood test, thyroid stimulating hormone (TSH)",
  "href": "/medical/test_results/547685b8412813fc27974861",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ec",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.586Z",
  "createdAt": "2015-02-18T16:19:45.586Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "THYROID PROFILE",
  "href": "/medical/test_results/547685b8412813fc27974869",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5f4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.608Z",
  "createdAt": "2015-02-18T16:19:45.608Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "BILIRUBIN TOTAL",
  "href": "/medical/test_results/547685b8412813fc27974871",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5fc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.631Z",
  "createdAt": "2015-02-18T16:19:45.631Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "BILIRUBIN, DIRECT",
  "href": "/medical/test_results/547685b8412813fc27974879",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc604",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.661Z",
  "createdAt": "2015-02-18T16:19:45.661Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALBUMIN, SERUM / PLASMA",
  "href": "/medical/test_results/547685b8412813fc27974881",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc60c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.685Z",
  "createdAt": "2015-02-18T16:19:45.685Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALBUMIN",
  "href": "/medical/test_results/547685b8412813fc27974889",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc614",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.707Z",
  "createdAt": "2015-02-18T16:19:45.707Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "n/a",
  "href": "/medical/test_results/547685b8412813fc27974891",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc61c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.729Z",
  "createdAt": "2015-02-18T16:19:45.729Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ALANINE AMINOTRANSFERASE",
  "href": "/medical/test_results/547685b8412813fc27974899",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc624",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.755Z",
  "createdAt": "2015-02-18T16:19:45.755Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALANINE AMINOTRANSFERASE, SERUM",
  "href": "/medical/test_results/547685b8412813fc279748a1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc62c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.778Z",
  "createdAt": "2015-02-18T16:19:45.778Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ASPARTATE AMINOTRANSFERASE, SERUM",
  "href": "/medical/test_results/547685b8412813fc279748a9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc634",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.801Z",
  "createdAt": "2015-02-18T16:19:45.801Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ASPARTATE AMINOTRANSFERASE",
  "href": "/medical/test_results/547685b8412813fc279748b1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc63c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.826Z",
  "createdAt": "2015-02-18T16:19:45.826Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB TOTAL PROTEIN+ALB",
  "href": "/medical/test_results/547685b8412813fc279748b9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc644",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.849Z",
  "createdAt": "2015-02-18T16:19:45.849Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPREHENSIVE METABOLIC PANEL",
  "href": "/medical/test_results/547685b8412813fc279748c1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc64c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.873Z",
  "createdAt": "2015-02-18T16:19:45.873Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/547685b8412813fc279748c9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc654",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.896Z",
  "createdAt": "2015-02-18T16:19:45.896Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/547685b8412813fc279748d1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc65c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.920Z",
  "createdAt": "2015-02-18T16:19:45.920Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "HEMOGLOBIN A1C PANEL",
  "href": "/medical/test_results/547685b8412813fc279748d9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc664",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.942Z",
  "createdAt": "2015-02-18T16:19:45.942Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "HEMOGLOBIN A1C PANEL",
  "href": "/medical/test_results/547685b8412813fc279748e1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc66c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.965Z",
  "createdAt": "2015-02-18T16:19:45.965Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc279748e9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc674",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.989Z",
  "createdAt": "2015-02-18T16:19:45.989Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/547685b8412813fc279748f1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc67c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.015Z",
  "createdAt": "2015-02-18T16:19:46.015Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/547685b8412813fc279748f9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc684",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.038Z",
  "createdAt": "2015-02-18T16:19:46.038Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB COMPLETE BLOOD COUNT W/DIFF",
  "href": "/medical/test_results/547685b8412813fc27974901",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc593",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.319Z",
  "createdAt": "2015-02-18T16:19:45.319Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC W/AUTO DIFF",
  "href": "/medical/test_results/547685b8412813fc27974810",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc59b",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.353Z",
  "createdAt": "2015-02-18T16:19:45.353Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "US Abdomen Retroperitoneal",
  "href": "/medical/test_results/547685b8412813fc27974818",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5a3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.370Z",
  "createdAt": "2015-02-18T16:19:45.370Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "DUPLEX ABDOMEN/PELVIS/RETROPERITONEAL LIMITED",
  "href": "/medical/test_results/547685b8412813fc27974820",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ab",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.391Z",
  "createdAt": "2015-02-18T16:19:45.391Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC BATTERY",
  "href": "/medical/test_results/547685b8412813fc27974828",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5b3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.421Z",
  "createdAt": "2015-02-18T16:19:45.421Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "EMG(NEURO/NI)",
  "href": "/medical/test_results/547685b8412813fc27974830",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5bb",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.438Z",
  "createdAt": "2015-02-18T16:19:45.438Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc27974838",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5c3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.457Z",
  "createdAt": "2015-02-18T16:19:45.457Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/547685b8412813fc27974840",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5cb",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.489Z",
  "createdAt": "2015-02-18T16:19:45.489Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "MICROALBUMIN/CREAT URINE RATIO",
  "href": "/medical/test_results/547685b8412813fc27974848",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5d3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.508Z",
  "createdAt": "2015-02-18T16:19:45.508Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974850",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5db",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.529Z",
  "createdAt": "2015-02-18T16:19:45.529Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE, RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974858",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5e3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.552Z",
  "createdAt": "2015-02-18T16:19:45.552Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB GLUCOSE",
  "href": "/medical/test_results/547685b8412813fc27974860",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]
// Get all timeline associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/timeline?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of timeline:
[{
  "id": "54e4bba074874bfc058cc56b",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.002Z",
  "createdAt": "2015-02-18T16:19:45.002Z",
  "type": "encounters",
  "dateTime": "Wed Sep 26 2012 18:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Radiology",
  "href": "/medical/encounters/54442e3ea1d1261353c16962",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc57d",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.243Z",
  "createdAt": "2015-02-18T16:19:45.243Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "n/a",
  "href": "/medical/test_results/546d43db8a6d23e01a728659",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc581",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.253Z",
  "createdAt": "2015-02-18T16:19:45.253Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ASPARTATE AMINOTRANSFERASE",
  "href": "/medical/test_results/546d43508a6d23e01a728658",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc584",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.274Z",
  "createdAt": "2015-02-18T16:19:45.274Z",
  "type": "test_results",
  "dateTime": "Wed Sep 10 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/546d45838a6d23e01a72865c",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc68f",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.080Z",
  "createdAt": "2015-02-18T16:19:46.080Z",
  "type": "immunizations",
  "dateTime": "Wed Sep 07 2011 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Influenza vaccine 3+ YEARS",
  "href": "/medical/immunizations/5443d24d0d2a0e0c4b3672ec",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc572",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.211Z",
  "createdAt": "2015-02-18T16:19:45.211Z",
  "type": "test_results",
  "dateTime": "Wed Oct 08 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/546d376b8a6d23e01a72864a",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc58a",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.289Z",
  "createdAt": "2015-02-18T16:19:45.289Z",
  "type": "test_results",
  "dateTime": "Wed Nov 05 2014 04:00:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/546d326c8a6d23e01a728648",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc58c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.294Z",
  "createdAt": "2015-02-18T16:19:45.294Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC W/AUTO DIFF",
  "href": "/medical/test_results/547685b8412813fc27974809",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc594",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.322Z",
  "createdAt": "2015-02-18T16:19:45.322Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "US Abdomen Retroperitoneal",
  "href": "/medical/test_results/547685b8412813fc27974811",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc59c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.355Z",
  "createdAt": "2015-02-18T16:19:45.355Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "DUPLEX ABDOMEN/PELVIS/RETROPERITONEAL LIMITED",
  "href": "/medical/test_results/547685b8412813fc27974819",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5a4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.373Z",
  "createdAt": "2015-02-18T16:19:45.373Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC BATTERY",
  "href": "/medical/test_results/547685b8412813fc27974821",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ac",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.393Z",
  "createdAt": "2015-02-18T16:19:45.393Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "EMG(NEURO/NI)",
  "href": "/medical/test_results/547685b8412813fc27974829",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5b4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.424Z",
  "createdAt": "2015-02-18T16:19:45.424Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc27974831",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5bc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.440Z",
  "createdAt": "2015-02-18T16:19:45.440Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/547685b8412813fc27974839",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5c4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.459Z",
  "createdAt": "2015-02-18T16:19:45.459Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "MICROALBUMIN/CREAT URINE RATIO",
  "href": "/medical/test_results/547685b8412813fc27974841",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5cc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.491Z",
  "createdAt": "2015-02-18T16:19:45.491Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974849",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5d4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.511Z",
  "createdAt": "2015-02-18T16:19:45.511Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE, RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974851",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5dc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.532Z",
  "createdAt": "2015-02-18T16:19:45.532Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB GLUCOSE",
  "href": "/medical/test_results/547685b8412813fc27974859",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5e4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.557Z",
  "createdAt": "2015-02-18T16:19:45.557Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Blood test, thyroid stimulating hormone (TSH)",
  "href": "/medical/test_results/547685b8412813fc27974861",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ec",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.586Z",
  "createdAt": "2015-02-18T16:19:45.586Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "THYROID PROFILE",
  "href": "/medical/test_results/547685b8412813fc27974869",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5f4",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.608Z",
  "createdAt": "2015-02-18T16:19:45.608Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "BILIRUBIN TOTAL",
  "href": "/medical/test_results/547685b8412813fc27974871",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5fc",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.631Z",
  "createdAt": "2015-02-18T16:19:45.631Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "BILIRUBIN, DIRECT",
  "href": "/medical/test_results/547685b8412813fc27974879",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc604",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.661Z",
  "createdAt": "2015-02-18T16:19:45.661Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALBUMIN, SERUM / PLASMA",
  "href": "/medical/test_results/547685b8412813fc27974881",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc60c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.685Z",
  "createdAt": "2015-02-18T16:19:45.685Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALBUMIN",
  "href": "/medical/test_results/547685b8412813fc27974889",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc614",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.707Z",
  "createdAt": "2015-02-18T16:19:45.707Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "n/a",
  "href": "/medical/test_results/547685b8412813fc27974891",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc61c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.729Z",
  "createdAt": "2015-02-18T16:19:45.729Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ALANINE AMINOTRANSFERASE",
  "href": "/medical/test_results/547685b8412813fc27974899",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc624",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.755Z",
  "createdAt": "2015-02-18T16:19:45.755Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ALANINE AMINOTRANSFERASE, SERUM",
  "href": "/medical/test_results/547685b8412813fc279748a1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc62c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.778Z",
  "createdAt": "2015-02-18T16:19:45.778Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "ASPARTATE AMINOTRANSFERASE, SERUM",
  "href": "/medical/test_results/547685b8412813fc279748a9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc634",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.801Z",
  "createdAt": "2015-02-18T16:19:45.801Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB ASPARTATE AMINOTRANSFERASE",
  "href": "/medical/test_results/547685b8412813fc279748b1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc63c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.826Z",
  "createdAt": "2015-02-18T16:19:45.826Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB TOTAL PROTEIN+ALB",
  "href": "/medical/test_results/547685b8412813fc279748b9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc644",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.849Z",
  "createdAt": "2015-02-18T16:19:45.849Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPREHENSIVE METABOLIC PANEL",
  "href": "/medical/test_results/547685b8412813fc279748c1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc64c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.873Z",
  "createdAt": "2015-02-18T16:19:45.873Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/547685b8412813fc279748c9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc654",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.896Z",
  "createdAt": "2015-02-18T16:19:45.896Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Hemoglobin",
  "href": "/medical/test_results/547685b8412813fc279748d1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc65c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.920Z",
  "createdAt": "2015-02-18T16:19:45.920Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "HEMOGLOBIN A1C PANEL",
  "href": "/medical/test_results/547685b8412813fc279748d9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc664",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.942Z",
  "createdAt": "2015-02-18T16:19:45.942Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "HEMOGLOBIN A1C PANEL",
  "href": "/medical/test_results/547685b8412813fc279748e1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc66c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.965Z",
  "createdAt": "2015-02-18T16:19:45.965Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc279748e9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc674",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.989Z",
  "createdAt": "2015-02-18T16:19:45.989Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/547685b8412813fc279748f1",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc67c",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.015Z",
  "createdAt": "2015-02-18T16:19:46.015Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Complete Blood Count",
  "href": "/medical/test_results/547685b8412813fc279748f9",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba274874bfc058cc684",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:46.038Z",
  "createdAt": "2015-02-18T16:19:46.038Z",
  "type": "test_results",
  "dateTime": "Wed Jan 10 2007 23:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB COMPLETE BLOOD COUNT W/DIFF",
  "href": "/medical/test_results/547685b8412813fc27974901",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc593",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.319Z",
  "createdAt": "2015-02-18T16:19:45.319Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC W/AUTO DIFF",
  "href": "/medical/test_results/547685b8412813fc27974810",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc59b",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.353Z",
  "createdAt": "2015-02-18T16:19:45.353Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "US Abdomen Retroperitoneal",
  "href": "/medical/test_results/547685b8412813fc27974818",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5a3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.370Z",
  "createdAt": "2015-02-18T16:19:45.370Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "DUPLEX ABDOMEN/PELVIS/RETROPERITONEAL LIMITED",
  "href": "/medical/test_results/547685b8412813fc27974820",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5ab",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.391Z",
  "createdAt": "2015-02-18T16:19:45.391Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "CBC BATTERY",
  "href": "/medical/test_results/547685b8412813fc27974828",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5b3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.421Z",
  "createdAt": "2015-02-18T16:19:45.421Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "EMG(NEURO/NI)",
  "href": "/medical/test_results/547685b8412813fc27974830",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5bb",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.438Z",
  "createdAt": "2015-02-18T16:19:45.438Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "COMPLETE BLOOD COUNT",
  "href": "/medical/test_results/547685b8412813fc27974838",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5c3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.457Z",
  "createdAt": "2015-02-18T16:19:45.457Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "Multi-test Laboratory Panels",
  "href": "/medical/test_results/547685b8412813fc27974840",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5cb",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.489Z",
  "createdAt": "2015-02-18T16:19:45.489Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "MICROALBUMIN/CREAT URINE RATIO",
  "href": "/medical/test_results/547685b8412813fc27974848",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5d3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.508Z",
  "createdAt": "2015-02-18T16:19:45.508Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974850",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5db",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.529Z",
  "createdAt": "2015-02-18T16:19:45.529Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "GLUCOSE, RANDOM",
  "href": "/medical/test_results/547685b8412813fc27974858",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}, {
  "id": "54e4bba174874bfc058cc5e3",
  "source": "emr-1-320",
  "updatedAt": "2015-02-18T16:19:45.552Z",
  "createdAt": "2015-02-18T16:19:45.552Z",
  "type": "test_results",
  "dateTime": "Wed Apr 02 2014 01:51:00 GMT+0000 (UTC)",
  "author": "n/a",
  "name": "LAB GLUCOSE",
  "href": "/medical/test_results/547685b8412813fc27974860",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]

Get a list of medical timeline the user has had so far

Get timeline

Returns a timeline of the user. It shows every timestamped medical object recorded into our system. The full object details are not available here but they are linked and available via own resource end points.

GET https://api.humanapi.co/v1/human/medical/timeline

Current list of objects injected into the timeline output:

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description Object Types
id String The Id of the object All
source String The name of the originating service All
updatedAt Date The time the record was updated on the Human API server All
createdAt Date The time the record was created on the Human API server All
type String The type of the object All
dateTime String The timestamp of the object All
author String The author (e.g. doctor) name ­ Encounters, Vitals, Narratives
name String The object name Encounters, Test Results, Immunizations
href String Object URL for details retrieval All
department String Source department details­ Encounters, Vitals, Narratives
organization Object Source organization information (See organizations) All

Vitals

# Get all vitals readings associated with the user
curl "https://api.humanapi.co/v1/human/medical/vitals?access_token=demo"

# Returns a json array of vitals:
[
    {
        "author": "Maxwell Forrest",
        "createdAt": "2014-09-02T05:50:22.654Z",
        "dateTime": "2014-08-18T16:04:00.000Z",
        "id": "55e6914a0c7deefb7cfe90f6",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "results": [
            {
                "codes": [
                    {
                        "code": "8480-6",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "SYSTOLIC BLOOD PRESSURE"
                    }
                ],
                "name": "SYSTOLIC BLOOD PRESSURE",
                "unit": "mm[Hg]",
                "value": "102"
            },
            {
                "codes": [
                    {
                        "code": "8462-4",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "DIASTOLIC BLOOD PRESSURE"
                    }
                ],
                "name": "DIASTOLIC BLOOD PRESSURE",
                "unit": "mm[Hg]",
                "value": "70"
            },
            {
                "codes": [
                    {
                        "code": "8867-4",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "HEART RATE"
                    }
                ],
                "name": "HEART RATE",
                "unit": "/min",
                "value": "80"
            },
            {
                "codes": [
                    {
                        "code": "8302-2",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "HEIGHT"
                    }
                ],
                "name": "HEIGHT",
                "unit": "cm",
                "value": "157.5"
            },
            {
                "codes": [
                    {
                        "code": "3141-9",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "WEIGHT"
                    }
                ],
                "name": "WEIGHT",
                "unit": "kg",
                "value": "61.871"
            },
            {
                "codes": [
                    {
                        "code": "39156-5",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "BODY MASS INDEX"
                    }
                ],
                "name": "BODY MASS INDEX",
                "unit": "kg/m2",
                "value": "24.94"
            }
        ],
        "source": "emr-1-320",
        "updatedAt": "2014-09-02T05:50:22.654Z"
    }
]


# Get an vitals reading by id
curl "https://api.humanapi.co/v1/human/medical/vitals/55e6914a0c7deefb7cfe90f6?access_token=demo"

{
    "author": "Maxwell Forrest",
    "createdAt": "2014-09-02T05:50:22.654Z",
    "dateTime": "2014-08-18T16:04:00.000Z",
    "id": "55e6914a0c7deefb7cfe90f6",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "results": [
        {
            "codes": [
                {
                    "code": "8480-6",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "SYSTOLIC BLOOD PRESSURE"
                }
            ],
            "name": "SYSTOLIC BLOOD PRESSURE",
            "unit": "mm[Hg]",
            "value": "102"
        },
        {
            "codes": [
                {
                    "code": "8462-4",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "DIASTOLIC BLOOD PRESSURE"
                }
            ],
            "name": "DIASTOLIC BLOOD PRESSURE",
            "unit": "mm[Hg]",
            "value": "70"
        },
        {
            "codes": [
                {
                    "code": "8867-4",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "HEART RATE"
                }
            ],
            "name": "HEART RATE",
            "unit": "/min",
            "value": "80"
        },
        {
            "codes": [
                {
                    "code": "8302-2",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "HEIGHT"
                }
            ],
            "name": "HEIGHT",
            "unit": "cm",
            "value": "157.5"
        },
        {
            "codes": [
                {
                    "code": "3141-9",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "WEIGHT"
                }
            ],
            "name": "WEIGHT",
            "unit": "kg",
            "value": "61.871"
        },
        {
            "codes": [
                {
                    "code": "39156-5",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "BODY MASS INDEX"
                }
            ],
            "name": "BODY MASS INDEX",
            "unit": "kg/m2",
            "value": "24.94"
        }
    ],
    "source": "emr-1-320",
    "updatedAt": "2014-09-02T05:50:22.654Z"
}


// Get all vitals associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/vitals?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of vitals:
[
    {
        "author": "Maxwell Forrest",
        "createdAt": "2014-09-02T05:50:22.654Z",
        "dateTime": "2014-08-18T16:04:00.000Z",
        "id": "55e6914a0c7deefb7cfe90f6",
        "organization": {
            "href": "/medical/organizations/53c050ac51c69003200aa998",
            "id": "53c050ac51c69003200aa998",
            "name": "Cleveland Clinic"
        },
        "results": [
            {
                "codes": [
                    {
                        "code": "8480-6",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "SYSTOLIC BLOOD PRESSURE"
                    }
                ],
                "name": "SYSTOLIC BLOOD PRESSURE",
                "unit": "mm[Hg]",
                "value": "102"
            },
            {
                "codes": [
                    {
                        "code": "8462-4",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "DIASTOLIC BLOOD PRESSURE"
                    }
                ],
                "name": "DIASTOLIC BLOOD PRESSURE",
                "unit": "mm[Hg]",
                "value": "70"
            },
            {
                "codes": [
                    {
                        "code": "8867-4",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "HEART RATE"
                    }
                ],
                "name": "HEART RATE",
                "unit": "/min",
                "value": "80"
            },
            {
                "codes": [
                    {
                        "code": "8302-2",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "HEIGHT"
                    }
                ],
                "name": "HEIGHT",
                "unit": "cm",
                "value": "157.5"
            },
            {
                "codes": [
                    {
                        "code": "3141-9",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "WEIGHT"
                    }
                ],
                "name": "WEIGHT",
                "unit": "kg",
                "value": "61.871"
            },
            {
                "codes": [
                    {
                        "code": "39156-5",
                        "codeSystem": "2.16.840.1.113883.6.1",
                        "codeSystemName": "LOINC",
                        "name": "BODY MASS INDEX"
                    }
                ],
                "name": "BODY MASS INDEX",
                "unit": "kg/m2",
                "value": "24.94"
            }
        ],
        "source": "emr-1-320",
        "updatedAt": "2014-09-02T05:50:22.654Z"
    }
]


// Get an vitals reading by id
request
.get('https://api.humanapi.co/v1/human/medical/vitals/55e6914a0c7deefb7cfe90f6?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as vitals reading:
{
    "author": "Maxwell Forrest",
    "createdAt": "2014-09-02T05:50:22.654Z",
    "dateTime": "2014-08-18T16:04:00.000Z",
    "id": "55e6914a0c7deefb7cfe90f6",
    "organization": {
        "href": "/medical/organizations/53c050ac51c69003200aa998",
        "id": "53c050ac51c69003200aa998",
        "name": "Cleveland Clinic"
    },
    "results": [
        {
            "codes": [
                {
                    "code": "8480-6",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "SYSTOLIC BLOOD PRESSURE"
                }
            ],
            "name": "SYSTOLIC BLOOD PRESSURE",
            "unit": "mm[Hg]",
            "value": "102"
        },
        {
            "codes": [
                {
                    "code": "8462-4",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "DIASTOLIC BLOOD PRESSURE"
                }
            ],
            "name": "DIASTOLIC BLOOD PRESSURE",
            "unit": "mm[Hg]",
            "value": "70"
        },
        {
            "codes": [
                {
                    "code": "8867-4",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "HEART RATE"
                }
            ],
            "name": "HEART RATE",
            "unit": "/min",
            "value": "80"
        },
        {
            "codes": [
                {
                    "code": "8302-2",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "HEIGHT"
                }
            ],
            "name": "HEIGHT",
            "unit": "cm",
            "value": "157.5"
        },
        {
            "codes": [
                {
                    "code": "3141-9",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "WEIGHT"
                }
            ],
            "name": "WEIGHT",
            "unit": "kg",
            "value": "61.871"
        },
        {
            "codes": [
                {
                    "code": "39156-5",
                    "codeSystem": "2.16.840.1.113883.6.1",
                    "codeSystemName": "LOINC",
                    "name": "BODY MASS INDEX"
                }
            ],
            "name": "BODY MASS INDEX",
            "unit": "kg/m2",
            "value": "24.94"
        }
    ],
    "source": "emr-1-320",
    "updatedAt": "2014-09-02T05:50:22.654Z"
}

Get the user’s Vitals reading

Get Vitals

Returns a list of vitals readings

GET https://api.humanapi.co/v1/human/medical/vitals

Returns a single vitals reading

GET https://api.humanapi.co/v1/human/medical/vitals/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties

Property Type Description
id String The Id of the vitals reading
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime String The date of the vitals reading
author String The name of the vitals reading author (e.g. doctor)
results Array[Object] A list of all test results (see results object below)
organization Object Hospital information (See organizations)
codes Object See codes object

Results Object

Property Type Description
name String The name of the test component (e.g. ‘HEIGHT’, 'WEIGHT’, 'BODY TEMPERATURE’)
value String The test result value
unit String The unit of the value - if provided (e.g. 'kg’, ’%’, 'Cel’)

CCD

# Get all ccds associated with the user
curl "https://api.humanapi.co/v1/human/medical/ccds?access_token=demo"

# Returns a json array of ccds:
[{
  "id": "54e35f5de0b3d53af2c65921",
  "source": "emr-1-320",
  "updatedAt": "2015-02-17T16:54:24.778Z",
  "createdAt": "2015-02-10T00:09:36.679Z",
  "dateTime": "2014-04-14T18:38:44.000Z",
  "author": "John Smith",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]

# Get an ccd by id raw (xml payload)
curl "https://api.humanapi.co/v1/human/medical/ccds/54e35f5de0b3d53af2c65921/raw?access_token=demo"

# Respond with a CCD xml:
<?xml version="1.0" encoding="UTF-8"?>
<ClinicalDocument>
  <realmCode code="US"/>
  <typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>
  <templateId root="1.2.840.114350.1.72.1.51693"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.1"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.2"/>
  <id assigningAuthorityName="EPC" root="1.2.840.114350.1.13.76.2.7.8.688883.60780139"/>
  <code code="34133-9" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC" displayName="Summarization of Episode Note"/>
  <title>Continuity of Care Document</title>
  ...
  ...
</ClinicalDocument>
// Get all ccds associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/medical/ccds?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of ccds:
[{
  "id": "54e35f5de0b3d53af2c65921",
  "source": "emr-1-320",
  "updatedAt": "2015-02-17T16:54:24.778Z",
  "createdAt": "2015-02-10T00:09:36.679Z",
  "dateTime": "2014-04-14T18:38:44.000Z",
  "author": "John Smith",
  "organization": {
    "id": "53c050ac51c69003200aa998",
    "name": "Cleveland Clinic",
    "href": "/medical/organizations/53c050ac51c69003200aa998"
  }
}]

// Get an ccd by id raw (xml payload)
request
.get('https://api.humanapi.co/v1/human/medical/ccds/54e35f5de0b3d53af2c65921/raw?access_token=demo')
.on('data', function(data) {
  // Will be string xml data
  console.log(String(data));
});

// Respond with a CCD xml:
<?xml version="1.0" encoding="UTF-8"?>
<ClinicalDocument>
  <realmCode code="US"/>
  <typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>
  <templateId root="1.2.840.114350.1.72.1.51693"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.1"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.2"/>
  <id assigningAuthorityName="EPC" root="1.2.840.114350.1.13.76.2.7.8.688883.60780139"/>
  <code code="34133-9" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC" displayName="Summarization of Episode Note"/>
  <title>Continuity of Care Document</title>
  ...
  ...
</ClinicalDocument>

Returns full CCDs available for the user including the raw xml.

Get CCDS

Returns a list of CCDs available for a user

GET https://api.humanapi.co/v1/human/medical/ccds

Returns single CCD raw payload in XML format

GET https://api.humanapi.co/v1/human/medical/ccds/{id}/raw

Click here for full XML example (chrome or firefox only)

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response Properties (list)

Property Type Description
id String The Id of the resource
source String The name of the originating service
updatedAt Date The time the record was updated on the Human API server
createdAt Date The time the record was created on the Human API server
dateTime String The date of the CCD
author String CCD author’s name
organization Object Hospital information (See organizations)

Response Headers (raw CCD)

Header Value
Content-Type text/xml

Wellness API

Activities

# Get all activities associated with the user
curl "https://api.humanapi.co/v1/human/activities?access_token=demo"

# Returns a json array of activities:
[{
  "id": "5510259685cc310900f67753",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T14:29:34.000Z",
  "endTime": "2015-03-23T14:30:17.000Z",
  "tzOffset": "-04:00",
  "type": "walking",
  "source": "moves",
  "duration": 43,
  "distance": 29,
  "steps": 57,
  "calories": 0,
  "sourceData": {
    "manual": false
  },
  "createdAt": "2015-03-23T14:39:19.065Z",
  "updatedAt": "2015-03-23T14:39:19.065Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fe4b58c34cc6661f46f66",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T08:19:24.000Z",
  "endTime": "2015-03-23T08:31:26.000Z",
  "tzOffset": "+00:00",
  "type": "running",
  "source": "runkeeper",
  "duration": 722,
  "distance": 1506.71611260169,
  "steps": 0,
  "calories": 118,
  "sourceData": {},
  "createdAt": "2015-03-23T14:32:27.978Z",
  "updatedAt": "2015-03-23T14:32:27.978Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fbaa568d29c4133b6531a",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T00:01:00.000Z",
  "endTime": "2015-03-23T06:32:00.000Z",
  "tzOffset": "-07:00",
  "type": "unknown",
  "source": "jawbone",
  "duration": 480,
  "distance": 669,
  "steps": 949,
  "calories": 25.2287654541,
  "sourceData": {},
  "createdAt": "2015-03-23T07:03:01.454Z",
  "updatedAt": "2015-03-23T13:36:29.756Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]
# Get an activity by id
curl "https://api.humanapi.co/v1/human/activities/52e20cb2fff56aac62000001?access_token=demo"

# Returns a json object as activity:
{
  "id": "550fbaa568d29c4133b6531a",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T00:01:00.000Z",
  "endTime": "2015-03-23T06:32:00.000Z",
  "tzOffset": "-07:00",
  "type": "unknown",
  "source": "jawbone",
  "duration": 480,
  "distance": 669,
  "steps": 949,
  "calories": 25.2287654541,
  "sourceData": {},
  "createdAt": "2015-03-23T07:03:01.454Z",
  "updatedAt": "2015-03-23T13:36:29.756Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get all activities associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/activities?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of activities:
[{
  "id": "5510259685cc310900f67753",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T14:29:34.000Z",
  "endTime": "2015-03-23T14:30:17.000Z",
  "tzOffset": "-04:00",
  "type": "walking",
  "source": "moves",
  "duration": 43,
  "distance": 29,
  "steps": 57,
  "calories": 0,
  "sourceData": {
    "manual": false
  },
  "createdAt": "2015-03-23T14:39:19.065Z",
  "updatedAt": "2015-03-23T14:39:19.065Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fe4b58c34cc6661f46f66",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T08:19:24.000Z",
  "endTime": "2015-03-23T08:31:26.000Z",
  "tzOffset": "+00:00",
  "type": "running",
  "source": "runkeeper",
  "duration": 722,
  "distance": 1506.71611260169,
  "steps": 0,
  "calories": 118,
  "sourceData": {},
  "createdAt": "2015-03-23T14:32:27.978Z",
  "updatedAt": "2015-03-23T14:32:27.978Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fbaa568d29c4133b6531a",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T00:01:00.000Z",
  "endTime": "2015-03-23T06:32:00.000Z",
  "tzOffset": "-07:00",
  "type": "unknown",
  "source": "jawbone",
  "duration": 480,
  "distance": 669,
  "steps": 949,
  "calories": 25.2287654541,
  "sourceData": {},
  "createdAt": "2015-03-23T07:03:01.454Z",
  "updatedAt": "2015-03-23T13:36:29.756Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

// Get an activity by id
request
.get('https://api.humanapi.co/v1/human/activities/550ff8f985cc310900ea927d?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as activity:
{
  "id": "550fbaa568d29c4133b6531a",
  "userId": "52e20cb2fff56aac62000001",
  "startTime": "2015-03-23T00:01:00.000Z",
  "endTime": "2015-03-23T06:32:00.000Z",
  "tzOffset": "-07:00",
  "type": "unknown",
  "source": "jawbone",
  "duration": 480,
  "distance": 669,
  "steps": 949,
  "calories": 25.2287654541,
  "sourceData": {},
  "createdAt": "2015-03-23T07:03:01.454Z",
  "updatedAt": "2015-03-23T13:36:29.756Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Activities are specific types of physical activities that occur during a period of time with a start time and an end time. These activities are often captured automatically using applications that track motion throughout the day, such as Moves, or they are recorded from applications such as Runkeeper or MapMyRun. They can also be manually entered with applications like Fitbit.

Get Activities

Get a list of activities the user has

GET https://api.humanapi.co/v1/human/activities

Returns a single activity

GET https://api.humanapi.co/v1/human/activities/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The Id of the resource
userId String [deprecated - use humanId]
humanId String Unique user identifier
startTime Date The start time of the activity in UTC time
endTime Date The end time of the activity in UTC time
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
type String The type of activity, such as walking, running, cycling
source String The name of the originating service
duration Number The duration in seconds
distance Number The distance in meters
steps Number The number of steps taken during the activity
calories Number The number of estimated calories burned during the activity
sourceData Object Additional data from the source that does not fit into the Human API model.
timeSeries Object Time series of data such as heart rate, gps location, distance, etc. (see below)

Time Series

Add the query parameter time_series=true to retrieve the time series data if available.

The timeSeries object can have multiple embedded objects. Examples of possible objects include properties such as “heartRate”, “gps”, and “distance”.

The embedded objects have the following properties:

Property Type Description
type String Type of data, indexed with fixed time interval (see intervalInMillis) or timestamped.
intervalInMillis Number If the type is indexed this indicates the number of milliseconds between each value.
values Array[Number or Object] The array of values, single values (indexed) or key-value pairs* (timestamped).

*timestamp represents the number of seconds from startTime.

Activity Summaries

# Get all activity summaries associated with the user
curl "https://api.humanapi.co/v1/human/activities/summaries?access_token=demo"

# Returns a json array of activities summaries:
[{
  "id": "550fe4b68c34cc6661f46f7f",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 722,
  "distance": 1506.71611260169,
  "steps": 0,
  "calories": 118,
  "source": "runkeeper",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 0,
  "sourceData": {},
  "createdAt": "2015-03-23T18:02:29.578Z",
  "updatedAt": "2015-03-23T18:02:29.578Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fb80568d29c4133b5e134",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 108,
  "distance": 171,
  "steps": 207,
  "calories": 12.1920387848,
  "source": "jawbone",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 254,
  "sourceData": {},
  "createdAt": "2015-03-23T06:51:49.355Z",
  "updatedAt": "2015-03-23T17:48:16.610Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "calories": 2720,
  "createdAt": "2015-03-22T01:24:07.212Z",
  "date": "2015-03-22",
  "distance": 9410,
  "duration": 23100,
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "id": "5600adb7d5f967080013c1f0",
  "light": 341,
  "moderate": 3,
  "sedentary": 1055,
  "source": "fitbit",
  "sourceData": {
      "floors": 0,
      "tracker": {
          "calories": 2720,
          "distance": 9409.92,
          "elevation": 0,
          "floors": 0,
          "steps": 12224
      }
  },
  "steps": 12224,
  "updatedAt": "2015-10-30T08:11:23.359Z",
  "userId": "52e20cb2fff56aac62000001",
  "vigorous": 41
  }
]

# Get an activity summary by id
curl "https://api.humanapi.co/v1/human/activities/summaries/550f597085cc310900c73f72?access_token=demo"

# Returns a json object as activity summary:
{
  "id": "550f597085cc310900c73f72",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 0,
  "distance": 0,
  "steps": 0,
  "calories": 0,
  "source": "moves",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 0,
  "sourceData": {},
  "createdAt": "2015-03-23T00:08:16.979Z",
  "updatedAt": "2015-03-23T17:44:05.818Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get all activities summaries associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/activities/summaries?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of activity summaries:
[{
  "id": "550fe4b68c34cc6661f46f7f",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 722,
  "distance": 1506.71611260169,
  "steps": 0,
  "calories": 118,
  "source": "runkeeper",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 0,
  "sourceData": {},
  "createdAt": "2015-03-23T18:02:29.578Z",
  "updatedAt": "2015-03-23T18:02:29.578Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550fb80568d29c4133b5e134",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 108,
  "distance": 171,
  "steps": 207,
  "calories": 12.1920387848,
  "source": "jawbone",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 254,
  "sourceData": {},
  "createdAt": "2015-03-23T06:51:49.355Z",
  "updatedAt": "2015-03-23T17:48:16.610Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "calories": 2720,
  "createdAt": "2015-03-22T01:24:07.212Z",
  "date": "2015-03-22",
  "distance": 9410,
  "duration": 23100,
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "id": "5600adb7d5f967080013c1f0",
  "light": 341,
  "moderate": 3,
  "sedentary": 1055,
  "source": "fitbit",
  "sourceData": {
      "floors": 0,
      "tracker": {
          "calories": 2720,
          "distance": 9409.92,
          "elevation": 0,
          "floors": 0,
          "steps": 12224
      }
  },
  "steps": 12224,
  "updatedAt": "2015-10-30T08:11:23.359Z",
  "userId": "52e20cb2fff56aac62000001",
  "vigorous": 41
}]

// Get an activity summary by id
request
.get('https://api.humanapi.co/v1/human/activities/summaries/550f597085cc310900c73f72?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as activity summary:
{
  "id": "550f597085cc310900c73f72",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "duration": 0,
  "distance": 0,
  "steps": 0,
  "calories": 0,
  "source": "moves",
  "vigorous": 0,
  "moderate": 0,
  "light": 0,
  "sedentary": 0,
  "sourceData": {},
  "createdAt": "2015-03-23T00:08:16.979Z",
  "updatedAt": "2015-03-23T17:44:05.818Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get a list of daily activity summaries reported by the data sources.

Get Activity Summaries

Returns a list of activity summaries

GET https://api.humanapi.co/v1/human/activities/summaries

Returns a single activity summary

GET https://api.humanapi.co/v1/human/activities/summaries/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The Id of the resource
userId String [deprecated - use humanId]
humanId String Unique user identifier
date Date The date of the activity
source String The name of the originating service
duration Number The duration in seconds
distance Number The distance in meters
steps Number The number of steps taken during the activity
vigorous Number The number of minutes of vigorous activity
moderate Number The number of minutes of moderate activity
light Number The number of minutes of light activity
sedentary Number The number of minutes of sedentary activity
calories Number The number of estimated calories burned during the activity
sourceData Object Additional data from the source that does not fit into the Human API model.
createdAt Date The time the activity was created on the Human API server
updatedAt Date The time the activity was updated on the Human API server

Blood Glucose

# Get the latest blood glucose measurement associated with the user
curl "https://api.humanapi.co/v1/human/blood_glucose?access_token=demo"

# Returns a json object of blood glucose:
{
  "id": "54be39e6c3fa43b8057d59fc",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-01-20T12:20:04.000Z",
  "tzOffset": "-07:00",
  "value": 94,
  "unit": "mg/dL",
  "source": "ihealth",
  "sourceData": {},
  "createdAt": "2015-03-16T23:48:43.696Z",
  "updatedAt": "2015-03-16T23:48:43.696Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get latest blood glucose associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/blood_glucose?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of blood glucose:
{
  "id": "54be39e6c3fa43b8057d59fc",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-01-20T12:20:04.000Z",
  "tzOffset": "-07:00",
  "value": 94,
  "unit": "mg/dL",
  "source": "ihealth",
  "sourceData": {},
  "createdAt": "2015-03-16T23:48:43.696Z",
  "updatedAt": "2015-03-16T23:48:43.696Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the blood glucose measurement from a specific point in time.

Get Blood Glucose

Returns the latest blood glucose reading

GET https://api.humanapi.co/v1/human/blood_glucose

Returns all blood glucose readings

GET https://api.humanapi.co/v1/human/blood_glucose/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the blood glucose reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
notes String User created notes
mealTag String Indication if value was captured before/after a meal
medicationTag String Indication if value was captured before/after taking medication
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Blood Oxygen

# Get latest blood oxygen measurement associated with the user
curl "https://api.humanapi.co/v1/human/blood_oxygen?access_token=demo"

# Returns a json object of blood oxygen:
{
  "id": "54d1f018810a5ba429951b07",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-01-26T06:58:37.000Z",
  "tzOffset": "-07:00",
  "value": 99,
  "unit": "SpO2(%)",
  "source": "withings",
  "sourceData": {},
  "createdAt": "2015-02-04T10:10:32.691Z",
  "updatedAt": "2015-02-04T10:10:32.691Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get latest blood oxygen associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/blood_oxygen?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of blood oxygen:
{
  "id": "54d1f018810a5ba429951b07",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-01-26T06:58:37.000Z",
  "tzOffset": "-07:00",
  "value": 99,
  "unit": "SpO2(%)",
  "source": "withings",
  "sourceData": {},
  "createdAt": "2015-02-04T10:10:32.691Z",
  "updatedAt": "2015-02-04T10:10:32.691Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the blood oxygen measurement from a specific point in time.

Get Blood Oxygen

Returns the latest blood oxygen reading

GET https://api.humanapi.co/v1/human/blood_oxygen

Returns all blood oxygen readings

GET https://api.humanapi.co/v1/human/blood_oxygen/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the blood oxygen reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Blood Pressure

# Get the latest blood pressure measurement associated with the user
curl "https://api.humanapi.co/v1/human/blood_pressure?access_token=demo"

# Returns a json object of blood pressure:
{
  "id": "550b8a8e834dd16f259683b1",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-19T22:48:26.000Z",
  "tzOffset": "-07:00",
  "systolic": 117,
  "diastolic": 76,
  "unit": "mmHg",
  "heartRate": 66,
  "source": "ihealth",
  "createdAt": "2015-03-20T02:48:46.925Z",
  "updatedAt": "2015-03-20T02:48:46.925Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get latest blood pressure associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/blood_pressure?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of blood pressure:
{
  "id": "550b8a8e834dd16f259683b1",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-19T22:48:26.000Z",
  "tzOffset": "-07:00",
  "systolic": 117,
  "diastolic": 76,
  "unit": "mmHg",
  "heartRate": 66,
  "source": "ihealth",
  "createdAt": "2015-03-20T02:48:46.925Z",
  "updatedAt": "2015-03-20T02:48:46.925Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the blood pressure measurement from a specific point in time.

Get Blood Pressure

Returns the latest blood pressure reading

GET https://api.humanapi.co/v1/human/blood_pressure

Returns all blood pressure readings

GET https://api.humanapi.co/v1/human/blood_pressure/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the blood pressure reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
unit String The unit of the measurement value
heartRate String The heart rate in BPM captured at the time of measurement
systolic String The systolic value captured at the time of measurement
diastolic String The diastolic value captured at the time of measurement
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Body Mass Index (BMI)

# Get latest bmi measurement associated with the user
curl "https://api.humanapi.co/v1/human/bmi?access_token=demo"

# Returns a json object of bmi:
{
  "id": "5506f5080ba9b35f0af6cc89",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-16T23:59:59.000Z",
  "tzOffset": "-07:00",
  "value": 30.26,
  "unit": "kg/m2",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-16T15:21:44.304Z",
  "updatedAt": "2015-03-16T15:24:48.492Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get latest bmi associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/bmi?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of bmi:
{
  "id": "5506f5080ba9b35f0af6cc89",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-16T23:59:59.000Z",
  "tzOffset": "-07:00",
  "value": 30.26,
  "unit": "kg/m2",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-16T15:21:44.304Z",
  "updatedAt": "2015-03-16T15:24:48.492Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the bmi measurement from a specific point in time.

Get BMI

Returns the latest bmi reading

GET https://api.humanapi.co/v1/human/bmi

Returns all bmi readings

GET https://api.humanapi.co/v1/human/bmi/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the bmi reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Body Fat

# Get the latest body fat measurement associated with the user
curl "https://api.humanapi.co/v1/human/body_fat?access_token=demo"

# Returns a json object of body fat:
{
  "id": "54ed75ccd9f8e13b13eaf17f",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-02-25T07:09:52.000Z",
  "tzOffset": "-07:00",
  "value": 18.695,
  "unit": "percent",
  "source": "withings",
  "sourceData": {},
  "createdAt": "2015-02-26T05:21:01.021Z",
  "updatedAt": "2015-02-26T05:21:01.021Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get the latest body fat associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/body_fat?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of body fat:
{
  "id": "54ed75ccd9f8e13b13eaf17f",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-02-25T07:09:52.000Z",
  "tzOffset": "-07:00",
  "value": 18.695,
  "unit": "percent",
  "source": "withings",
  "sourceData": {},
  "createdAt": "2015-02-26T05:21:01.021Z",
  "updatedAt": "2015-02-26T05:21:01.021Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the body fat measurement from a specific point in time.

Get Body Fat

Returns a body fat reading

GET https://api.humanapi.co/v1/human/body_fat

Returns all body fat readings

GET https://api.humanapi.co/v1/human/body_fat/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the bmi reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Genetic Traits

# Get genetic traits associated with the user
curl "https://api.humanapi.co/v1/human/genetic/traits?access_token=demo"

# Returns a JSON array of genetic traits:
[{
  "userId": "52e20cb2fff56aac62000001",
  "description": "Hair Curl",
  "trait": "Straighter Hair on Average",
  "possibleTraits": ["Slightly Curlier Hair on Average", "Straighter Hair on Average"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "userId": "52e20cb2fff56aac62000001",
  "description": "Male Pattern Baldness",
  "trait": "Decreased Odds",
  "possibleTraits": ["Decreased Odds", "Increased Odds", "No Data", "Not Applicable", "Typical Odds"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "userId": "52e20cb2fff56aac62000001",
  "description": "Smoking Behavior",
  "trait": "Typical",
  "possibleTraits": ["If a Smoker, Likely to Smoke More", "Typical"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]
// Get all genetic traits associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/genetic/traits?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of genetic traits:
[{
  "userId": "52e20cb2fff56aac62000001",
  "description": "Hair Curl",
  "trait": "Straighter Hair on Average",
  "possibleTraits": ["Slightly Curlier Hair on Average", "Straighter Hair on Average"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "userId": "52e20cb2fff56aac62000001",
  "description": "Male Pattern Baldness",
  "trait": "Decreased Odds",
  "possibleTraits": ["Decreased Odds", "Increased Odds", "No Data", "Not Applicable", "Typical Odds"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "userId": "52e20cb2fff56aac62000001",
  "description": "Smoking Behavior",
  "trait": "Typical",
  "possibleTraits": ["If a Smoker, Likely to Smoke More", "Typical"],
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

Get genetic traits of a user

Get Genetic Traits

Returns genetic traits

GET https://api.humanapi.co/v1/human/genetic/traits

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
userId String [deprecated - use humanId]
humanId String Unique user identifier
trait Date The most likely present trait
possibleTraits String A list of all the possible values for a specific trait, for easy comparison
description Number A description/name of the trait

Genotypes

# Get specific genotypes associated with the user
curl "https://api.humanapi.co/v1/human/genetic/genotypes?access_token=demo&locations=rs3094315%20i3000001"

# Returns a json object of genotypes:
{
    "id": "c4480ba411939067",
    "genotypes": [
        {
            "location": "i3000001",
            "call": "II"
        },
        {
            "location": "rs3094315",
            "call": "AA"
        }
    ]
}

// Get specific genotypes associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/genetic/genotypes?access_token=demo&locations=rs3094315%20i3000001')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of genotypes:
{
    "id": "c4480ba411939067",
    "genotypes": [
        {
            "location": "i3000001",
            "call": "II"
        },
        {
            "location": "rs3094315",
            "call": "AA"
        }
    ]
}

Returns the base-pairs, like AA, for the given locations. The value can have Ds or Is for deletions and insertions (for example, DD or DI). It can be __ if the user is not on a chip that calls that location, or hasn’t yet unlocked their call since it corresponds to a sensitive report. It can be -- if the user is on a chip that calls that location, but it could not be determined. Hemizygous calls (such as on X-linked genes in males) will also return two base pairs.

Finally, due to locations and the fixed nature of genetic information, this endpoint cannot be queried by batch, nor can it be filtered by standard query parameters.

Get Genotypes

Returns a list of requested genotypes

GET https://api.humanapi.co/v1/human/genetic/genotypes

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication
locations Locations (SNPs) to request (see below)

Note: This endpoint requires the `locations` query Parameter.


This list of SNPs (31MB) shows which SNPs are available. When requesting multiple locations, you will need to separate each location with a space (represented by `%20` in an encoded URI). We recommend querying no more than 60 locations per request.

Response properties

Property Type Description
id String Source profile ID
genotypes Array[Object] An array of genotype objects (see below).

Genotypes Object

Property Type Description
location String Location of the genotype
call String Call of the genotype (see description above)

Heart Rate

# Get the latest heart rate measurement associated with the user
curl "https://api.humanapi.co/v1/human/heart_rate?access_token=demo"

# Returns a json object of heart rate:
{
  "id": "550b8a8e834dd16f259683b2",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-19T22:48:26.000Z",
  "tzOffset": "-07:00",
  "value": 66,
  "unit": "bpm",
  "source": "ihealth",
  "sourceData": {},
  "createdAt": "2015-03-20T02:48:46.945Z",
  "updatedAt": "2015-03-20T02:48:46.945Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get the latest heart rate associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/heart_rate?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of heart rate:
{
  "id": "550b8a8e834dd16f259683b2",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-19T22:48:26.000Z",
  "tzOffset": "-07:00",
  "value": 66,
  "unit": "bpm",
  "source": "ihealth",
  "sourceData": {},
  "createdAt": "2015-03-20T02:48:46.945Z",
  "updatedAt": "2015-03-20T02:48:46.945Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the heart rate measurement from a specific point in time.

Get Heart Rate

Returns a heart rate reading

GET https://api.humanapi.co/v1/human/heart_rate

Returns all heart rate readings

GET https://api.humanapi.co/v1/human/heart_rate/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the bmi reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Height

# Get the latest height measurement associated with the user
curl "https://api.humanapi.co/v1/human/height?access_token=demo"

# Returns a json object of height:
{
  "id": "5509b45bb384e1620a5933c5",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-18T00:00:00.000Z",
  "tzOffset": "-07:00",
  "value": 1753,
  "unit": "mm",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-18T17:22:35.859Z",
  "updatedAt": "2015-03-18T17:22:35.859Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get the latest height associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/height?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of height:
{
  "id": "5509b45bb384e1620a5933c5",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-18T00:00:00.000Z",
  "tzOffset": "-07:00",
  "value": 1753,
  "unit": "mm",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-18T17:22:35.859Z",
  "updatedAt": "2015-03-18T17:22:35.859Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the height measurement from a specific point in time.

Get Height

Returns a height reading

GET https://api.humanapi.co/v1/human/height

Returns all height readings

GET https://api.humanapi.co/v1/human/height/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the bmi reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Human (Summary)

# Get user's health summary
curl "https://api.humanapi.co/v1/human?access_token=demo"

# Returns a json object:
{
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "userId": "52e20cb2fff56aac62000001",
  "createdAt": "2014-01-24T06:48:18.361Z",
  "bloodGlucose": {
    "id": "54be39e6c3fa43b8057d59fc",
    "timestamp": "2015-01-20T12:20:04.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "value": 94,
    "unit": "mg/dL"
  },
  "bloodOxygen": {
    "id": "54d1f018810a5ba429951b07",
    "timestamp": "2015-01-26T06:58:37.000Z",
    "tzOffset": "-07:00",
    "source": "withings",
    "value": 99,
    "unit": "SpO2"
  },
  "bloodPressure": {
    "id": "550b8a8e834dd16f259683b1",
    "userId": "52e20cb2fff56aac62000001",
    "timestamp": "2015-03-19T22:48:26.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "systolic": 117,
    "diastolic": 76,
    "unit": "mmHg",
    "heartRate": 66
  },
  "bmi": {
    "id": "5506f5080ba9b35f0af6cc89",
    "timestamp": "2015-03-16T23:59:59.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 30.26,
    "unit": "kg/m2"
  },
  "bodyFat": {
    "id": "54ed75ccd9f8e13b13eaf17f",
    "timestamp": "2015-02-25T07:09:52.000Z",
    "tzOffset": "-07:00",
    "source": "withings",
    "value": 18.695,
    "unit": "%"
  },
  "height": {
    "id": "5509b45bb384e1620a5933c5",
    "timestamp": "2015-03-18T00:00:00.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 1753,
    "unit": "mm"
  },
  "heartRate": {
    "id": "550b8a8e834dd16f259683b2",
    "timestamp": "2015-03-19T22:48:26.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "value": 66,
    "unit": "bpm"
  },
  "weight": {
    "id": "5506f5080ba9b35f0af6cc8a",
    "timestamp": "2015-03-16T23:59:59.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 92.9,
    "unit": "kg"
  },
  "activitySummary": {
    "id": "53adbf5dbef3fe0d24a1d453",
    "date": "2014-06-27",
    "duration": 1468.137,
    "distance": 3043.21010200387,
    "sedentary": 0,
    "light": 0,
    "moderate": 0,
    "vigorous": 0,
    "total": 1468.137,
    "steps": 0,
    "calories": 241,
    "source": "runkeeper"
  },
  "sleepSummary": {
    "id": "540e96b74247c3ea71d671b9",
    "userId": "52e20cb2fff56aac62000001",
    "date": "2014-09-09",
    "source": "fitbit",
    "timeAsleep": 456,
    "timeAwake": 0,
    "updatedAt": "2014-09-11T02:28:27.377Z"
  }
}
// Get user's health summary
var request = require('request');
request
.get('https://api.humanapi.co/v1/human?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object:
{
  "userId": "52e20cb2fff56aac62000001",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6",
  "createdAt": "2014-01-24T06:48:18.361Z",
  "bloodGlucose": {
    "id": "54be39e6c3fa43b8057d59fc",
    "timestamp": "2015-01-20T12:20:04.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "value": 94,
    "unit": "mg/dL"
  },
  "bloodOxygen": {
    "id": "54d1f018810a5ba429951b07",
    "timestamp": "2015-01-26T06:58:37.000Z",
    "tzOffset": "-07:00",
    "source": "withings",
    "value": 99,
    "unit": "SpO2"
  },
  "bloodPressure": {
    "id": "550b8a8e834dd16f259683b1",
    "userId": "52e20cb2fff56aac62000001",
    "timestamp": "2015-03-19T22:48:26.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "systolic": 117,
    "diastolic": 76,
    "unit": "mmHg",
    "heartRate": 66
  },
  "bmi": {
    "id": "5506f5080ba9b35f0af6cc89",
    "timestamp": "2015-03-16T23:59:59.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 30.26,
    "unit": "kg/m2"
  },
  "bodyFat": {
    "id": "54ed75ccd9f8e13b13eaf17f",
    "timestamp": "2015-02-25T07:09:52.000Z",
    "tzOffset": "-07:00",
    "source": "withings",
    "value": 18.695,
    "unit": "%"
  },
  "height": {
    "id": "5509b45bb384e1620a5933c5",
    "timestamp": "2015-03-18T00:00:00.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 1753,
    "unit": "mm"
  },
  "heartRate": {
    "id": "550b8a8e834dd16f259683b2",
    "timestamp": "2015-03-19T22:48:26.000Z",
    "tzOffset": "-07:00",
    "source": "ihealth",
    "value": 66,
    "unit": "bpm"
  },
  "weight": {
    "id": "5506f5080ba9b35f0af6cc8a",
    "timestamp": "2015-03-16T23:59:59.000Z",
    "tzOffset": "-07:00",
    "source": "fitbit",
    "value": 92.9,
    "unit": "kg"
  },
  "activitySummary": {
    "id": "53adbf5dbef3fe0d24a1d453",
    "date": "2014-06-27",
    "duration": 1468.137,
    "distance": 3043.21010200387,
    "sedentary": 0,
    "light": 0,
    "moderate": 0,
    "vigorous": 0,
    "total": 1468.137,
    "steps": 0,
    "calories": 241,
    "source": "runkeeper"
  },
  "sleepSummary": {
    "id": "540e96b74247c3ea71d671b9",
    "userId": "52e20cb2fff56aac62000001",
    "date": "2014-09-09",
    "source": "fitbit",
    "timeAsleep": 456,
    "timeAwake": 0,
    "updatedAt": "2014-09-11T02:28:27.377Z"
  }
}

Get summary object for a person’s latest health metrics. The data consists of all the discrete health measurements and summary information about the person’s activity and sleep data.

Get Human Summary

Returns the human profile

GET https://api.humanapi.co/v1/human

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
userId String [deprecated - use humanId]
humanId String Unique user identifier
bloodGlucose BloodGlucose The latest blood glucose measurement
bloodPressure BloodPressure The latest blood pressure measurement
bmi BMI The latest body mass index measurement
bodyFat BodyFat The latest body fat percentage measurement
height Height The latest height measurement
heartRate HeartRate The latest heart rate measurement
weight Weight The latest weight measurement
activitySummary ActivitySummary The latest activity summary
sleepSummary SleepSummary The latest sleep summary

Locations

# Get locations measurement associated with the user
curl "https://api.humanapi.co/v1/human/locations?access_token=demo"

# Returns a json array of locations:
[{
  "id": "54aa4c5623e093b72ba122ec",
  "userId": "52e20cb2fff56aac62020001",
  "startTime": "2015-03-23T16:48:37.000Z",
  "endTime": "2015-03-23T17:15:40.000Z",
  "tzOffset": "-07:00",
  "name": "",
  "source": "moves",
  "location": {
    "lon": 77.3092283085,
    "lat": 28.5941775291
  },
  "createdAt": "2015-02-06T21:21:13.679Z",
  "updatedAt": "2015-02-06T21:21:13.679Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "54c8681d94ae47d0702e8624",
  "userId": "52e20cb2aaf56aac62000001",
  "startTime": "2015-03-23T02:04:02.000Z",
  "endTime": "2015-03-23T03:38:26.000Z",
  "tzOffset": "-07:00",
  "name": "Walmart",
  "source": "moves",
  "location": {
    "lon": -87.06979948824468,
    "lat": 20.63034803007769
  },
  "createdAt": "2015-01-31T22:32:58.332Z",
  "updatedAt": "2015-01-31T22:32:58.332Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]
// Get all locations associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/locations?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of locations:
[{
  "id": "54aa4c5623e093b72ba122ec",
  "userId": "52e20cb2fff56aac62020001",
  "startTime": "2015-03-23T16:48:37.000Z",
  "tzOffset": "-07:00",
  "endTime": "2015-03-23T17:15:40.000Z",
  "name": "",
  "source": "moves",
  "location": {
    "lon": 77.3092283085,
    "lat": 28.5941775291
  },
  "createdAt": "2015-02-06T21:21:13.679Z",
  "updatedAt": "2015-02-06T21:21:13.679Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "54c8681d94ae47d0702e8624",
  "userId": "52e20cb2aaf56aac62000001",
  "startTime": "2015-03-23T02:04:02.000Z",
  "endTime": "2015-03-23T03:38:26.000Z",
  "tzOffset": "-07:00",
  "name": "Walmart",
  "source": "moves",
  "location": {
    "lon": -87.06979948824468,
    "lat": 20.63034803007769
  },
  "createdAt": "2015-01-31T22:32:58.332Z",
  "updatedAt": "2015-01-31T22:32:58.332Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

Get the user’s location at a specific point in time.

Get Locations

Returns a locations readings

GET https://api.humanapi.co/v1/human/locations

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the location reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
startTime Date The start time of the activity in UTC time
endTime Date The end time of the activity in UTC time
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
name String The name of the place
source String The source service for the measurement, where it was created
location Object The coordinate point with a lat/lon value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Location Object

Property Type Description
lon Number Longitude
lat Number Latitude

Meals

# Get all meals associated with the user
curl "https://api.humanapi.co/v1/human/food/meals?access_token=demo"

OR

curl "https://api.humanapi.co/v1/human/food/meals?access_token=demo&updated_since=20140110T000000Z"

# Returns a json array of meals:
[{
  "id": "5508205f6101270148721599",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-17T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "Apfelstückchen mit Banane",
  "calories": 124,
  "carbohydrate": 26.6000003815,
  "fat": 0.600000023842,
  "protein": 1.60000002384,
  "sodium": 0,
  "sugar": 0,
  "calcium": 0,
  "cholesterol": 0,
  "fiber": 3,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 0,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-17T12:38:55.712Z",
  "updatedAt": "2015-03-17T12:38:55.712Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "54fe0ad40f701cf4630be975",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-04T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "3 Cereais e Leite",
  "calories": 633.999984741,
  "carbohydrate": 75.9680023193,
  "fat": 22.6160001755,
  "protein": 32.4159994125,
  "sodium": 723.199981689,
  "sugar": 40.2880020142,
  "calcium": 896,
  "cholesterol": 54.4000015259,
  "fiber": 3.07999992371,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 11.1679999828,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-09T21:04:20.973Z",
  "updatedAt": "2015-03-09T21:04:20.973Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

# Get an meal by id
curl "https://api.humanapi.co/v1/human/food/meals/54fe0ad40f701cf4630be975?access_token=demo"
{
  "id": "54fe0ad40f701cf4630be975",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-04T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "3 Cereais e Leite",
  "calories": 633.999984741,
  "carbohydrate": 75.9680023193,
  "fat": 22.6160001755,
  "protein": 32.4159994125,
  "sodium": 723.199981689,
  "sugar": 40.2880020142,
  "calcium": 896,
  "cholesterol": 54.4000015259,
  "fiber": 3.07999992371,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 11.1679999828,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-09T21:04:20.973Z",
  "updatedAt": "2015-03-09T21:04:20.973Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

// Get all meals associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/food/meals?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

OR

request
.get('https://api.humanapi.co/v1/human/food/meals?access_token=demo&updated_since=20140110T000000Z')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of meals:
[{
  "id": "5508205f6101270148721599",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-17T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "Apfelstückchen mit Banane",
  "calories": 124,
  "carbohydrate": 26.6000003815,
  "fat": 0.600000023842,
  "protein": 1.60000002384,
  "sodium": 0,
  "sugar": 0,
  "calcium": 0,
  "cholesterol": 0,
  "fiber": 3,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 0,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-17T12:38:55.712Z",
  "updatedAt": "2015-03-17T12:38:55.712Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "54fe0ad40f701cf4630be975",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-04T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "3 Cereais e Leite",
  "calories": 633.999984741,
  "carbohydrate": 75.9680023193,
  "fat": 22.6160001755,
  "protein": 32.4159994125,
  "sodium": 723.199981689,
  "sugar": 40.2880020142,
  "calcium": 896,
  "cholesterol": 54.4000015259,
  "fiber": 3.07999992371,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 11.1679999828,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-09T21:04:20.973Z",
  "updatedAt": "2015-03-09T21:04:20.973Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

// Get an meal by id
request
.get('https://api.humanapi.co/v1/human/food/meals/54fe0ad40f701cf4630be975?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as meal:
{
  "id": "54fe0ad40f701cf4630be975",
  "userId": "52e20cb2fff56aac62000001",
  "source": "jawbone",
  "timestamp": "2015-03-04T00:00:00.000Z",
  "tzOffset": "-07:00",
  "type": "lunch",
  "name": "3 Cereais e Leite",
  "calories": 633.999984741,
  "carbohydrate": 75.9680023193,
  "fat": 22.6160001755,
  "protein": 32.4159994125,
  "sodium": 723.199981689,
  "sugar": 40.2880020142,
  "calcium": 896,
  "cholesterol": 54.4000015259,
  "fiber": 3.07999992371,
  "iron": 0,
  "monounsaturatedFat": 0,
  "polyunsaturatedFat": 0,
  "potassium": 0,
  "saturatedFat": 11.1679999828,
  "vitaminA": 0,
  "vitaminC": 0,
  "createdAt": "2015-03-09T21:04:20.973Z",
  "updatedAt": "2015-03-09T21:04:20.973Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

The Meals resource contains detailed data about nutrition consumed by the human separated by date and type: breakfast/lunch/dinner/other.

Get Meals

Get a list of meals the user has

GET https://api.humanapi.co/v1/human/food/meals

Returns a single meal

GET https://api.humanapi.co/v1/human/food/meals/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Returns a list of meals updated since a given time

GET https://api.humanapi.co/v1/human/food/meals

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication
updated_since Date in YYYYMMDDTHHmmssZ format

Response properties

Property Units Type Description
id String The id of the meal object
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date of the meal
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the meal data
type String Type of the meal: breakfast/lunch/dinner/other
name String Descriptive name of the meal
calories kcal Number The amount of consumed calories
carbohydrate g Number The amount of consumed carbohydrate
fat g Number The amount of consumed fat
protein g Number The amount of consumed protein
sodium mg Number The amount of consumed sodium
sugar g Number The amount of consumed sugar
fiber g Number The amount of consumed fiber (optional)
saturatedFat g Number The amount of consumed saturated fat (optional)
monounsaturatedFat g Number The amount of consumed monounsaturated fat (optional)
polyunsaturatedFat g Number The amount of consumed polyunsaturated fat (optional)
cholesterol mg Number The amount of consumed cholesterol (optional)
vitaminA mg Number The amount of consumed vitamin A (optional)
vitaminC mg Number The amount of consumed vitamin C (optional)
calcium mg Number The amount of consumed calcium (optional)
iron mg Number The amount of consumed iron (optional)
potassium mg Number The amount of consumed potassium (optional)
amount Object Amount of a food type (See below) (optional)
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Amount Object

Property Type Description
value Number Quantity
unit String Unit of measure

Profile

# Get user's health profile
curl "https://api.humanapi.co/v1/human/profile?access_token=demo"

# Returns a json object:
{
  "userId": "52e20cb2fff56aac62000001",
  "createdAt": "2014-01-24T06:48:18.361Z",
  "email": "demo@humanapi.co",
  "defaultTimeZone": {
    "name": "UTC"
  },
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get user's health profile
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/profile?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object:
{
  "userId": "52e20cb2fff56aac62000001",
  "createdAt": "2014-01-24T06:48:18.361Z",
  "email": "demo@humanapi.co",
  "defaultTimeZone": {
    "name": "UTC"
  },
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

The Profile resource contains reference attributes that are convenient when you link a local app user from your application with a Human API user.

Get Human Profile

Returns the human profile

GET https://api.humanapi.co/v1/human/profile

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
userId String [deprecated - use humanId]
humanId String Unique user identifier
email String The user’s email address, if known
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Sleeps

# Get all sleeps associated with the user
curl "https://api.humanapi.co/v1/human/sleeps?access_token=demo"

# Returns a json array of sleeps:
[{
  "id": "551058f168d29c4133c4d1f4",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-23",
  "startTime": "2015-03-23T02:50:27.000Z",
  "endTime": "2015-03-23T09:21:54.000Z",
  "tzOffset": "-07:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 362,
  "timeAwake": 28,
  "efficiency": 57,
  "timeToFallAsleep": 12,
  "timeAfterWakeup": 0,
  "timeInBed": 391,
  "createdAt": "2015-03-23T18:18:25.687Z",
  "updatedAt": "2015-03-23T18:18:25.687Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550facab68d29c4133b4cf18",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-23",
  "startTime": "2015-03-22T23:07:33.000Z",
  "endTime": "2015-03-23T06:54:35.000Z",
  "tzOffset": "+01:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 442,
  "timeAwake": 24,
  "efficiency": 80,
  "timeToFallAsleep": 4,
  "timeAfterWakeup": 0,
  "timeInBed": 467,
  "createdAt": "2015-03-23T06:03:23.091Z",
  "updatedAt": "2015-03-23T06:03:23.091Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550f8daf68d29c4133b122b5",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-22",
  "startTime": "2015-03-22T04:06:58.000Z",
  "endTime": "2015-03-22T13:36:10.000Z",
  "tzOffset": "-04:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 377,
  "timeAwake": 180,
  "efficiency": 68,
  "timeToFallAsleep": 16,
  "timeAfterWakeup": 0,
  "timeInBed": 569,
  "createdAt": "2015-03-23T03:51:11.219Z",
  "updatedAt": "2015-03-23T03:51:11.219Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

# Get an sleep by id
curl "https://api.humanapi.co/v1/human/sleeps/550f8daf68d29c4133b122b5?access_token=demo"

# Returns a json object as sleep:
{
  "id": "550f8daf68d29c4133b122b5",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-22",
  "startTime": "2015-03-22T04:06:58.000Z",
  "endTime": "2015-03-22T13:36:10.000Z",
  "tzOffset": "-04:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 377,
  "timeAwake": 180,
  "efficiency": 68,
  "timeToFallAsleep": 16,
  "timeAfterWakeup": 0,
  "timeInBed": 569,
  "createdAt": "2015-03-23T03:51:11.219Z",
  "updatedAt": "2015-03-23T03:51:11.219Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

// Get all sleeps associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/sleeps?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of sleeps:
[{
  "id": "551058f168d29c4133c4d1f4",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-23",
  "startTime": "2015-03-23T02:50:27.000Z",
  "endTime": "2015-03-23T09:21:54.000Z",
  "tzOffset": "-07:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 362,
  "timeAwake": 28,
  "efficiency": 57,
  "timeToFallAsleep": 12,
  "timeAfterWakeup": 0,
  "timeInBed": 391,
  "createdAt": "2015-03-23T18:18:25.687Z",
  "updatedAt": "2015-03-23T18:18:25.687Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550facab68d29c4133b4cf18",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-23",
  "startTime": "2015-03-22T23:07:33.000Z",
  "endTime": "2015-03-23T06:54:35.000Z",
  "tzOffset": "+01:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 442,
  "timeAwake": 24,
  "efficiency": 80,
  "timeToFallAsleep": 4,
  "timeAfterWakeup": 0,
  "timeInBed": 467,
  "createdAt": "2015-03-23T06:03:23.091Z",
  "updatedAt": "2015-03-23T06:03:23.091Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550f8daf68d29c4133b122b5",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-22",
  "startTime": "2015-03-22T04:06:58.000Z",
  "endTime": "2015-03-22T13:36:10.000Z",
  "tzOffset": "-04:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 377,
  "timeAwake": 180,
  "efficiency": 68,
  "timeToFallAsleep": 16,
  "timeAfterWakeup": 0,
  "timeInBed": 569,
  "createdAt": "2015-03-23T03:51:11.219Z",
  "updatedAt": "2015-03-23T03:51:11.219Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

// Get an sleep by id
request
.get('https://api.humanapi.co/v1/human/sleeps/550f8daf68d29c4133b122b5?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as sleep:
{
  "id": "550f8daf68d29c4133b122b5",
  "userId": "52e20cb2fff56aac62000001",
  "day": "2015-03-22",
  "startTime": "2015-03-22T04:06:58.000Z",
  "endTime": "2015-03-22T13:36:10.000Z",
  "tzOffset": "-04:00",
  "source": "jawbone",
  "mainSleep": true,
  "timeAsleep": 377,
  "timeAwake": 180,
  "efficiency": 68,
  "timeToFallAsleep": 16,
  "timeAfterWakeup": 0,
  "timeInBed": 569,
  "createdAt": "2015-03-23T03:51:11.219Z",
  "updatedAt": "2015-03-23T03:51:11.219Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Sleep resources are segments of sleep that occur during a specific period of time.

Get Sleeps

Get a list of sleeps the user has

GET https://api.humanapi.co/v1/human/sleeps

Returns a single sleep

GET https://api.humanapi.co/v1/human/sleeps/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the sleep measurement
userId String [deprecated - use humanId]
humanId String Unique user identifier
day Date The day the sleep was recorded
startTime Date The original start date and time of the sleep segment in UTC time
endTime Date The original end date and time of the sleep segment in UTC time
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
mainSleep Boolean A boolean value indicating if this sleep was the main sleep of the day (default true when not specified by source)
timeAsleep Number The time asleep during the segment (in minutes)
timeAwake Number The time awake during the segment (in minutes)
efficiency Number The efficiency score
timeToFallAsleep Number The number of minutes it took to fall asleep
timeAfterWakeup Number The number of minutes in bed after waking up
timeInBed Number The total number of minutes spend in bed
numberOfWakeups Number The number of times the user woke up while in bed
createdAt Date The time the sleep was created on the Human API server
updatedAt Date The time the sleep was updated on the Human API server
timeSeries Object Time series data for the sleep, such as quality (see below)

Time Series

Add the query parameter time_series=true to retrieve the time series data if available.

The timeSeries object can have multiple embedded objects. In the example below there is one object called “quality”, some services might provide other properties such as “heartRate” or “breathing” etc.

The embedded objects have the following properties:

Property Description
type Type of data, indexed with fixed time interval (See intervalInMillis) or timestamped.
intervalInMillis If the type is indexed this indicates the number of milliseconds between each value.
values The array of values, single values (indexed) or key-value pairs* (timestamped).

*timestamp represents the number of seconds from startTime.

Standard Series

Some series have standardized values across sources. Standard series are listed below.

Series Values
state 0: wide awake, 1: awake, 2: light sleep, 3: regular sleep, 4: deep sleep, 5: REM sleep

Sleep Summaries

# Get all sleep summaries associated with the user
curl "https://api.humanapi.co/v1/human/sleeps/summaries?access_token=demo"

# Returns a json array of sleeps summaries:
[{
  "id": "550facab68d29c4133b4cf22",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "source": "jawbone",
  "timeAsleep": 391.45,
  "timeAwake": 28,
  "createdAt": "2015-03-23T06:03:23.141Z",
  "updatedAt": "2015-03-23T18:18:25.678Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550e92b25ee14de827d16689",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-22",
  "source": "jawbone",
  "timeAsleep": 443.6,
  "timeAwake": 23,
  "createdAt": "2015-03-22T10:00:18.804Z",
  "updatedAt": "2015-03-23T15:05:28.591Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550d599c47be23e06c83bbde",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-21",
  "source": "jawbone",
  "timeAsleep": 412.5,
  "timeAwake": 96,
  "createdAt": "2015-03-21T11:44:28.969Z",
  "updatedAt": "2015-03-23T15:05:28.599Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

# Get an sleep summary by id
curl "https://api.humanapi.co/v1/human/sleeps/summaries/550d599c47be23e06c83bbde?access_token=demo"

# Returns a json object as sleep summary:
{
  "id": "550d599c47be23e06c83bbde",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-21",
  "source": "jawbone",
  "timeAsleep": 412.5,
  "timeAwake": 96,
  "createdAt": "2015-03-21T11:44:28.969Z",
  "updatedAt": "2015-03-23T15:05:28.599Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get all sleep summaries associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/sleeps/summaries?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json array of sleeps summaries:
[{
  "id": "550facab68d29c4133b4cf22",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-23",
  "source": "jawbone",
  "timeAsleep": 391.45,
  "timeAwake": 28,
  "createdAt": "2015-03-23T06:03:23.141Z",
  "updatedAt": "2015-03-23T18:18:25.678Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550e92b25ee14de827d16689",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-22",
  "source": "jawbone",
  "timeAsleep": 443.6,
  "timeAwake": 23,
  "createdAt": "2015-03-22T10:00:18.804Z",
  "updatedAt": "2015-03-23T15:05:28.591Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}, {
  "id": "550d599c47be23e06c83bbde",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-21",
  "source": "jawbone",
  "timeAsleep": 412.5,
  "timeAwake": 96,
  "createdAt": "2015-03-21T11:44:28.969Z",
  "updatedAt": "2015-03-23T15:05:28.599Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}]

// Get an sleep summary by id
request
.get('https://api.humanapi.co/v1/human/sleeps/summaries/550d599c47be23e06c83bbde?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object as sleep summary:
{
  "id": "550d599c47be23e06c83bbde",
  "userId": "52e20cb2fff56aac62000001",
  "date": "2015-03-21",
  "source": "jawbone",
  "timeAsleep": 412.5,
  "timeAwake": 96,
  "createdAt": "2015-03-21T11:44:28.969Z",
  "updatedAt": "2015-03-23T15:05:28.599Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get a list of daily sleep summaries reported by the data sources.

Get Sleep Summaries

Returns a list of sleep summaries

GET https://api.humanapi.co/v1/human/sleeps/summaries

Returns a single sleep summary

GET https://api.humanapi.co/v1/human/sleeps/summaries/{id}

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The Id of the resource
userId String [deprecated - use humanId]
humanId String Unique user identifier
date Date The date of the sleep
source String The name of the originating service
timeAsleep Number The time asleep during the segment (in minutes)
timeAwake Number The time awake during the segment (in minutes)
createdAt Date The time the sleep was created on the Human API server
updatedAt Date The time the sleep was updated on the Human API server

Weight

# Get the latest weight measurement associated with the user
curl "https://api.humanapi.co/v1/human/weight?access_token=demo"

# Returns a json object of weight:
{
  "id": "5506f5080ba9b35f0af6cc8a",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-16T23:59:59.000Z",
  "tzOffset": "-07:00",
  "value": 92.9,
  "unit": "kg",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-16T15:21:44.289Z",
  "updatedAt": "2015-03-16T15:24:48.475Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}
// Get the latest weight associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/weight?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of weight:
{
  "id": "5506f5080ba9b35f0af6cc8a",
  "userId": "52e20cb2fff56aac62000001",
  "timestamp": "2015-03-16T23:59:59.000Z",
  "tzOffset": "-07:00",
  "value": 92.9,
  "unit": "kg",
  "source": "fitbit",
  "sourceData": {},
  "createdAt": "2015-03-16T15:21:44.289Z",
  "updatedAt": "2015-03-16T15:24:48.475Z",
  "humanId": "5dc2527186aaf9de560e5841f1a44bd6"
}

Get the weight measurement from a specific point in time.

Get Weight

Returns a weight reading

GET https://api.humanapi.co/v1/human/weight

Returns all weight readings

GET https://api.humanapi.co/v1/human/weight/readings

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
id String The id of the bmi reading
userId String [deprecated - use humanId]
humanId String Unique user identifier
timestamp Date The original date and time of the measurement
tzOffset String The offset from UTC time in +/-hh:mm (e.g. -04:00)
source String The source service for the measurement, where it was created
value Number The value of the measurement in the unit specified
unit String The unit of the measurement value
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

Utility API

Sources

# Get sources measurement associated with the user
curl "https://api.humanapi.co/v1/human/sources?access_token=demo"

# Returns a json object of sources:
[{
    "source": "fitbit",
    "supportedDataTypes": [
        "activities",
        "bmi",
        "body_fat",
        "food",
        "sleeps",
        "weight",
        "locations",
        "heart_rate"
    ],
    "devices": [
        "Fitbit Charge HR",
        "Fitbit Aria"
    ],
    "connectedSince": "2015-03-31T16:10:23.382Z",
    "externalId": "39QMCK",
    "historySync": {
        "oldestDate": "2015-03-21T00:00:00.000Z",
        "status": "completed"
    },
    "syncStatus": {
        "status": "ok",
        "synchedAt": "2015-08-11T22:17:08.218Z",
        "newestDate": "2015-08-11T00:00:00.000Z"
    }
  },
  {
    "source": "ihealth",
    "supportedDataTypes": [
      "activities",
      "blood_glucose",
      "blood_oxygen",
      "blood_pressure",
      "heart_rate",
      "weight",
      "bmi",
      "body_fat"
    ],
    "devices": [
      "iHealth BP5"
    ],
    "connectedSince": "2014-05-27T16:23:50.481Z",
    "historySync": {
      "status": "completed",
      "oldestDate": "2014-02-28T08:59:43.000Z"
    },
    "syncStatus": {
      "status": "ok",
      "synchedAt": "2014-06-03T17:40:52.159Z",
      "newestDate": "2014-06-03T17:40:52.156Z"
    }
}]
// Get all sources associated with the user
var request = require('request');
request
.get('https://api.humanapi.co/v1/human/sources?access_token=demo')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

// Returns a json object of sources:
[{
    "source": "fitbit",
    "supportedDataTypes": [
        "activities",
        "bmi",
        "body_fat",
        "food",
        "sleeps",
        "weight",
        "locations",
        "heart_rate"
    ],
    "devices": [
        "Fitbit Charge HR",
        "Fitbit Aria"
    ],
    "connectedSince": "2015-03-31T16:10:23.382Z",
    "externalId": "39QMCK",
    "historySync": {
        "oldestDate": "2015-03-21T00:00:00.000Z",
        "status": "completed"
    },
    "syncStatus": {
        "status": "ok",
        "synchedAt": "2015-08-11T22:17:08.218Z",
        "newestDate": "2015-08-11T00:00:00.000Z"
    }
  },
  {
    "source": "ihealth",
    "supportedDataTypes": [
      "activities",
      "blood_glucose",
      "blood_oxygen",
      "blood_pressure",
      "heart_rate",
      "weight",
      "bmi",
      "body_fat"
    ],
    "devices": [
      "iHealth BP5"
    ],
    "connectedSince": "2014-05-27T16:23:50.481Z",
    "historySync": {
      "status": "completed",
      "oldestDate": "2014-02-28T08:59:43.000Z"
    },
    "syncStatus": {
      "status": "ok",
      "synchedAt": "2014-06-03T17:40:52.159Z",
      "newestDate": "2014-06-03T17:40:52.156Z"
    }
}]

The Sources endpoint returns the synchronization status of the different sources that a specific user has connected. To see a more detailed description on how this can be used see the documentation here.

Get Sources

Returns a sources reading

GET https://api.humanapi.co/v1/human/sources

Query Parameters

Parameter Description
access_token Returned for each user from a successful authentication

Response properties

Property Type Description
source String Name of the connected source (all lowercase, no spaces)
supportedDataTypes Array[String] List of data types supported by the source (does not indicate data is available for each type)
devices Array[String] List of devices (when available)
connectedSince Date Date source was connected to Human API
externalId String External userID from the source (when available)
historySync Object See HistorySync object below
syncStatus Object See SyncStatus object below

HistorySync Object

Property Type Description
status String Status of the historical sync
oldestDate Date Oldest date of the data retrieved from the service

For some services, `oldestDate` is just an indication of how far back the synchronization tasks attempted to retrieve data.

SyncStatus Object

Property Type Description
status String Status of the most recent sync
synchedAt Date The last time the synchronization task ran for this user
newestDate Date The timestamp of the most recently retrieved data

Users


# Get all users associated with an app.
curl -X GET -H 'Accept: application/json' \
    -u e7db255f4828e1d482743eba04faacb945ab7ca8: \
    https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users

# Returns a json array of users
[
  {
    "humanId": "0a34dca6b9fe0b2361038bd371d96539",
    "externalId": "sample.user1@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-28T18:46:10.436Z",
    "updatedAt": "2013-12-29T05:05:50.601Z"
  },
  {
    "humanId": "8bd9999a4f902e609343dcb850361f23",
    "externalId": "sample.user2@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-28T23:46:37.701Z",
    "updatedAt": "2013-12-28T23:46:37.701Z"
  },
  {
    "humanId": "f29b82027297553353acbf4901683830",
    "externalId": "sample.user3@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-29T05:08:11.610Z",
    "updatedAt": "2013-12-29T05:08:11.610Z"
  }
]


# Get a specific user associated with and app
curl -X GET -H 'Accept: application/json' \
    -u e7db255f4828e1d482743eba04faacb945ab7ca8: \
    https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/0a34dca6b9fe0b2361038bd371d96539

# Returns a json object

{
  "humanId": "0a34dca6b9fe0b2361038bd371d96539",
  "externalId": "sample.user1@example.com",
  "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
  "createdAt": "2013-12-28T18:46:10.436Z",
  "updatedAt": "2013-12-29T05:05:50.601Z"
}


# Delete a user
curl -X DELETE -u e7db255f4828e1d482743eba04faacb945ab7ca8: \
https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/0a34dca6b9fe0b2361038bd371d96539

# Returns status code
204

var request = require('request');

// Get all users associated with an app
request
.get('https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users')
.auth('e7db255f4828e1d482743eba04faacb945ab7ca8','')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

//Returns a json array of users
[
  {
    "humanId": "0a34dca6b9fe0b2361038bd371d96539",
    "externalId": "sample.user1@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-28T18:46:10.436Z",
    "updatedAt": "2013-12-29T05:05:50.601Z"
  },
  {
    "humanId": "8bd9999a4f902e609343dcb850361f23",
    "externalId": "sample.user2@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-28T23:46:37.701Z",
    "updatedAt": "2013-12-28T23:46:37.701Z"
  },
  {
    "humanId": "f29b82027297553353acbf4901683830",
    "externalId": "sample.user3@example.com",
    "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
    "createdAt": "2013-12-29T05:08:11.610Z",
    "updatedAt": "2013-12-29T05:08:11.610Z"
  }
]

//Get a specific user associated with an app
request
.get('https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/0a34dca6b9fe0b2361038bd371d96539')
.auth('e7db255f4828e1d482743eba04faacb945ab7ca8','')
.on('data', function(data) {
  console.log(JSON.parse(data));
});

//Returns a json object

{
  "humanId": "0a34dca6b9fe0b2361038bd371d96539",
  "externalId": "sample.user1@example.com",
  "appId": "1d129c20acf6fcef9be0b067cc7859d872ed5ade",
  "createdAt": "2013-12-28T18:46:10.436Z",
  "updatedAt": "2013-12-29T05:05:50.601Z"
}


//Delete a user
request
.del('https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/0a34dca6b9fe0b2361038bd371d96539')
.auth('e7db255f4828e1d482743eba04faacb945ab7ca8','')
.on('response', function(response) {
    console.log(response.statusCode)
});


//Returns status code
204


The users endpoint returns users of a specific app.

Users for your app are primarily created using Human Connect. This endpoint is best used for management of existing users.

As a part of the Application API this endpoint is authenticated using Basic Authentication. You must use your App Key as username and a blank password. Make sure you include the “:” after the username to avoid being asked to enter a password.

For a more detailed description on how to manage your app’s users, see the documentation here.

GET USERS

Returns a list of users

GET https://api.humanapi.co/v1/apps/{appId}/users

Returns a single user

GET https://api.humanapi.co/v1/apps/{appId}/users/{humanId}

Response properties

Property Type Description
humanId String The id of the user in Human API
externalId String The id of the user provided from your application
appId String Unique app identifier found in the Developer Portal.
createdAt Date The time the measurement was created on the Human API server
updatedAt Date The time the measurement was updated on the Human API server

DELETE A USER

Deletes a user

DELETE https://api.humanapi.co/v1/apps/{appId}/users/{humanId}

The response code for this is 204

Batch Query

# Get activities for all of your users
curl -X GET -H 'Accept: application/json' \
    -u e7db255f4828e1d482743eba04faacb945ab7ca8: \
https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/activities

# Returns a json array of activities
[
  {
    "id": "52867cbfde3155565f000b01",
    "userId": "51cc7cb31a154bf215000002",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2013-11-01T17:27:00.346Z",
    "endTime": "2013-11-01T18:27:11.346Z",
    "type": "walking",
    "source": "runkeeper",
    "duration": 3611,
    "distance": 1251,
    "steps": 2689,
    "calories": 482,
    "timeZone": "America/Los_Angeles",
    "sourceData": {},
    "timeSeries": {},
    "createdAt": "2013-11-01T17:27:00.346Z",
    "updatedAt": "2013-11-01T17:27:00.346Z"
  },
  {
    "id": "52867cbfde3155565f000b02",
    "userId": "538b9d3a9b1e35be7302607e",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2014-05-31T16:18:19.000Z",
    "endTime": "2014-05-31T19:00:27.000Z",
    "type": "cycling",
    "source": "strava",
    "duration": 9728,
    "distance": 45468.6,
    "steps": 0,
    "calories": 0,
    "sourceData": {
      "maxHeartrate": 196,
      "averageHeartrate": 145,
      "maxSpeed": 17.3,
      "mapId": "a147785724",
      "movingTime": 7782,
      "type": "Ride"
    },
    "createdAt": "2014-05-31T19:03:32.032Z",
    "updatedAt": "2014-05-31T19:03:32.032Z"
  },
  {
    "id": "52867cbfde3155565f000b03",
    "userId": "538029c700850beb2601c578",
    "humanId": "7eddd553c81b8de9ac271bc21f50e32e",
    "startTime": "2014-05-28T20:04:02.000Z",
    "endTime": "2014-05-29T00:00:00.000Z",
    "type": "walking",
    "source": "mapmyfitness",
    "duration": 0,
    "distance": 178636.74,
    "steps": 0,
    "calories": 1916,
    "sourceData": { },
    "createdAt": "2014-05-31T00:21:09.386Z",
    "updatedAt": "2014-05-31T00:21:09.386Z"
  }
]


// Get activities for all of your users
var request = require('request');

request
.get('https://api.humanapi.co/v1/apps/1d129c20acf6fcef9be0b067cc7859d872ed5ade/users/activities')
.auth('e7db255f4828e1d482743eba04faacb945ab7ca8','')
.on('data', function(data) {
  console.log(JSON.parse(data));
});


// Returns a json array of activities
[
  {
    id: "52867cbfde3155565f000b01",
    userId: "51cc7cb31a154bf215000002",
    humanId: "7eddd553c81b8de9ac271bc21f50e32e",
    startTime: "2013-11-01T17:27:00.346Z",
    endTime: "2013-11-01T18:27:11.346Z",
    type: "walking",
    source: "runkeeper",
    duration: 3611,
    distance: 1251,
    steps: 2689,
    calories: 482,
    timeZone: "America/Los_Angeles",
    sourceData: {},
    timeSeries: {},
    createdAt: "2013-11-01T17:27:00.346Z",
    updatedAt: "2013-11-01T17:27:00.346Z"
  },
  {
    id: "52867cbfde3155565f000b02",
    userId: "538b9d3a9b1e35be7302607e",
    humanId: "7eddd553c81b8de9ac271bc21f50e32e",
    startTime: "2014-05-31T16:18:19.000Z",
    endTime: "2014-05-31T19:00:27.000Z",
    type: "cycling",
    source: "strava",
    duration: 9728,
    distance: 45468.6,
    steps: 0,
    calories: 0,
    sourceData: {
      maxHeartrate: 196,
      averageHeartrate: 145,
      maxSpeed: 17.3,
      mapId: "a147785724",
      movingTime: 7782,
      type: "Ride"
    },
    createdAt: "2014-05-31T19:03:32.032Z",
    updatedAt: "2014-05-31T19:03:32.032Z"
  },
  {
    id: "52867cbfde3155565f000b03",
    userId: "538029c700850beb2601c578",
    humanId: "7eddd553c81b8de9ac271bc21f50e32e",
    startTime: "2014-05-28T20:04:02.000Z",
    endTime: "2014-05-29T00:00:00.000Z",
    type: "walking",
    source: "mapmyfitness",
    duration: 0,
    distance: 178636.74,
    steps: 0,
    calories: 1916,
    sourceData: { },
    createdAt: "2014-05-31T00:21:09.386Z",
    updatedAt: "2014-05-31T00:21:09.386Z"
  }
]

Returns data for all of your app’s users in one query per data type.

These endpoints replicate those available for the individual user queries. The payload data model is the same for individual and batch queries, except the batch query results return a list multiple users so you need to parse the data accordingly.

As a part of the Application API this endpoint is authenticated using Basic Authentication. You must use your App Key as username and a blank password. Make sure you include the “:” after the username to avoid being asked to enter a password.

Do not perform regular batch queries without the updated_since query parameter. By supplying updated_since with your last query time, you can ensure that your queries are quick and efficient.


For a more detailed description of batch queries including best practices, see the documentation on the Hub

Activities

/apps/:clientId/users/activities

Activity Summaries

/apps/:clientId/users/activities/summaries

Heart Rates

/apps/:clientId/users/heart_rates

BMIs

/apps/:clientId/users/bmis

Body Fats

/apps/:clientId/users/body_fats

Heights

/apps/:clientId/users/heights

Weights

/apps/:clientId/users/weights

Blood Glucoses

/apps/:clientId/users/blood_glucoses

Blood Oxygens

/apps/:clientId/users/blood_oxygens

Blood Pressures

/apps/:clientId/users/blood_pressures

Genetic Traits

/apps/:clientId/users/genetic_traits

Locations

/apps/:clientId/users/locations

Meals

/apps/:clientId/users/food/meals

Sleeps

/apps/:clientId/users/sleeps

Sleep Summaries

/apps/:clientId/users/sleeps/summaries

Query Parameters

Parameter Type Description
updated_since Date in YYYYMMDDTHHmmssZ format. Use this in order to retrieve only the new data since your last query.