Test Sandbox APIs
API Reference
Capability Statement
Observation
The Observation API enables Humana members to exchange their laboratory results, vital sign readings, and social history such as smoking status with third party applications. This API conforms to the R4 FHIR standard and the US Core STU3 Implementation Guide.
URL
Headers
| ACCEPT | application/json |
| AUTHORIZATION | Bearer {ACCESS_TOKEN} |
Sample Request
curl -X GET \
https://sandbox-fhir.humana.com/api/Observation \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {your access token}' \curl -X GET \
https://fhir.humana.com/api/Observation \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {your access token}' \Sample Response
{
"resourceType": "Bundle",
"type": "searchset",
"timestamp": "2025-01-15T16:22:16.494+00:00",
"meta": {
"lastUpdated": "2025-01-15T16:22:16.494+00:00",
"versionId": "c8cd920d-9cd1-4378-be29-0ba12dbc6b94"
},
"entry": [
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/f933e09f8d4f2acad89e875bab7b0ee9ddff6592b48dd171e283afeb50b083ff",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "f933e09f8d4f2acad89e875bab7b0ee9ddff6592b48dd171e283afeb50b083ff",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "aa6f2b34-a9c6-49ab-a5fb-6f3a82b2c200",
"lastUpdated": "2025-01-15T02:40:28.522+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "789-8",
"display": "Erythrocytes [#/volume] in Blood by Automated count"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 4.78,
"unit": "10*6/uL",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 3.77,
"unit": "10*6/uL",
"system": "http://unitsofmeasure.org",
"code": "10*6/uL"
},
"high": {
"value": 5.28,
"unit": "10*6/uL",
"system": "http://unitsofmeasure.org",
"code": "10*6/uL"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/4b41cdb1bbe2c7fb1fdd474f7abb4ef75a80f7c11af65465bc079c3fe70ea989",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "4b41cdb1bbe2c7fb1fdd474f7abb4ef75a80f7c11af65465bc079c3fe70ea989",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "d280da1f-6c18-4dd9-9e42-ed8f0b3010ac",
"lastUpdated": "2025-01-15T02:40:28.554+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "718-7",
"display": "Hemoglobin [Mass/volume] in Blood"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 14,
"unit": "g/dL",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 11.1,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
},
"high": {
"value": 15.9,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/29a41b09d42775638b89ed18d2e3ca5389de32571b4fbf752dc2a433b93eea1e",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "29a41b09d42775638b89ed18d2e3ca5389de32571b4fbf752dc2a433b93eea1e",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "7349316a-621c-43e5-aaa8-1a2490cde9fe",
"lastUpdated": "2025-01-15T02:40:28.596+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2028-9",
"display": "Carbon dioxide total [Moles/volume] in Serum or Plasma"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 25,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 20,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org",
"code": "mmol/L"
},
"high": {
"value": 29,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org",
"code": "mmol/L"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/c9100cc027d1853ea093863461ab92c4d6ff75a31cb28c4b7088e987623f1ef4",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "c9100cc027d1853ea093863461ab92c4d6ff75a31cb28c4b7088e987623f1ef4",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "82d46e7e-67be-4477-addb-c80a1d67c340",
"lastUpdated": "2025-01-15T02:40:28.627+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "5811-5",
"display": "Specific gravity of Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 1.021,
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 1.005,
"system": "http://unitsofmeasure.org"
},
"high": {
"value": 1.03,
"system": "http://unitsofmeasure.org"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/901c1408349ae3a87353d73413ef5ce1ec321512f536b564b1baf7e284f45864",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "901c1408349ae3a87353d73413ef5ce1ec321512f536b564b1baf7e284f45864",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "feb58a98-730c-43c0-aaae-146fd3a1a730",
"lastUpdated": "2025-01-15T02:40:28.686+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "4544-3",
"display": "Hematocrit [Volume Fraction] of Blood by Automated count"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 42.3,
"unit": "%",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 34,
"unit": "%",
"system": "http://unitsofmeasure.org",
"code": "%"
},
"high": {
"value": 46.6,
"unit": "%",
"system": "http://unitsofmeasure.org",
"code": "%"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/d5a8ef5104a649e08a995eaf70795ac135a44cfef5bd2ade65a2898010396a53",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "d5a8ef5104a649e08a995eaf70795ac135a44cfef5bd2ade65a2898010396a53",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "6a1f9fcf-1657-4fa8-9802-09d68cf876f4",
"lastUpdated": "2025-01-15T02:40:28.727+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "20454-5",
"display": "Protein [Presence] in Urine by Test strip"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueString": "N"
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/9ae2038ec0b346959697e09948ea024ce4b6246b53d12bb0b2994e6125b6715a",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "9ae2038ec0b346959697e09948ea024ce4b6246b53d12bb0b2994e6125b6715a",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "97386c1a-5d72-467f-bebf-d751e52d392b",
"lastUpdated": "2025-01-15T02:40:28.727+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "17861-6",
"display": "Calcium [Mass/volume] in Serum or Plasma"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-06-20",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 9.3,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 8.7,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
},
"high": {
"value": 10.3,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/e2b7f567b731c2ef13f896cd4f1c0298fb3a172de2e45fd4a21b68fa59bf35b6",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "e2b7f567b731c2ef13f896cd4f1c0298fb3a172de2e45fd4a21b68fa59bf35b6",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "a919f2cc-d938-457c-8551-f7b743ab1827",
"lastUpdated": "2025-01-15T02:40:28.793+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2093-3",
"display": "Cholesterol [Mass/volume] in Serum or Plasma"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 201,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org"
},
"interpretation": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
"code": "H",
"display": "High"
}
]
}
],
"referenceRange": [
{
"low": {
"value": 100,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
},
"high": {
"value": 199,
"unit": "mg/dL",
"system": "http://unitsofmeasure.org",
"code": "mg/dL"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/7cd8965b198c34c9d2efc2e4d3aa224d6edaa7ab797b738af8525f21492a23c0",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "7cd8965b198c34c9d2efc2e4d3aa224d6edaa7ab797b738af8525f21492a23c0",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "14edc01f-f6f9-4b56-a5e8-82098c412b6a",
"lastUpdated": "2025-01-15T02:40:28.794+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "786-4",
"display": "MCHC [Mass/volume] by Automated count"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-03-04",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 33.1,
"unit": "g/dL",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 31.5,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
},
"high": {
"value": 35.7,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
}
}
]
}
},
{
"fullUrl": "https://sandbox-fhir.humana.com/Observation/410b578bf78a73432b1940ed756f54b72fb785e347340c8ac01e86e0e57e1bf3",
"search": {
"mode": "match"
},
"resource": {
"resourceType": "Observation",
"id": "410b578bf78a73432b1940ed756f54b72fb785e347340c8ac01e86e0e57e1bf3",
"meta": {
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab"
],
"versionId": "1c37fde7-483d-4cd0-98d2-fabbe98df9b8",
"lastUpdated": "2025-01-15T03:15:16.791+00:00"
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "718-7",
"display": "Hemoglobin [Mass/volume] in Blood"
}
]
},
"subject": {
"reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
},
"effectiveDateTime": "2024-02-21",
"performer": [
{
"display": "LABCORP"
}
],
"valueQuantity": {
"value": 11.7,
"unit": "g/dL",
"system": "http://unitsofmeasure.org"
},
"referenceRange": [
{
"low": {
"value": 11.1,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
},
"high": {
"value": 15.9,
"unit": "g/dL",
"system": "http://unitsofmeasure.org",
"code": "g/dL"
}
}
]
}
}
],
"total": 557,
"link": [
{
"relation": "self",
"url": "https://sandbox-fhir.humana.com/Observation?_total=accurate&_count=10&_skip=0"
},
{
"relation": "next",
"url": "https://sandbox-fhir.humana.com/Observation?_total=accurate&_count=10&_skip=10"
},
{
"relation": "last",
"url": "https://sandbox-fhir.humana.com/Observation?_total=accurate&_count=10&_skip=550"
}
],
"id": "b2c6bcd7-aa28-4944-8654-b459a5771303"
}