Get a list of demographics data associated with the user
Returns a list of demographics data associated with the user
GET https://api.humanapi.co/v1/human/medical/demographics
Returns a single record of demographics data associated with the user
GET https://api.humanapi.co/v1/human/medical/demographics/{id}
# Returns a json array of demographics:
[
{
"address": {
"city": "SAN FRANCISCO",
"country": "USA",
"state": "CA",
"street": [
"123 Lucas Drive"
],
"zip": "95131"
},
"ccd": {
"href": "/medical/ccds/5b3056dd711be0bff640e105",
"id": "5c3056db711b20bff610e105"
},
"createdAt": "2018-07-12T20:16:36.159Z",
"dob": "05/20/1971",
"dobDateTime": "1971-05-20T00:00:00.000Z",
"ethnicity": "Not Hispanic or Latino",
"ethnicityCodes": [
{
"code": "2186-5",
"codeSystemName": "RACEÐNICITY-CDC",
"inferred": true
},
{
"code": "2131-1",
"codeSystemName": "RACEÐNICITY-CDC",
"inferred": true
}
],
"gender": "male",
"genderCodes": [
{
"code": "703117000",
"codeSystemName": "SNOMED-CT",
"inferred": true
}
],
"id": "5b47b7344e72eb0022b9b5a2",
"language": "eng",
"languageCodes": [
{
"code": "315570003",
"codeSystemName": "SNOMED-CT",
"inferred": true
}
],
"maritalStatus": "married",
"maritalStatusCodes": [
{
"code": "87915002",
"codeSystemName": "SNOMED-CT",
"inferred": true
}
],
"name": {
"family": "Archer",
"given": [
"Archer",
"B"
]
},
"organization": {
"href": "/medical/organizations/54dc427aaa6b4cb7d620302f",
"id": "54dc427aaa6b4cb7d620302f",
"name": "Starfleet Medical"
},
"provider": {
"address": {
"city": "San Francisco",
"country": "USA",
"state": "CA",
"zip": "94156"
},
"organization": "Starfleet Medical"
},
"race": "White",
"raceCodes": [
{
"code": "185984009",
"codeSystemName": "SNOMED-CT",
"inferred": true
},
{
"code": "2106-3",
"codeSystemName": "RACEÐNICITY-CDC",
"inferred": true
}
],
"updatedAt": "2018-07-12T20:16:36.159Z"
}
]
# Get all demographics data associated with the user
# Note that the demo access token currently returns an empty array. The results in the JSON tab are fictional values.
curl -H "Authorization: Bearer demo" "https://api.humanapi.co/v1/human/medical/demographics"
Response Properties
| Property | Type | Description |
|---|---|---|
| id | String | Id of the resource |
| updatedAt | Date | Time the record was updated on the Human API server |
| createdAt | Date | Time the record was created on the Human API server |
| name | Object | (optional) See name object |
| dob | String | (optional) Date of birth of the patient e.g. "05/20/1971" |
| dobDateTime | String | (optional) Date of birth of the patient e.g. "1971-05-20T00:00:00.000Z" |
| ethnicity | String | (optional) Ethnicity of the patient e.g. "Not Hispanic or Latino" |
| ethnicityCodes | Array[Object] | (optional) CDC Race & Ethnicity and SNOMED CT Ethnicity codes: See codes |
| gender | String | (optional) Gender of the patient e.g. "male" |
| genderCodes | Array[Object] | (optional) SNOMED CT Gender codes: See codes |
| language | String | (optional) Preferred spoken language of the patient e.g. "eng" |
| languageCodes | Array[Object] | (optional) SNOMED CT Language codes: See codes |
| maritalStatus | String | (optional) Marital status of the patient e.g. "married" |
| maritalStatusCodes | Array[Object] | (optional) SNOMED CT Marital codes: See codes |
| provider | Object | See Provider Object details below |
| organization | Object | See organizations |
| race | String | (optional) Race of the patient e.g. "White" |
| raceCodes | Array[Object] | (optional) SNOMED CT Race codes: See codes |
| codes | Array[Object] | (optional) See codes |
| ccd | Object | (optional) See CCD Object details below |
CCD Object
| Property | Type | Description |
|---|---|---|
| href | String | Link to a more detailed CCD object |
| id | String | id of the CCD |
Provider Object
| Property | Type | Description |
|---|---|---|
| organization | String | (optional) The name of the medical source |
| address | Object | (optional) See Address Object below |
Address Object (from Provider Object)
| Property | Type | Description |
|---|---|---|
| city | String | (optional) City of the provider e.g. "San Francisco" |
| country | String | (optional) Country of the provider e.g. "USA" |
| state | String | (optional) State of the provider e.g. "CA" |
| zip | String | (optional) Zip code of the provider e.g. "94156" |
| street | Array[String] | (optional) Street and number of the address e.g. '["123 Lucas Drive"]' |
