Search for a patient with identifier

If you already have an identifier for a patient, you can easily locate the patient’s record in an EHR system by searching for a patient with that identifier. Typically, you can use this for: 

  • tying patient records from your system to the patient’s record in the relevant EHR;
  • locating other patient identifiers used in different systems; or 
  • starting a search for patient’s demographics, insurance, general clinical data, test results, prescribed medications, or vaccination history.

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 identifier
    required

You can search for a patient with their unique identifier if you know which identifier type to use for the given EHR system.

For example, if you have the patient's MRN, but the EHR system uses the FHIR® resource ID, you may have to search for the patient with the MRN to locate all identifiers for this patient first; alternatively, you can search for a patient with demographics to locate the resource ID. Then, you can perform additional API actions that require the FHIR® resource ID.

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
identifier
Y
When searching by identifier, you must include the patient's unique identifier within the EHR system that you're searching. This means you must know the unique identifier for that specific system for the search to be successful.

You typically receive either one result or none. Multiple matches may be returned depending on the identifier type that you’re using (since not all patient identifiers are unique) or your integration type.

Patient/_search
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 'identifier=urn:redox:redox-fhir-sandbox:MR|kyHGADnvX3xbkU4V9ayaqh'
{
"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"
}