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"]' |