Request patient documents

Last updated: Aug 21, 2024

HEALTH TECH VENDOR

IMPLEMENTATION

DEVELOPER

Who can use this how-to

Existing customers using Redox Access™
Existing customers with a direct connection to Carequality (i.e., without Redox Access)

After you successfully search and locate patient records at a given organization, you can request patient documents. There are two options for this step.

Workflow for requesting clinical data

Use Redox Access to request the latest patient summary: Typically, the simplest option is to request a generic patient summary directly via Redox Access.
Pick your own docs: If you can select documents of interest within your own UI, you can retrieve a full list of available documents and select the specific documents that are of interest. You can perform this type of search with either the Redox Data Model API or FHIR® API.

The returned documents from either option follow a standard format (Consolidated-Clinical Document Architecture, or C-CDA) and include several sections of information related to the patient’s demographics, encounters, medications, diagnoses, allergies, and more. Check out required C-CDA elements.

Different organization, different data

Different organizations may include varying amounts of information or specificity, or they may use different code sets to represent the data. We simply pass the data as we receive it from the responding organization.

Use curl for technical validation

You can copy the code examples we provide and send the test requests with curl (learn more about curl) instead of Postman. To do that, you must remove the comments from the code examples (starting with //) and replace any variables (e.g., {{variable here}}).

Some of the code examples are abbreviated, so be mindful of that if you're copying them for your own use.

Canada URL

If you're operating in Canada, you must tweak the Redox hostname slightly. All you need to do is add a ca in that URL like this: https://api.ca.redoxengine.com.

Option 1: Use Redox Access to request latest patient summary

Choose this option if you only want CDA documents, and you want to automatically get the most recent CDA for a patient. You receive the data back in a nice Redox-parsed view.

Not supported with FHIR

We don't currently support this option with the Redox FHIR® API.

This option relies on the ClinicalSummary data model.

Using Postman or curl, send a ClinicalSummary.PatientQuery request with the relevant metadata, like the patient’s ID and ID Type (from the PatientSearch response) and the organization OID (which goes in the Meta.FacilityCode field).

Example: Request a patient summary

bash

1
curl \
2
-X POST https://api.redoxengine.com/endpoint \
3
-H "Content-Type: application/json" \
4
-H "Authorization: Bearer {{access token}}" \
5
-d '{
6
    "Meta": {
7
        "Extensions": {
8
            "sender-organization-id": {
9
                "url": "https://api.redoxengine.com/extensions/sender-organization-id",
10
                # This should be the OID representing you as an organization. If you have multiple levels, it helps to be specific
11
                # but you can also just use your top-level
12
                "string": "{{organization_oid}}"
13
            },
14
            "user-id": {
15
                "url": "https://api.redoxengine.com/extensions/user-id",
16
                # This should change per query and should be a human-readable ID for the user (typically name, not an actual ID)
17
                "string": "{{user_human_readable_id}}"
18
            },
19
            "user-role": {
20
                "url": "https://api.redoxengine.com/extensions/user-role",
21
                # Depends on the user above, this is a SNOMED CT code
22
                # See here: https://www.hl7.org/fhir/valueset-practitioner-role.html
23
                "coding": {
24
                    "code": "{{user_role}}",
25
                    # This is set for the default code (112247003), but if you have a different code, this should change
26
                    "display": "Medical Doctor"
27
                }
28
            },
29
            "purpose-of-use": {
30
                "url": "https://api.redoxengine.com/extensions/purpose-of-use",
31
                # Almost ALWAYS treatment -> depends on the app purpose, but typically this is treatment
32
                # If it wasn't, other organizations on Carequality likely wouldn't respond
33
                # To use this, you have to participate in Carequality, which is why you also have to push data
34
                "coding": {
35
                    "code": "TREATMENT",
36
                    "display": "Treatment"
37
                }
38
            }
39
        },
40
        "DataModel": "Clinical Summary",
41
        "EventType": "PatientQuery",
42
        "Test": true,
43
        "Destinations": [
44
            {
45
                # This value is standard Redox Meta structure and will vary between environments
46
                # See the Carequality FAQ for Production values -- you're all set for sandbox testing
47
                "ID": "{{document_query_destination}}"
48
            }
49
        ],
50
        # This value represents what organization on Carequality should be searched.
51
        # The below is Redox here, but if you are coming from RLS, this should be the Organization OID-type ID from the location result
52
        # and non-RLS patient search should include the organization OID you found from the organization search
53
        "FacilityCode": "2.16.840.1.113883.3.6147.458.2"
54
    },
55
    "Patient": {
56
        "Identifiers": [
57
            {
58
                # Similar to "FacilityCode" this should come from the RLS location result or from your patient search if non-RLS
59
                "ID": "{{PatientID}}",
60
                "IDType": "{{PatientIDType}}"
61
            }
62
        ]
63
    }
64
}

API reference

Review the ClinicalSummary data model schema for more technical details.

If the request is successful, you receive a synchronous ClinicalSummary.PatientQueryResponse with the latest patient summary document (i.e., a snapshot of the patient’s current chart).

Example: Successful response for a patient summary

json

1
{
2
    "InsurancesText": "",
3
    "Insurances": [],
4
    "Header": {
5
        "Document": {
6
            "Visit": {
7
                "Location": null,
8
                "VisitNumber": "",
9
                "EndDateTime": "",
10
                "StartDateTime": ""
11
            },
12
            "Author": {
13
                "Location": {
14
                    "Facility": "MADISON ANESTHESIOLOGY CONSULTANTS, LLP"
15
                }
16
            },
17
            "ID": "2.16.840.1.113883.19.5^92cce54a-3a9f-634a-4d20-7e566ecc32ab",
18
            "TypeCode": {
19
                "AltCodes": [],
20
                "CodeSystemName": "LOINC",
21
                "CodeSystem": "2.16.840.1.113883.6.1",
22
                "Name": "Summarization of episode note",
23
                "Code": "34133-9"
24
            },
25
            "Type": "Summarization of episode note",
26
            "DateTime": "2020-12-10T17:09:50.000Z",
27
            "Title": "C-CDA R2.1 Patient Record: Adolfo Kessler",
28
            "Locale": "US"
29
        },
30
        "Patient": {
31
            "Demographics": {
32
                "MaritalStatus": "",
33
                "Religion": "",
34
                "Ethnicity": "Not hispanic or latino",
35
                "Race": "White",
36
                "Address": {
37
                    "County": "",
38
                    "ZIP": "53711",
39
                    "Country": "",
40
                    "State": "Wisconsin",
41
                    "City": "Madison",
42
                    "StreetAddress": "602 Schiller Junction Suite 68"
43
                },
44
                "Sex": "Male",
45
                "SSN": "",
46
                "DOB": "2002-10-31T17:09:50.000Z",
47
                "EmailAddresses": [],
48
                "PhoneNumber": {
49
                    "Mobile": "",
50
                    "Office": "",
51
                    "Home": ""
52
                },
53
                "LastName": "Kessler",
54
                "FirstName": "Adolfo"
55
            },
56
            "Identifiers": [
57
                {
58
                    "IDType": "2.16.840.1.113883.19.5",
59
                    "ID": "j8p2NtTbAL7rTWRRhe7kSK"
60
                }
61
            ]
62
        }
63
    }

Option 2: Pick your own docs

Choose this option if you want to receive a full list of documents related to the patient. Then, query for any document from the list. You receive the document in both raw XML—which is useful if you have your own document renderer—and in a Redox-parsed view for any data that we can parse.

For this option, use the DocumentQuery and DocumentGet event types of ClinicalSummary; if you're using FHIR®, use the DocumentReference resource. The response returns PDFs or any other documents that are attached to the patient record.

Using Postman or curl, send the ClinicalSummary.DocumentQuery request with the relevant metadata:

Patient ID and ID Type: These values are returned in the PatientSearch response.

Organization OID: The organization OID is equivalent to the HCID value (from the DocumentQuery response) and should go in the Meta.FacilityCode field of your request.

Getting documents of value

It's possible to get lots of documents that may or may not be useful to you. We recommend requesting the patient's most recent CCD (i.e., LOINC 34133-9) and progress notes (LOINC 11506-3) from the last three months.

Be aware that responders may have different names for progress notes, like "telephone," "office visit," or "emergency." You can find the document's LOINC value in the Documents[].Type.Code for each document returned in the ClinicalSummary.documentQueryResponse.

Data model example: Search for a document list

bash

1
curl \
2
-X POST https://api.redoxengine.com/endpoint \
3
-H "Content-Type: application/json" \
4
-H "Authorization: Bearer {{access token}}" \
5
-d '{
6
    "Meta": {
7
        "Extensions": {
8
            "sender-organization-id": {
9
                "url": "https://api.redoxengine.com/extensions/sender-organization-id",
10
                # This should be the OID representing you as an organization. If you have multiple levels, it helps to be specific
11
                # but you can also just use your top-level
12
                "string": "{{organization_oid}}"
13
            },
14
            "user-id": {
15
                "url": "https://api.redoxengine.com/extensions/user-id",
16
                # This should change per query and should be a human-readable ID for the user (typically name, not an actual ID)
17
                "string": "{{user_human_readable_id}}"
18
            },
19
            "user-role": {
20
                "url": "https://api.redoxengine.com/extensions/user-role",
21
                # Depends on the user above, this is a SNOMED CT code
22
                # See here: https://www.hl7.org/fhir/valueset-practitioner-role.html
23
                "coding": {
24
                    "code": "{{user_role}}",
25
                    # This is set for the default code (112247003), but if you have a different code, this should change
26
                    "display": "Medical Doctor"
27
                }
28
            },
29
            "purpose-of-use": {
30
                "url": "https://api.redoxengine.com/extensions/purpose-of-use",
31
                # Almost ALWAYS treatment -> depends on the app purpose, but typically this is treatment
32
                # If it wasn't, other organizations on Carequality likely wouldn't respond
33
                # To use this, you have to participate in Carequality, which is why you also have to push data
34
                "coding": {
35
                    "code": "TREATMENT",
36
                    "display": "Treatment"
37
                }
38
            }
39
        },
40
        "DataModel": "Clinical Summary",
41
        "EventType": "DocumentQuery",
42
        # Remove in production
43
        "Test": true,
44
        "Destinations": [
45
            {
46
                # This value is standard Redox Meta structure and will vary between environments
47
                # See the Carequality FAQ for Production values -- you're all set for sandbox testing
48
                "ID": "{{document_query_destination}}"
49
            }
50
        ],
51
        # This value represents what organization on the network should be searched.
52
        # The below is Redox here, but if you are coming from RLS, this should be the Organization OID-type ID from the location result
53
        # and non-RLS patient search should include the organization OID you found from the organization search
54
        "FacilityCode": "2.16.840.1.113883.3.6147.458.2"
55
    },
56
    "Patient": {
57
        "Identifiers": [
58
            {
59
                # Similar to "FacilityCode" this should come from the RLS location result or from your patient search if non-RLS
60
                "ID": "{{PatientID}}",
61
                "IDType": "{{PatientIDType}}"
62
            }
63
        ]
64
    }
65
}

API reference

Review the ClinicalSummary data model schema for more technical details.

FHIR example: Search for a document list

bash

1
curl --location --request POST 'https://testapi.redoxengine.com/fhir/R4/ceq-xca:2.16.840.1.113883.3.6147.458.2/Development/DocumentReference/_search' \
2
--header 'redox-source-id: 052efa1a-bf81-47f8-9ce9-f4f0a186f160' \
3
--header 'Authorization: Bearer <TOKEN>' \
4
--header 'x-sender-organization-id: 2.16.840.1.113883.3.6147.458.7512.1.1.1' \
5
--header 'x-user-id: {{user-id}}' \
6
--header 'x-user-role: MEDICAL DOCTOR' \
7
--header 'x-purpose-of-use: TREATMENT' \
8
--header 'Content-Type: application/x-www-form-urlencoded' \
9
--data-urlencode 'patient=4e6e9af5-9164-48ef-869b-53d901cd8d10^2.16.840.1.113883.3.6147.458.2'

FHIR API reference

Review the FHIR® DocumentReference resource for more technical details.

If the request is successful, you receive a synchronous ClinicalSummary.DocumentQueryResponse with a document list with an identifier, type, and date for each document so that you can identify the most relevant documents.

Data model example: Successful response for a document list

json

1
{
2
    "Documents": [
3
        {
4
            "Author": {
5
                "Location": {
6
                    "Type": "General Medicine",
7
                    "Department": "Health Encounter Site",
8
                    "Facility": "Cool.io"
9
                },
10
                "Type": "",
11
                "Credentials": [],
12
                "FirstName": null,
13
                "LastName": null,
14
                "IDType": null,
15
                "ID": null
16
            },
17
            "Location": {
18
                "Department": "Health Encounter Site"
19
            },
20
            "Visit": {
21
                "Type": "Summarization of episode note",
22
                "EndDateTime": "2020-12-10T17:09:50.000Z",
23
                "StartDateTime": "2020-12-10T17:09:50.000Z"
24
            },
25
            "Type": {
26
                "Name": "Summarization of episode note",
27
                "Codeset": "2.16.840.1.113883.6.1",
28
                "Code": "34133-9"
29
            },
30
            "FileType": "text/xml",
31
            "HCID": "urn:oid:2.16.840.1.113883.3.6147.458.8080.2.2.1",
32
            "RepositoryUniqueId": "2.16.840.1.113883.3.6147.458.8080.2.2.1",
33
            "DateTime": null,
34
            "Locale": "en-US",
35
            "Title": "Summarization of episode note",
36
            "ID": "Mi4xNi44NDAuMS4xMTM4ODMuMTkuNV45MmNjZTU0YS0zYTlmLTYzNGEtNGQyMC03ZTU2NmVjYzMyYWI=^Mi4xNi44NDAuMS4xMTM4ODMuMy42MTQ3LjQ1OC44MDgwLjIuMi4x^dXJuOm9pZDoyLjE2Ljg0MC4xLjExMzg4My4zLjYxNDcuNDU4LjgwODAuMi4yLjE="
37
        }
38
    ],
39
    "Patient": {
40
        "Identifiers": [
41
            {
42
                "ID": "45e5fadd-0496-4e48-be26-a06d78f8e950",
43
                "IDType": "2.16.840.1.113883.3.6147.458.2"
44
            }
45
        ]
46
    },
47
    "Meta": {
48
        "DataModel": "Clinical Summary",
49
        "EventType": "DocumentQuery",
50
        "Message": {
51
            "ID": 12720346889
52
        },
53
        "Source": {
54
            "ID": "d9c19117-7778-47fd-9f55-b3bccc4055f8"
55
        },
56
        "Destinations": [
57
            {
58
                "ID": "ec745338-8849-43ad-a7ce-4bc5bf1d8b89",
59
                "Name": "Carequality Sandbox - XCA"
60
            }
61
        ],
62
        "Logs": [
63
            {
64
                "ID": "f30fbf24-5e3f-4503-b899-1fc247f0f996",
65
                "AttemptID": "2a215fde-a385-4f5a-bfb1-28a14e7a9605"
66
            }
67
        ]
68
    }
69
}

FHIR example: Successful response for a document list

json

1
{
2
    "resourceType": "Bundle",
3
    "type": "searchset",
4
    "total": 2,
5
    "entry": [
6
        {
7
            "resource": {
8
                "resourceType": "DocumentReference",
9
                "id": "Mi4xNi44NDAuMS4xMTM4ODMuMTkuNV5lOWMwZTYwZi1lNGZhLWRkNmQtYWY0OS0zZmU5NjdhMGYyNWY=^Mi4xNi44NDAuMS4xMTM4ODMuMy42MTQ3LjQ1OC44MDc5LjIuMi4x^dXJuOm9pZDoyLjE2Ljg0MC4xLjExMzg4My4zLjYxNDcuNDU4LjgwNzkuMi4yLjE=",
10
                "masterIdentifier": {
11
                    "system": "urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab",
12
                    "value": "2.16.840.1.113883.19.5^e9c0e60f-e4fa-dd6d-af49-3fe967a0f25f"
13
                },
14
                "status": "current",
15
                "category": {
16
                    "coding": [
17
                        {
18
                            "system": "2.16.840.1.113883.6.1",
19
                            "code": "34133-9"
20
                        }
21
                    ],
22
                    "text": "Summarization of episode note"
23
                },
24
                "subject": {
25
                    "type": "Patient",
26
                    "identifier": [
27
                        {
28
                            "system": "2.16.840.1.113883.3.6147.458.2",
29
                            "value": "4e6e9af5-9164-48ef-869b-53d901cd8d10"
30
                        }
31
                    ]
32
                },
33
                "description": "Summarization of episode note",
34
                "content": [
35
                    {
36
                        "attachment": {
37
                            "contentType": "text/xml",
38
                            "language": "en-US",
39
                            "title": "Summarization of episode note"
40
                        },
41
                        "format": "urn:ihe:iti:xds:2017:mimeTypeSufficient"
42
                    }
43
                ],
44
                "context": {
45
                    "encounter": [
46
                        {
47
                            "status": "planned",
48
                            "facilityType": {
49
                                "text": "General Medicine"
50
                            },
51
                            "practiceSetting": {
52
                                "text": "General Medicine"
53
                            }
54
                        }
55
                    ]
56
                }
57
            },
58
            "search": {
59
                "mode": "match"
60
            }
61
        },
62
        {
63
            "resource": {
64
                "resourceType": "DocumentReference",
65
                "id": "Mi4xNi44NDAuMS4xMTM4ODMuMTkuNV40MTM2ZWJhYS02ZTA5LTJhOTktYTg4ZS03NzBhNjRkZjM1NTU=^Mi4xNi44NDAuMS4xMTM4ODMuMy42MTQ3LjQ1OC44MDgwLjIuMi4x^dXJuOm9pZDoyLjE2Ljg0MC4xLjExMzg4My4zLjYxNDcuNDU4LjgwODAuMi4yLjE=",
66
                "masterIdentifier": {
67
                    "system": "urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab",
68
                    "value": "2.16.840.1.113883.19.5^4136ebaa-6e09-2a99-a88e-770a64df3555"
69
                },
70
                "status": "current",
71
                "category": {
72
                    "coding": [
73
                        {
74
                            "system": "2.16.840.1.113883.6.1",
75
                            "code": "34133-9"
76
                        }
77
                    ],
78
                    "text": "Summarization of episode note"
79
                },
80
                "subject": {
81
                    "type": "Patient",
82
                    "identifier": [
83
                        {
84
                            "system": "2.16.840.1.113883.3.6147.458.2",
85
                            "value": "4e6e9af5-9164-48ef-869b-53d901cd8d10"
86
                        }
87
                    ]
88
                },
89
                "description": "Summarization of episode note",
90
                "content": [
91
                    {
92
                        "attachment": {
93
                            "contentType": "text/xml",
94
                            "language": "en-US",
95
                            "title": "Summarization of episode note"
96
                        },
97
                        "format": "urn:ihe:iti:xds:2017:mimeTypeSufficient"
98
                    }
99
                ],
100
                "context": {
101
                    "encounter": [
102
                        {
103
                            "status": "planned",
104
                            "facilityType": {
105
                                "text": "General Medicine"
106
                            },
107
                            "practiceSetting": {
108
                                "text": "General Medicine"
109
                            }
110
                        }
111
                    ]
112
                }
113
            },
114
            "search": {
115
                "mode": "match"
116
            }
117
        }
118
    ]
119
}

Using Postman or curl, send the ClinicalSummary.DocumentGet request with the relevant metadata, like the document ID and type (from the response in the previous steps) and the organization OID (which goes in the Meta.FacilityCode field).

Less is more

Documents can only be retrieved one by one. We recommend retrieving only the most relevant documents, not every document on the list.

Data model example: Retrieve a document

bash

1
curl \
2
-X POST https://api.redoxengine.com/endpoint \
3
-H "Content-Type: application/json" \
4
-H "Authorization: Bearer {{access token}}" \
5
-d '{
6
    "Meta": {
7
        "Extensions": {
8
            "sender-organization-id": {
9
                "url": "https://api.redoxengine.com/extensions/sender-organization-id",
10
                # This should be the OID representing you as an organization. If you have multiple levels, it helps to be specific
11
                # but you can also just use your top-level
12
                "string": "{{organization_oid}}"
13
            },
14
            "user-id": {
15
                "url": "https://api.redoxengine.com/extensions/user-id",
16
                # This should change per query and should be a human-readable ID for the user (typically name, not an actual ID)
17
                "string": "{{user_human_readable_id}}"
18
            },
19
            "user-role": {
20
                "url": "https://api.redoxengine.com/extensions/user-role",
21
                # Depends on the user above, this is a SNOMED CT code
22
                # See here: https://www.hl7.org/fhir/valueset-practitioner-role.html
23
                "coding": {
24
                    "code": "{{user_role}}",
25
                    # This is set for the default code (112247003), but if you have a different code, this should change
26
                    "display": "Medical Doctor"
27
                }
28
            },
29
            "purpose-of-use": {
30
                "url": "https://api.redoxengine.com/extensions/purpose-of-use",
31
                # Almost ALWAYS treatment -> depends on the app purpose, but typically this is treatment
32
                # If it wasn't, other organizations on Carequality likely wouldn't respond
33
                # To use this, you have to participate in Carequality, which is why you also have to push data
34
                "coding": {
35
                    "code": "TREATMENT",
36
                    "display": "Treatment"
37
                }
38
            }
39
        },
40
        "DataModel": "Clinical Summary",
41
        "EventType": "DocumentGet",
42
        "EventDateTime": "2019-08-02T20:09:22.089Z",
43
        "Test": true,
44
        "Destinations": [
45
            {
46
                # This value is standard Redox Meta structure and will vary between environments
47
                # See the Carequality FAQ for Production values -- you're all set for sandbox testing
48
                "ID": "{{document_query_destination}}"
49
            }
50
        ],
51
        # This value represents what organization on Carequality should be searched.
52
        # The below is Redox here, but if you are coming from RLS, this should be the Organization OID-type ID from the location result
53
        # and non-RLS patient search should include the organization OID you found from the organization search
54
        "FacilityCode": "2.16.840.1.113883.3.6147.458.2"
55
    },
56
    "Document": {
57
        # This value will be the result of the previous document query result
58
        "ID": "{{DocumentID}}"
59
    }
60
}

FHIR example: Retrieve a document

bash

1
curl --location --request GET 'https://testapi.redoxengine.com/fhir/R4/ceq-xca:2.16.840.1.113883.3.6147.458.2/Development/DocumentReference/Mi4xNi44NDAuMS4xMTM4ODMuMTkuNV45MmNjZTU0YS0zYTlmLTYzNGEtNGQyMC03ZTU2NmVjYzMyYWI=^Mi4xNi44NDAuMS4xMTM4ODMuMy42MTQ3LjQ1OC44MDgwLjIuMi4x^dXJuOm9pZDoyLjE2Ljg0MC4xLjExMzg4My4zLjYxNDcuNDU4LjgwODAuMi4yLjE=' \
2
--header 'redox-source-id: 052efa1a-bf81-47f8-9ce9-f4f0a186f160' \
3
--header 'Authorization: Bearer <TOKEN>'
4
--header 'x-sender-organization-id: 2.16.840.1.113883.3.6147.458.7512.1.1.1' \
5
--header 'x-user-id: {{user-id}}' \
6
--header 'x-user-role: MEDICAL DOCTOR' \
7
--header 'x-purpose-of-use: TREATMENT' \

If the request is successful, you receive a synchronous ClinicalSummary.DocumentGetResponse with the relevant document of interest. The response always includes both the raw XML document data from the responding organization and our translated JSON, so you can easily parse and store the patient’s information. The translated JSON matches the Clinical Summary.VisitQueryResponse data model. Learn more about the response format. Alternatively, some organizations use the raw data with one of many public libraries to translate the XML into a readable UI.

Data model example (abbreviated): Successful document retrieval

json

1
"Meta": {
2
        "DataModel": "Clinical Summary",
3
        "EventType": "DocumentGet",
4
        "Message": {
5
            "ID": 12720346936
6
        },
7
        "Source": {
8
            "ID": "d9c19117-7778-47fd-9f55-b3bccc4055f8"
9
        },
10
        "Destinations": [
11
            {
12
                "ID": "ec745338-8849-43ad-a7ce-4bc5bf1d8b89",
13
                "Name": "Carequality Sandbox - XCA"
14
            }
15
        ],
16
        "Logs": [
17
            {
18
                "ID": "8ebf45b3-3c60-4d35-8f93-a1b754eded73",
19
                "AttemptID": "62dc89d4-6d59-418b-95b1-131fae7a721d"
20
            }
21
        ]
22
    },
23
      "Header": {
24
        "Document": {
25
            "Title": "C-CDA R2.1 Patient Record: Adolfo Kessler",
26
            "Visit": {
27
                "Location": null,
28
                "VisitNumber": "",
29
                "EndDateTime": "",
30
                "StartDateTime": ""
31
            },
32
            "Author": {
33
                "Location": {
34
                    "Facility": "MADISON ANESTHESIOLOGY CONSULTANTS, LLP"
35
                }
36
            },
37
            "ID": "2.16.840.1.113883.19.5^92cce54a-3a9f-634a-4d20-7e566ecc32ab",
38
            "TypeCode": {
39
                "AltCodes": [],
40
                "CodeSystemName": "LOINC",
41
                "CodeSystem": "2.16.840.1.113883.6.1",
42
                "Name": "Summarization of episode note",
43
                "Code": "34133-9"
44
            },
45
            "Type": "Summarization of episode note",
46
            "DateTime": "2020-12-10T17:09:50.000Z",
47
            "Locale": "US"
48
        },
49
        "Patient": {
50
            "Demographics": {
51
                "MaritalStatus": "",
52
                "Religion": "",
53
                "Ethnicity": "Not hispanic or latino",
54
                "Race": "White",
55
                "Address": {
56
                    "County": "",
57
                    "ZIP": "53711",
58
                    "Country": "",
59
                    "State": "Wisconsin",
60
                    "City": "Madison",
61
                    "StreetAddress": "602 Schiller Junction Suite 68"
62
                },
63
                "Sex": "Male",
64
                "SSN": "",
65
                "DOB": "2002-10-31T17:09:50.000Z",
66
                "EmailAddresses": [],
67
                "PhoneNumber": {
68
                    "Mobile": "",
69
                    "Office": "",
70
                    "Home": ""
71
                },
72
                "LastName": "Kessler",
73
                "FirstName": "Adolfo"
74
            },
75
            "Identifiers": [
76
                {
77
                    "IDType": "2.16.840.1.113883.19.5",
78
                    "ID": "j8p2NtTbAL7rTWRRhe7kSK"
79
                }
80
            ]
81
        }
82
    },
83
  "Data": "",
84
  "FileType": "text/xml",
85
  ...
86
}

FHIR example: Successful document retrieval

json

1
{
2
    "resourceType": "Bundle",
3
    "type": "searchset",
4
    "total": 1,
5
    "entry": [
6
        {
7
            "resource": [
8
                {
9
                    "resourceType": "Patient",
10
                    "id": "45e5fadd-0496-4e48-be26-a06d78f8e950^2.16.840.1.113883.3.6147.458.2",
11
                    "identifier": [
12
                        {
13
                            "value": "45e5fadd-0496-4e48-be26-a06d78f8e950",
14
                            "system": "2.16.840.1.113883.3.6147.458.2"
15
                        }
16
                    ],
17
                    "name": [
18
                        {
19
                            "given": [
20
                                "adolfo"
21
                            ],
22
                            "family": "kessler"
23
                        }
24
                    ],
25
                    "gender": "male",
26
                    "birthDate": "2002-10-31",
27
                    "telecom": [
28
                        {
29
                            "value": "5556533376",
30
                            "system": "phone",
31
                            "use": "mobile"
32
                        },
33
                        {
34
                            "value": "5556533376",
35
                            "system": "phone",
36
                            "use": "home"
37
                        }
38
                    ],
39
                    "address": [
40
                        {
41
                            "line": [
42
                                "602 schiller junction suite 68"
43
                            ],
44
                            "city": "madison",
45
                            "state": "WI",
46
                            "postalCode": 53711
47
                        }
48
                    ]
49
                }
50
            ],
51
            "search": {
52
                "mode": "match"
53
            }
54
        }
55
    ]
56
}

Next steps

Maintain your Redox repository

Redox Access resources

Basic information

What is Redox Access?
Identity and organization structure
Carequality FAQ
Carequality test patients (contains patient data for you to use when testing)

How-to

Troubleshooting

Common Carequality errors

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.