Search for a patient with demographics

If you want to locate a patient's record in an EHR system but you don't have a patient identifier, you can search for a patient with demographics instead. Typically, you can use this for: 

  • tying patient records from your system to the patient’s record in the relevant EHR;
  • filling the gaps in demographics you have for a specific patient by using a few data points to locate a more comprehensive set of data; or
  • searching for a patient in a large integration network like the Carequality Interoperability Framework.

Supported systems

You can use this API action with the Redox FHIR® API.

Your connection's system can return results with their own FHIR® or query-based API.

Things you need to know

Action steps

  • 1
    Search for a patient with demographics
    required

This table has notes about how to use parameters for this API action specifically, but it's not exhaustive. Refer to the Patient resource schema for more details.

Query parameter
Required
Notes
given
Y
When searching by demographics, you must include the patient's given name (typically first name)—along with any other demographics you want to include—for the search to be successful.
family
Y
When searching by demographics, you must include the patient's family name (typically last name)—along with any other demographics you want to include—for the search to be successful.
birthdate
Y
When searching by demographics, you must include the patient's date of birth—along with any other demographics you want to include—for the search to be successful.

Depending on the EHR system, you may receive one result per search, a list of results, or no results at all. 

Query Response
curl 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient/_search' \
--request POST \
--header 'Authorization: Bearer $API_TOKEN' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'given=Keva' \
--data-urlencode 'family=Green' \
--data-urlencode 'birthdate=1995-08-26'
{
"id": "fc7b832c-2a3b-4b17-80e7-2dbc81109f8f",
"type": "searchset",
"entry": [
{
"search": {
"mode": "match",
"score": 1
},
"resource": {
"id": "81c2f5eb-f99f-40c4-b504-59483e6148d7",
"meta": {
"lastUpdated": "2020-10-29T20:06:13.429Z"
},
"name": [
{
"use": "official",
"given": [
"Keva"
],
"family": "Green"
}
],
"active": true,
"gender": "female",
"address": [
{
"use": "home",
"city": "Hillsboro",
"line": [
"932 Stehr Vista"
],
"state": "OR",
"postalCode": "97123"
}
],
"birthDate": "1995-08-26",
"extension": [
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race",
"extension": [
{
"url": "text",
"valueString": "White"
}
]
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity",
"extension": [
{
"url": "ombCategory",
"valueCoding": {
"code": "2186-5",
"system": "urn:oid:2.16.840.1.113883.6.238",
"display": "Non Hispanic or Latino"
}
},
{
"url": "text",
"valueString": "Not hispanic or latino"
}
]
}
],
"identifier": [
{
"value": "kyHGADnvX3xbkU4V9ayaqh",
"system": "urn:redox:redox-fhir-sandbox:MR"
}
],
"resourceType": "Patient",
"deceasedDateTime": null
}
}
],
"total": 1,
"resourceType": "Bundle"
}