Version:- 11.0
MedicsCloud Ver 11.0 API program offers a comprehensive set of HL7 FHIR APIs that allow third party developers to build applications by querying the patient medical records from MedicsCloud EHR.
The APIs also support the Smart App Launch specification allowing the third-party applications to launch from inside or outside the MedicsCloud EHR user interface.
MedicsCloud EHR meet the ONC Health IT Certification Criteria requirements for Certified Electronic Health Records Technology published by Office of the National Coordinator (ONC).
1. Any modern development language such as Microsoft DOT NET 4.7+, Java/Kotlin, Python, etc The language should support bulding REST based applications with TLS 1.2+
2. SMART on FHIR US Core 6.1.0/USCDI v3, SMART App Launch 2.0.0 and Bulk Data v1.0.1 based implemation for accessing FHIR API
Production Endpoint s :-
Sandbox Endpoint s :-
Standalone App :- SMART on FHIR confidential client with a patient context, refresh token, and OpenID Connect (OIDC) identity token.
EHR Embedded app :- Demonstrate the ability to perform an EHR launch to a SMART on FHIR
Smart Backend Services App (Multi-patient authorization and API) :- These are server-to-server backend applications e.g. Export clinical data for multiple patients in a group. This app is system level app without any UI.
1.Patient Standalone
a.Full Access
b.Limited Access
2.Provider Launch App
1. Client App Registration
2. Retrieve .well-known/smart-configuration
3. Obtain authorization code
4. Obtain access token
5. Access FHIR API
6. Refresh Token to obtain new access token
Before a SMART app can run against an EHR, the app must be registered with that EHR's authorization service. We are using OAuth 2.0 Client Registration.
For regestration request, please send an email to softwaresupport@adsc.com with the following details.
Subject:- FHIR API Access Request
1. Email Address
2. First Name
3. Last Name
4. Job Title
5. Application Name
6. Application Details
7. Company Name
The application is created by the EHR admin after confirming the app's registration parameters and communicates a client_id to the app.
1. FHIR APIs (of any supported version) listed within the USCDI v3 core data set will be supported
2. Only reads data from FHIR server
Retrieve:- .well-known/smart-configuration
In order to obtain launch context and request authorization to access FHIR resources, the app discovers the EHR FHIR server's SMART configuration metadata, including OAuth authorization endpoint and token endpoint URLs.
FHIR server makes SMART configuration available from well-known endpoint. You can get Authorization end point and token endpoint.
Request:-
GET 200 :- https://[FHIRBaseURL]/.well-known/smart-configuration
Response:-
{
"resourceType": "Patient",
"id": "0D941BAF-282E-4F35-92E8-A5A43DCC1B08",
"meta": {
"versionId": "8",
"lastUpdated": "2026-04-01T07:07:48.6906299+00:00",
"source": "#PIcvWdRoC4KfvqWA",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"
]
},
"extension": [
{
"extension": [
{
"url": "ombCategory",
"valueCoding": {
"system": "urn:oid:2.16.840.1.113883.6.238",
"code": "",
"display": ""
}
},
{
"url": "text",
"valueString": ""
}
],
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
},
{
"extension": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode": "unknown"
}
],
"url": "ombCategory"
},
{
"url": "text",
"valueString": "Unknown"
}
],
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/patient-mothersMaidenName",
"valueString": ""
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex",
"valueCode": "M"
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex",
"valueCode": "248153007"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/patient-birthPlace",
"valueAddress": {
"city": "",
"state": "",
"country": ""
}
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity",
"valueCodeableConcept": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-NullFlavor",
"code": "ASKU",
"display": "asked but unknown"
}
]
}
}
],
"identifier": [
{
"system": "https://github.com/synthetichealth/synthea",
"value": "1212/12"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
],
"text": "Medical record number"
},
"system": "http://hospital.smarthealthit.org",
"value": "1212/12"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "SS"
}
],
"text": "Social Security number"
},
"system": "http://hl7.org/fhir/sid/us-ssn",
"value": ""
}
],
"name": [
{
"use": "official",
"family": "Wheeler",
"given": [
"Mike"
],
"prefix": [
"Mr."
],
"suffix": [
""
]
},
{
"use": "old",
"family": "Wheeler",
"given": [
""
],
"prefix": [
"Mr."
],
"period": {
"start": "1940-09-05",
"end": "1962-04-30"
}
}
],
"telecom": [
{
"system": "phone",
"value": "",
"use": "home"
}
],
"gender": "male",
"birthDate": "2000-02-22",
"deceasedDateTime": "1990-01-01",
"address": [
{
"extension": [
{
"extension": [
{
"url": "latitude",
"valueDecimal": 42.674176102041564
},
{
"url": "longitude",
"valueDecimal": -71.31980043648745
}
],
"url": "http://hl7.org/fhir/StructureDefinition/geolocation"
}
],
"line": [
""
],
"city": "",
"state": "",
"postalCode": "",
"country": "",
"period": {
"start": "2000-02-22"
}
},
{
"extension": [
{
"extension": [
{
"url": "latitude",
"valueDecimal": 42.081393355072365
},
{
"url": "longitude",
"valueDecimal": -71.67273379517337
}
],
"url": "http://hl7.org/fhir/StructureDefinition/geolocation"
}
],
"use": "old",
"line": [
""
],
"city": "",
"state": "",
"postalCode": "",
"country": ""
}
],
"maritalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
"code": "Unknown",
"display": "Unknown"
}
],
"text": "Unknown"
},
"multipleBirthBoolean": false,
"communication": [
{
"language": {
"coding": [
{
"system": "urn:ietf:bcp:47",
"code": "",
"display": ""
}
],
"text": ""
}
}
]
}
Error codes:-
JSON response is returned from the FHIR Server along with the code
200: Ok
401: Unauthorized
400: Bad Request
500: Internal Server Error
The app supplies the following parameters to the EHR's "authorize" endpoint
Parameters
|
response_type |
required |
Fixed value: code. |
|
Client_id |
required |
The client's identifier. |
|
redirect_url |
required |
Must match one of the client's pre-registered redirect URIs. |
|
launch |
conditional |
When using the EHR Launch flow, this must match the launch value received from the EHR. Omitted when using the Standalone launch. |
|
scope |
required |
Must describe the access that the app needs, including scopes like patient/*.rs, openid and fhirUser (if app needs authenticated patient identity) and either:
a launch value indicating that the app wants to receive already-established launch context details from the EHR
a set of launch context requirements in the form launch/patient, which asks the EHR to establish context on your behalf.
Please refer to the scopes supported in the table below |
|
state |
required |
An opaque value used by the client to maintain state between the request and callback. The authorization server includes this value when redirecting the user-agent back to the client. The parameter SHALL be used for preventing cross-site request forgery or session fixation attacks. The app SHALL use an unpredictable value for the state parameter with at least 122 bits of entropy (e.g., a properly configured random uuid is suitable). |
|
aud |
required |
URL of the EHR resource server from which the app wishes to retrieve FHIR data. This parameter prevents leaking a genuine bearer token to a counterfeit resource server. (Note that in the case of an EHR launch flow, this aud value is the same as the launch's iss value.) Note that the aud parameter is semantically equivalent to the resource parameter defined in RFC8707.
SMART's aud parameter predates RFC8707 and we have decided not to rename it for reasons of backwards compatibility.
We might consider renaming SMART's aud parameter in the future if implementer feedback indicates that alignment would be valuable. For the current release, servers SHALL support the aud parameter and MAY support a resource parameter as a synonym for aud. |
|
Scope |
Grants |
|
patient/*.read |
Permission to read and search any resource for the current patient (see notes on wildcard scopes below). |
|
user/*.read |
Permission to read and write all resources that the current user can access (see notes on wildcard scopes below). |
|
openid |
Permission to retrieve information about the current logged-in user. |
|
fhirUser |
|
|
launch |
Permission to obtain launch context when app is launched from an EHR. |
|
launch/patient |
When launching outside the EHR, ask for a patient to be selected at launch time. |
|
offline_access |
Request a refresh_token that can be used to obtain a new access token to replace an expired one, even after the end-user no longer is
online after the access token expires. |
Retrieve:- Authorization
Here's an example of an authorization request using HTTP GET. You will replace
the [redirect_uri], [client_id], [launch_token], [state], [code_challenge], and [audience] placeholders with your own values
Request:-
https://[FHIRBaseURL]/connect/authorize?response_type=code&client_id=app-client-id&redirect_uri=https%3A%2F%2Fapp%2Fafter-auth&launch=xyz123&scope=launch+patient%2FObservation.rs+patient%2FPatient.rs+openid+fhirUser&state=98wrghuwuogerg97&aud=https://[FHIRBaseURL]
Example:-
https://[FHIRBaseURL]/oauth/authorization?response_type=code&client_id=SAMPLE_CONFIDENTIAL_CLIENT_ID&redirect_uri=https%3A%2F%2Finferno.healthit.gov%2Finferno%2Foauth2%2Fstatic%2Fredirect&scope=launch/patient+openid+fhirUser+offline_access+patient/Medication.read+patient/AllergyIntolerance.read+patient/CarePlan.read+patient/CareTeam.read+patient/Condition.read+patient/Coverage.read+patient/Device.read+patient/DiagnosticReport.read+patient/DocumentReference.read+patient/Encounter.read+patient/Goal.read+patient/Immunization.read+patient/Location.read+patient/MedicationDispense.read+patient/MedicationRequest.read+patient/Observation.read+patient/Organization.read+patient/Patient.read+patient/Practitioner.read+patient/Procedure.read+patient/Provenance.read+patient/QuestionnaireResponse.read+patient/RelatedPerson.read+patient/ServiceRequest.read+patient/PractitionerRole.read+patient/Specimen.read&state=26a45e37-7445-4e4a-b8fb-24144eccbdc4&aud=https://inferno.healthit.gov/reference-server/r4
Response:-
The EHR's authorization server reviews the request from your application. If approved, the authorization server redirects the browser to the redirect URL supplied in the initial request and appends the following query string parameter.
Code:- This parameter contains the authorization code generated by EHR, which will be exchanged for the access token in the next step.
State:- The exact value received from the client.
after successfully authorize, theree different tokens will be generated
1. ID Token
2. Access Token
3. Refresh Token - can be used to get a new access and refresh token
Here is how redirect URL will look like
Location: https://app/after-auth?code=123abc&state=98wrghuwuogerg97
After receiving the authorization code, your application trades the code for a JSON object containing an access token and contextual information by sending an HTTP POST to the token endpoint using a Content-Type header with value of "application/x-www-form-urlencoded".
Error codes:-
JSON response is returned from the FHIR Server along with the code
200: Ok
401: Unauthorized
400: Bad Request
500: Internal Server Error
Retrieve:- Access Token
Request:-
https://[FHIRLaunchURL]/api/auth/token
Response :-
{"need_patient_banner":true,"smart_style_url":"https://fhir-launch.medicscloud.com/r6/smart_style_url.json","patient":"example","token_type":"bearer","scope":"launch/patient openid fhirUser offline_access patient/Medication.read patient/AllergyIntolerance.read patient/CarePlan.read patient/CareTeam.read patient/Condition.read patient/Device.read patient/DiagnosticReport.read patient/DocumentReference.read patient/Encounter.read patient/Goal.read patient/Immunization.read patient/Location.read patient/MedicationRequest.read patient/Observation.read patient/Organization.read patient/Patient.read patient/Practitioner.read patient/Procedure.read patient/Provenance.read patient/PractitionerRole.read","client_id":"fhirpatient-full","expires_in":3600,"id_token":"TOKEN","access_token":"ACCESS TOEKN","refresh_token":"REFRESH TOKEN","encounter":"example","user":"example"}
With a valid access token, the app can access protected EHR data by issuing a FHIR API call to the FHIR endpoint on the EHR's resource server.
Only HTTP GET request types are supported while accessing FHIR Resource API. Following resources are supported.
Patient
Allergy Intolerance
Care Plan
Care Team
Condition Encounter Diagnosis
Condition Problems and Health Concerns
Coverage
Implantable Device
Diagnostic Report for Report and Note exchange
Diagnostic Report for Laboratory Results Reporting
Document Reference
Encounter
Goal
Immunization
Medication Dispense
Medication Request
Observation
Smoking Status
Vitals
Procedure
Service Request
Organization
Practitioner
Provenance
RelatedPerson
Specimen
Clinical Notes Guidance
Screening Assessments
Request: -
Search Parameters:-
_id: GET [Base_URL]/Patient/_search?Patient=[id]
Identifier : GET [Base_URL]/Patient?identifier={system|}[code]
Name: GET [Base_URL]/Patient?name=[string]
birthdate + name :GET [Base_URL]/Patient?birthdate=[date]&name=[string]
gender + name : GET [Base_URL]/Patient?gender={system|}[code]&name=[string]
Example:-
Id:- https://[FHIRBaseURL]/Patient?_id=example
Name:- https://[FHIRBaseURL]/Patient?name=Chalmers
Identifier:- https://[FHIRBaseURL]/Patient?identifier=12345
Birthdate+Name:- https://[FHIRBaseURL]/Patient?birthdate=1974-12-25&name=Chalmers
Gender+Name:- https://[FHIRBaseURL]/Patient?gender=male&name=Chalmers
Response:-
{
"resourceType": "Bundle",
"id": "effee2ff-18dc-4865-89a9-027ed4e937f5",
"meta": {
"lastUpdated": "2026-04-07T04:13:13.0127426-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Patient?_id=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Patient",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "8",
"lastUpdated": "2026-04-07T08:13:13.0126027+00:00",
"source": "#PIcvWdRoC4KfvqWA",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"
]
},
"extension": [
{
"extension": [
{
"url": "ombCategory",
"valueCoding": {
"system": "urn:oid:2.16.840.1.113883.6.238",
"code": "2106-3",
"display": "White"
}
},
{
"url": "text",
"valueString": "White"
}
],
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
},
{
"extension": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode": "unknown"
}
],
"url": "ombCategory"
},
{
"url": "text",
"valueString": "Unknown"
}
],
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/patient-mothersMaidenName",
"valueString": "Arnetta Walker"
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex",
"valueCode": "M"
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex",
"valueCode": "248153007"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/patient-birthPlace",
"valueAddress": {
"city": "Brookline",
"state": "Massachusetts",
"country": "US"
}
},
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity",
"valueCodeableConcept": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-NullFlavor",
"code": "ASKU",
"display": "asked but unknown"
}
]
}
},
{
"extension": [
{
"url": "tribalAffiliation",
"valueCodeableConcept": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-TribalEntityUS",
"code": "338",
"display": "Native Village of Afognak"
}
],
"text": "Native Village of Afognak"
}
}
],
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation"
}
],
"identifier": [
{
"system": "https://github.com/synthetichealth/synthea",
"value": "8987/1"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
],
"text": "Medical record number"
},
"system": "http://hospital.smarthealthit.org",
"value": "8987/1"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "SS"
}
],
"text": "Social Security number"
},
"system": "http://hl7.org/fhir/sid/us-ssn",
"value": "999-47-5768"
}
],
"name": [
{
"use": "official",
"family": "BACON",
"given": [
"SJAMES"
],
"prefix": [
"Mr."
],
"suffix": [
"ALES"
]
},
{
"use": "old",
"family": "BACON",
"given": [
"JAMESSON"
],
"prefix": [
"Mr."
],
"period": {
"start": "1940-09-05",
"end": "1962-04-30"
}
}
],
"telecom": [
{
"system": "phone",
"value": "555-510-6254",
"use": "home"
}
],
"gender": "male",
"birthDate": "1987-10-22",
"deceasedDateTime": "1990-01-01",
"address": [
{
"extension": [
{
"extension": [
{
"url": "latitude",
"valueDecimal": 42.674176102041564
},
{
"url": "longitude",
"valueDecimal": -71.31980043648745
}
],
"url": "http://hl7.org/fhir/StructureDefinition/geolocation"
}
],
"line": [
"934 Olson Highlands"
],
"city": "Lowell",
"state": "MA",
"postalCode": "01854",
"country": "US",
"period": {
"start": "1987-10-22"
}
},
{
"extension": [
{
"extension": [
{
"url": "latitude",
"valueDecimal": 42.081393355072365
},
{
"url": "longitude",
"valueDecimal": -71.67273379517337
}
],
"url": "http://hl7.org/fhir/StructureDefinition/geolocation"
}
],
"use": "old",
"line": [
"508 Rempel Wall Suite 64"
],
"city": "Whitinsville",
"state": "MA",
"postalCode": "01588",
"country": "US"
}
],
"maritalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
"code": "M",
"display": "Married"
}
],
"text": "Married"
},
"multipleBirthBoolean": false,
"communication": [
{
"language": {
"coding": [
{
"system": "urn:ietf:bcp:47",
"code": "en-US",
"display": "English (United States)"
}
],
"text": "English (United States)"
}
}
]
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Allergy Intolerance
Request: -
Search Parameters:-
GET [Base_URL]/AllergyIntolerance?Patient=[id]
Example:-
https://[FHIRBaseURL]/AllergyIntolerance?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "b537b7b6-0635-4146-9980-c11abebe3a57",
"meta": {
"lastUpdated": "2026-04-01T02:19:46.4564798-04:00"
},
"type": "searchset",
"total": 10,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/AllergyIntolerance?patient=0D941BAF-282E-4F35-92E8-A5A43DCC1B08"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/AllergyIntolerance/0D941BAF-282E-4F35-92E8-A5A43DCC1B08",
"resource": {
"resourceType": "AllergyIntolerance",
"id": "0D941BAF-282E-4F35-92E8-A5A43DCC1B08",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-01T06:19:46.4567261+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance"
]
},
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
"code": "active"
}
]
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
"code": "confirmed"
}
]
},
"type": "allergy",
"category": [
"environment"
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "294507000",
"display": "Aspirin"
}
],
"text": "Aspirin"
},
"patient": {
"reference": "Patient/0D941BAF-282E-4F35-92E8-A5A43DCC1B08"
},
"recordedDate": "1941-10-14T18:33:18-05:00",
"reaction": [
{
"manifestation": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "267036007",
"display": "Shortness of breath"
}
],
"text": "Shortness of breath"
}
]
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request: -
Search Parameters:-
GET [Base_URL]/CarePlan/_search
GET [Base_URL]/CarePlan?category=assess-plan&patient=Patient/[id]
GET [Base_URL]/CarePlan?category=http://hl7.org/fhir/us/core/CodeSystem/careplan-category%7Cassess-plan&patient=[id]
Example:-
https://[FHIRBaseURL]/CarePlan?category=assess-plan&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "459985d5-2503-46f2-9462-228d303b86af",
"meta": {
"lastUpdated": "2026-04-07T04:13:17.8109822-04:00"
},
"type": "searchset",
"total": 6,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/CarePlan/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/CarePlan/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "CarePlan",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:17.8111071+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-careplan|6.1.0"
]
},
"text": {
"status": "generated",
"div": "<div xmlns='http://www.w3.org/1999/xhtml'><h3>Care Plan Summary</h3><p><b>ICD Code:</b> I10 - <b>Description:</b> Essential (primary) hypertension</p><p><b>ICD Code:</b> I10 - <b>Description:</b> Essential (primary) hypertension</p></div>"
},
"status": "completed",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/careplan-category",
"code": "assess-plan"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "59621000",
"display": "Essential (primary) hypertension"
}
],
"text": "Essential (primary) hypertension"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"period": {
"start": "1946-11-23T01:11:45-05:00",
"end": "1947-01-22T01:11:45-05:00"
},
"careTeam": [
{
"reference": "CareTeam/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"addresses": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"activity": [
{
"detail": {
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "J32.9",
"display": "236578006"
}
],
"text": "236578006"
},
"status": "completed",
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
}
}
]
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/CarePlan/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "CarePlan",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:17.8112328+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-careplan|6.1.0"
]
},
"text": {
"status": "generated",
"div": "<div xmlns='http://www.w3.org/1999/xhtml'><h3>Care Plan Summary</h3><p><b>ICD Code:</b> E11.29 - <b>Description:</b> Type 2 DM w KIDNEY complication</p><p><b>ICD Code:</b> E11.29 - <b>Description:</b> Type 2 DM w KIDNEY complication</p></div>"
},
"status": "completed",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/careplan-category",
"code": "assess-plan"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "443849008",
"display": "Type 2 DM w KIDNEY complication"
}
],
"text": "Type 2 DM w KIDNEY complication"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"period": {
"start": "1946-11-23T01:11:45-05:00",
"end": "1947-01-22T01:11:45-05:00"
},
"careTeam": [
{
"reference": "CareTeam/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"addresses": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"activity": [
{
"detail": {
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "R50.9",
"display": "386661006"
}
],
"text": "386661006"
},
"status": "completed",
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
}
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET [Base_URL]/CareTeam/_search
GET [Base_URL]/CareTeam?patient=[id]&status=active
GET [Base_URL]/CareTeam?patient=[id]&status= proposed
GET [Base_URL]/CareTeam?patient=[id]&status=suspended
GET [Base_URL]/CareTeam?patient=[id]&status=inactive
Example:-
https://[FHIRBaseURL]/CareTeam?patient=example&status=active
Response:-
{
"resourceType": "Bundle",
"id": "fde50766-b382-411d-b281-8c3e84348a8e",
"meta": {
"lastUpdated": "2026-04-07T04:13:19.9994418-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/CareTeam/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/CareTeam/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "CareTeam",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:19.999458+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-careteam"
]
},
"status": "active",
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"period": {
"start": "1974-04-12T02:42:45-04:00"
},
"participant": [
{
"role": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "79519003",
"display": "Somnolence"
}
],
"text": "Somnolence"
}
],
"member": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "Mr. SJAMES BACON"
}
},
{
"role": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "223366009",
"display": "Healthcare professional (occupation)"
}
],
"text": "Healthcare professional (occupation)"
}
],
"member": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "Mmereole Robert"
}
},
{
"role": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "224891009",
"display": "Healthcare services (qualifier value)"
}
],
"text": "Healthcare services (qualifier value)"
}
],
"member": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADSC"
}
},
{
"role": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "133932002",
"display": "Caregiver (person)"
}
],
"text": "Caregiver (person)"
}
],
"member": {
"reference": "RelatedPerson/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
}
],
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "88805009",
"display": "Chronic congestive heart failure (disorder)"
}
],
"text": "Chronic congestive heart failure (disorder)"
}
],
"managingOrganization": [
{
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADSC"
}
]
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Condition Encounter Diagnosis
Request:-
Search Parameters:-
GET [base]/Condition/_search
GET [base]/Condition?category=encounter-diagnosis&patient=[id]
GET [base]/Condition?category=encounter-diagnosis&patient=Patient/[id]
GET [base]/Condition?category=http://terminology.hl7.org/CodeSystem/condition-category%7Cencounter-diagnosis&patient=[id]
Example:-
https://[FHIRBaseURL]/Condition?category=encounter-diagnosis&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "432e1bd4-ef42-494e-92f9-960ff904acc7",
"meta": {
"lastUpdated": "2026-04-07T04:13:25.0166148-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Condition/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Condition",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:25.0166324+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition"
]
},
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "resolved"
}
]
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed"
}
]
},
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-category",
"code": "encounter-diagnosis",
"display": "Encounter Diagnosis"
}
]
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "59621000",
"display": "Essential (primary) hypertension"
}
],
"text": "Essential (primary) hypertension"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"onsetDateTime": "1951-09-04T01:11:45-04:00",
"abatementDateTime": "1951-09-18T01:11:45-04:00",
"recordedDate": "1951-09-04T01:11:45-04:00"
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Condition Encounter Diagnosis
Request:-
Search Parameters:-
GET [base]/Condition/_search
GET [base]/Condition?category=problem-list-item&patient=[id]
GET [base]/Condition?category=problem-list-item&patient=Patient/[id]
GET [base]/Condition?category=http://terminology.hl7.org/CodeSystem/condition-category%7Cproblem-list-item&patient=[id]
GET [base]/Condition?category=health-concern&patient=[id]
Example:-
https://[FHIRBaseURL]/Condition?category=problem-list-item&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "2eb6077d-3ee9-4555-98e4-48c8ec1df731",
"meta": {
"lastUpdated": "2026-04-07T04:13:27.319861-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Condition/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Condition",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:27.319878+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition"
]
},
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "resolved"
}
]
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed"
}
]
},
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-category",
"code": "encounter-diagnosis",
"display": "Encounter Diagnosis"
}
]
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "59621000",
"display": "Essential (primary) hypertension"
}
],
"text": "Essential (primary) hypertension"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"onsetDateTime": "1951-09-04T01:11:45-04:00",
"abatementDateTime": "1951-09-18T01:11:45-04:00",
"recordedDate": "1951-09-04T01:11:45-04:00"
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET [Base_URL]/Coverage/_search
GET [Base_URL]/ Coverage?patient= [id]
GET [Base_URL]/Coverage?patient=Patient/[id]
Example:-
https://[FHIRBaseURL]/Device?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "66a11738-280a-4f7a-b716-03a21a25535a",
"meta": {
"lastUpdated": "2026-04-07T04:13:29.931111-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Coverage?patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Coverage/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Coverage",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:29.9311287+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-coverage"
]
},
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MB"
}
]
},
"system": "https://github.com/inferno-framework/us-core-test-kit",
"value": "f4a375d2-4e53-4f81-ba95-345e7573b550"
}
],
"status": "active",
"type": {
"coding": [
{
"system": "https://nahdo.org/sopt",
"code": "3712",
"display": "PPO"
},
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "PPO",
"display": "preferred provider organization policy"
}
],
"text": "PPO"
},
"subscriberId": "888009335",
"beneficiary": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"relationship": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
"code": "self"
}
],
"text": "Self"
},
"period": {
"start": "2020-01-01"
},
"payor": [
{
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
],
"class": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/coverage-class",
"code": "group",
"display": "Group"
}
],
"text": "An employee group"
},
"value": "xyz",
"name": "XYZ employee Group Plan"
},
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/coverage-class",
"code": "plan",
"display": "Plan"
}
],
"text": "A specific suite of benefits."
},
"value": "gold",
"name": "Acme Gold Plan"
}
]
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Implantable Device Tests
Request:-
Search Parameters:-
GET [Base_URL]/ Device/_search
GET [Base_URL]/Device?patient=[id]
GET [Base_URL]/Device?patient=Patient/[id]
Example:-
https://[FHIRBaseURL]/Device?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "f1d38f42-ecdf-42e0-b1d6-56b5b86b6146",
"meta": {
"lastUpdated": "2026-04-07T04:13:31.5490189-04:00"
},
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Device/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Device/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Device",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:31.5490484+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device"
]
},
"udiCarrier": [
{
"deviceIdentifier": "DV644456",
"carrierAIDC": "iVBORw0KGgoAAAANSUhEUgAAAioAAAB2CAIAAABpgS9BAAADHUlEQVR42u3aXY+iMBiAUbrZ//+XuxcmpunXvkABNedczahAReWZdkxbIee8bVtK6f3zS3tLaXTv6/b5nttHtuMZHaW8JXJvu8/4GNp72+NGxhN5jvPnHn8tInubn4fIfiKjHZ35+fth1bM49g4/dpaOfWrOnMk7X829449/ciOfzcjrFX/FV73f4sfdexWdv8fOvB9G17T4FW/+WkfOw8ufDQBuJz8AyA8A8gMA8gOA/ACA/AAgPwAgPwDIDwDIDwDyA4D8AID8ACA/ACA/AMgPAMgPAPIDAPIDgPwAID8AID8AyA8AyA8A8gMA8gOA/ACA/AAgPwDIDwDIDwDyAwDyA4D8AID8ACA/ACA/AMgPAPIDAPIDgPwAgPwAID8AID8AyA8AyA8A8gOA/ACA/AAgPwAgPwDIDwDIDwDyAwDyA4D8ACA/ACA/AMgPAMgPAPIDAPIDgPwAgPwAID8AyA8AyA8A8gMA8gOA/ACA/AAgPwAgPwDIDwDyAwDyA4D8AID8ACA/ACA/AMgPAMgPAPIDgPw4BQDIDwDyAwDyA4D8AID8ACA/ACA/AMgPAMgPAPIDgPwAgPwAID8AID8AfJuUc3YWADD7AUB+AOACf50CrpBSqm65dJn3dbgDhyjHeWaEKS1bx141pAefAsgPT7rzWpZzboO3d5yfc/39wCHBchbfYGXDPmdIYPYDW/dv+fev3eWm93pa+bDycjy/4p9cwhoNafRzdZTJM9o1pPYo5eajExI/evdkPrX6h/zAstgEO9FtUtmeqkDdDYP7PJPJ4Bylu/mufXaLMip39Zj40bttO3nqQH54XnvZ6oZk19XtGy+FB8bcVme0k//uPHh0q3zID7/fpPlS1fK518LN29nY1UOqgn1Pm3UI+eEHtbOfdrXnqTnH1dOshV/svrQQVtu4h2++8UB7tqOrPccuu8GtRnOa6l/xB/6TtHxIVzx3MyHMfvid2ET+pp53qNpq/kWv97Jetc/gd+RGaQxuPj/62iHN5y7Bo1cns/yqoZkQd1wivL34xskT8O0svgFg9gOA2Q8AyA8Av+MfJjJq5w+06kcAAAAASUVORK5CYII="
}
],
"status": "active",
"distinctIdentifier": "DV644456",
"manufactureDate": "2025-09-16",
"expirationDate": "2026-09-17",
"lotNumber": "LT4567",
"serialNumber": "HY5543",
"deviceName": [
{
"name": "Implantable defibrillator, device (physical object)",
"type": "user-friendly-name"
}
],
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "43069338026389",
"display": "Implantable defibrillator, device (physical object)"
}
],
"text": "Implantable defibrillator, device (physical object)"
},
"patient": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/Device/63a4f9f1-0abd-4266-8849-5b28fb072176",
"resource": {
"resourceType": "Device",
"id": "8be84624-db6b-4aed-b6bb-51c7be3c0ab7",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:31.5490741+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device"
]
},
"udiCarrier": [
{
"deviceIdentifier": "DV644456",
"carrierHRF": "(01)DV644456(11)250916(17)260917(10)LT4567(21)HY5543"
}
],
"status": "active",
"distinctIdentifier": "DV644456",
"manufactureDate": "2025-09-16",
"expirationDate": "2026-09-17",
"lotNumber": "LT4567",
"serialNumber": "HY5543",
"deviceName": [
{
"name": "Implantable defibrillator, device (physical object)",
"type": "user-friendly-name"
}
],
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "43069338026389",
"display": "Implantable defibrillator, device (physical object)"
}
],
"text": "Implantable defibrillator, device (physical object)"
},
"patient": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Diagnostic Report for Report and Note exchange
Request:-
Search Parameters:-
patient : GET [Base_URL]/ DiagnosticReport/_search
patient : GET [Base_URL]/ DiagnosticReport?category=LP29684-5&patient= [id]
patient : GET [Base_URL]/ DiagnosticReport?category=LP29684-5&patient=Patient/ [id]
patient : GET [Base_URL]/ DiagnosticReport?category=http://loinc.org%7CLP29684-5&patient= [id]
patient : GET [Base_URL]/ DiagnosticReport?category=LP29708-2&patient= [id]
patient : GET [Base_URL]/DiagnosticReport?category=LP7839-6&patient= [id]
Example:-
https://[FHIRBaseURL]/DiagnosticReport?patient=example
https://[FHIRBaseURL]/DiagnosticReport?code=55233-1&patient=example
https://[FHIRBaseURL]/DiagnosticReport?category=LP29684-5&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "4c51ad09-aa5e-4cf1-8d44-1d882241ff66",
"meta": {
"lastUpdated": "2026-04-07T04:13:32.9754598-04:00"
},
"type": "searchset",
"total": 4,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/DiagnosticReport?category=LP29684-5&patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/DiagnosticReport/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DiagnosticReport",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:32.9754763+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note"
]
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LP29684-5",
"display": "Radiology"
}
],
"text": "Radiology"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "11506-3",
"display": "Progress note"
}
],
"text": "Progress note"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"effectiveDateTime": "1940-09-06T01:11:45-04:00",
"issued": "1940-09-06T01:11:45.131-04:00",
"performer": [
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
],
"result": [
{
"reference": "Observation/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"presentedForm": [
{
"contentType": "text/plain",
"data": "UGF0aWVudCBwcmVzZW50cyBmb3IgYSBmb2xsb3ctdXAgb24gZXNzZW50aWFsIGh5cGVydGVuc2lvbi4gSGUgcmVwb3J0cyBmZWVsaW5nICJnZW5lcmFsbHkgd2VsbCIgYnV0IG1lbnRpb25zIG9jY2FzaW9uYWwgbW9ybmluZyBoZWFkYWNoZXMgb3ZlciB0aGUgbGFzdCB0d28gd2Vla3MuIEhlIGFkbWl0cyB0byBtaXNzaW5nIHNldmVyYWwgZG9zZXMgb2YgaGlzIExpc2lub3ByaWwgZHVlIHRvIGEgYnVzeSB0cmF2ZWwgc2NoZWR1bGUuIE5vIGNoZXN0IHBhaW4sIHNob3J0bmVzcyBvZiBicmVhdGgsIG9yIGxvd2VyIGV4dHJlbWl0eSBlZGVtYSByZXBvcnRlZC4="
}
]
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Diagnostic Report for Laboratory Results Reporting
Request:-
Search Parameters:-
patient : GET [Base_URL]/DiagnosticReport/_search
patient : GET [Base_URL]/DiagnosticReport?category=LAB&patient=[id]
patient : GET [Base_URL]/DiagnosticReport?category=LAB&patient=Patient/[id]
GET [Base_URL]/DiagnosticReport?category=http://terminology.hl7.org/CodeSystem/v2-0074%7CLAB&patient=[id]
Example:-
https://[FHIRBaseURL]/DiagnosticReport?category=LAB&patient=example
https://[FHIRBaseURL]/DiagnosticReport?patient=example
https://[FHIRBaseURL]/DiagnosticReport?code=55233-1&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "6db9a2be-3973-40cb-b1ee-23325822f0da",
"meta": {
"lastUpdated": "2026-04-07T04:13:39.7204948-04:00"
},
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/DiagnosticReport?category=LAB&patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/DiagnosticReport/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DiagnosticReport",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:39.7205117+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-lab"
]
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0074",
"code": "LAB",
"display": "Laboratory"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "1438-1",
"display": "LEAD, BLOOD"
}
],
"text": "LEAD, BLOOD"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"effectiveDateTime": "2017-09-28T19:33:18-04:00",
"issued": "2017-09-28T19:33:18.715-04:00",
"performer": [
{
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
},
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
{
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"result": [
{
"reference": "Observation/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "Glucose [Mass/volume] in Blood"
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters :
patient : GET [Base_URL]/ DocumentReference?patient=[id]
patient + category + date : GET [Base_URL]/ DocumentReference?patient=[id]&category= History%20and%20Physical&date=[date]
patient + type : GET [Base_URL]/ DocumentReference?patient=[id]&type={system|}[code]
patient + category: GET [Base_URL]/ DocumentReference?patient=[id]&category= History%20and%20Physical
Example:
https://[FHIRBaseURL]/DocumentReference?patient=example
https://[FHIRBaseURL]/DocumentReference?category=History%20and%20Physical&patient=example
https://[FHIRBaseURL]/DocumentReference?patient=example&type=34108-1
Response:-
{
"resourceType": "Bundle",
"id": "42e16a35-e0ce-4e4e-adb6-75fc562d9f26",
"meta": {
"lastUpdated": "2026-04-07T04:13:48.8815251-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/DocumentReference/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8816805+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:acc9d16d-da9b-9dc9-fbb4-9e6f950b11e6"
}
],
"status": "superseded",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11506-3",
"display": "Progress note"
}
],
"text": "Progress note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "clinical-note",
"display": "Clinical Note"
}
]
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "1940-09-06T01:11:45.131-04:00",
"author": [
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
],
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
},
"content": [
{
"attachment": {
"contentType": "text/plain",
"data": "Tm8gZG9jdW1lbnQgYXR0YWNoZWQ6IEZpbGUgbm90IGZvdW5kIG9yIGRvd25sb2FkIGZhaWxlZC4="
},
"format": {
"system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
"code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
"display": "mimeType Sufficient"
}
}
],
"context": {
"encounter": [
{
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"period": {
"start": "2025-09-11T08:00:00-04:00",
"end": "2025-09-11T08:30:00-04:00"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8911699+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:acc9d16d-da9b-9dc9-fbb4-9e6f950b11e6"
}
],
"status": "superseded",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11506-3",
"display": "Progress note"
}
],
"text": "Progress note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "clinical-note",
"display": "Clinical Note"
}
]
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "1940-09-06T01:11:45.131-04:00",
"author": [
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
],
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
},
"content": [
{
"attachment": {
"contentType": "text/plain",
"data": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/KQovQ3JlYXRvciAo/v8AdwBrAGgAdABtAGwAdABvAHAAZABmACAAMAAuADEAMgAuADYpCi9Qcm9kdWNlciAo/v8AUQB0ACAANAAuADgALgA3KQovQ3JlYXRpb25EYXRlIChEOjIwMjYwMzA2MDYyNDUwLTA1JzAwJykKPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovU0EgdHJ1ZQovU00gMC4wMgovY2EgMS4wCi9DQSAxLjAKL0FJUyBmYWxzZQovU01hc2sgL05vbmU+MDAgbiAKMDAwMDA2ODcwMyAwMDAwMCBuIAowMDAwMDY4OTYxIDAwMDAwIG4gCjAwMDAwNzQyMTkgMDAwMDAgbiAKMDAwMDA3NDQ4OCAwMDAwMCBuIAowMDAwMDc0MTk4IDAwMDAwIG4gCjAwMDAwNzUxMzEgMDAwMDAgbiAKMDAwMDA3NTM4NCAwMDAwMCBuIAowMDAwMDc5MTQ2IDAwMDAwIG4gCjAwMDAwNzkzNzQgMDAwMDAgbiAKMDAwMDA3OTEyNSAwMDAwMCBuIAowMDAwMDc5OTUwIDAwMDAwIG4gCjAwMDAwODAyMDUgMDAwMDAgbiAKMDAwMDA5MTMwNSAwMDAwMCBuIAowMDAwMDkxNzI3IDAwMDAwIG4gCjAwMDAwOTEyODMgMDAwMDAgbiAKdHJhaWxlcgo8PAovU2l6ZSA1NgovSW5mbyAxIDAgUgovUm9vdCAyMSAwIFIKPj4Kc3RhcnR4cmVmCjkyNzQ2CiUlRU9GCg=="
},
"format": {
"system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
"code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
"display": "mimeType Sufficient"
}
}
],
"context": {
"encounter": [
{
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"period": {
"start": "2025-09-11T08:00:00-04:00",
"end": "2025-09-11T08:30:00-04:00"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912226+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11488-4",
"display": "Consultation note"
}
],
"text": "Consultation note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912303+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912316+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "18842-5",
"display": "Discharge summary"
}
],
"text": "Discharge summary"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912332+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.891234+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "34117-2",
"display": "Procedure note"
}
],
"text": "Procedure note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912372+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912382+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "28570-0",
"display": "Operative note"
}
],
"text": "Operative note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912397+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912404+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "18748-4",
"display": "History and physical"
}
],
"text": "History and physical"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912436+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912443+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11502-2",
"display": "Imaging report"
}
],
"text": "Imaging report"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912457+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:13:48.8912465+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11526-1",
"display": "Laboratory report"
}
],
"text": "Laboratory report"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:13:48.8912496+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Encounter?patient=[id]
Example:-
https://[FHIRBaseURL]/Encounter?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "48f3215a-2e95-4491-be9d-b28b65fafd42",
"meta": {
"lastUpdated": "2026-04-07T04:14:25.8819961-04:00"
},
"type": "searchset",
"total": 10,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Encounter?patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Encounter",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:25.882013+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter"
]
},
"identifier": [
{
"use": "official",
"system": "https://github.com/synthetichealth/synthea",
"value": "bde6e071-1c97-02ad-7e10-6d3102876755"
}
],
"status": "finished",
"class": {
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "AMB"
},
"type": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "59621000",
"display": "Essential hypertension"
}
],
"text": "Essential hypertension"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "Mr. SJAMES BACON"
},
"participant": [
{
"type": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
"code": "PPRF",
"display": "primary performer"
}
],
"text": "primary performer"
}
],
"period": {
"start": "1951-09-04T01:11:45-04:00",
"end": "1951-09-04T01:26:45-04:00"
},
"individual": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
}
],
"period": {
"start": "1951-09-04T01:11:45-04:00",
"end": "1951-09-04T01:26:45-04:00"
},
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "239872002",
"display": "Bilateral primary osteoarthritis of hip"
}
]
}
],
"hospitalization": {
"dischargeDisposition": {
"coding": [
{
"system": "http://www.nubc.org/patient-discharge",
"code": "01",
"display": "ADVICED HEALTHY FOOD CHOICES, REGULAR EXERCISE, WT LOSS TO PROVIDE CV HEALTH BENEFITS"
}
],
"text": "ADVICED HEALTHY FOOD CHOICES, REGULAR EXERCISE, WT LOSS TO PROVIDE CV HEALTH BENEFITS"
}
},
"location": [
{
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
}
],
"serviceProvider": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Goal?patient=[id]
Example:-
https://[FHIRBaseURL]/Goal?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "3bcc2566-7a77-4d95-8d95-f94b910ec9fd",
"meta": {
"lastUpdated": "2026-04-07T04:14:29.2702575-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Goal/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Goal/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Goal",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:29.2702753+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-goal"
]
},
"lifecycleStatus": "active",
"description": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "406162001",
"display": "asthma management"
}
],
"text": "asthma management"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"target": [
{
"dueDate": "2026-04-07"
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Immunization?patient=[id]
Example:-
https://[FHIRBaseURL]/Immunization?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "da6a494e-322c-4521-8c5b-2bc39c947c39",
"meta": {
"lastUpdated": "2026-04-07T04:14:30.6904266-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Immunization/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Immunization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Immunization",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:30.690443+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-immunization"
]
},
"status": "completed",
"statusReason": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"code": "OSTOCK",
"display": "product out of stock"
}
],
"text": "product out of stock"
},
"vaccineCode": {
"coding": [
{
"system": "http://hl7.org/fhir/sid/cvx",
"code": "141",
"display": "Influenza"
}
],
"text": "Influenza"
},
"patient": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"occurrenceDateTime": "2026-04-07T08:14:30.6904543+00:00",
"primarySource": true,
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Medication Dispensing
Request:-
Search Parameters:-
GET https://[Base_URL]/MedicationDispense?patient=[id]
Example:-
https://[FHIRBaseURL]/MedicationDispense/example
https://[FHIRBaseURL]/MedicationDispense?patient=example
https://[FHIRBaseURL]/MedicationRequest?intent=order&patient=example&status=active
Response:-
{
"resourceType": "Bundle",
"id": "4b8e8349-f028-4c9e-95a2-9e1abdc9e58d",
"meta": {
"lastUpdated": "2026-04-07T04:14:32.1108972-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/MedicationDispense/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/MedicationDispense/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationDispense",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:32.1109172+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationdispense"
]
},
"identifier": [
{
"system": "https://github.com/synthetichealth/synthea",
"value": "1d8ed63d-3d0e-8b03-4f1d-5a2d86abe786"
}
],
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "312362",
"display": "Phenobarbital 30 MG Oral Tablet"
}
],
"text": "Phenobarbital 30 MG Oral Tablet"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"performer": [
{
"actor": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
},
{
"actor": {
"reference": "PractitionerRole/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
}
],
"authorizingPrescription": [
{
"reference": "MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "Phenobarbital 30 MG Oral Tablet"
}
],
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "FFC",
"display": "First Fill - Complete"
}
]
},
"quantity": {
"value": 11,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
},
"whenHandedOver": "1975-04-07T02:51:45-04:00",
"dosageInstruction": [
{
"sequence": 1,
"text": "Take orally 1 ORAL TABLET Every 24 Hours for 11 Days.",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/MedicationRequest?patient=[id]
GET https://[Base_URL]/MedicationRequest?intent=proposal&patient=[id]
Example:-
https://[FHIRBaseURL]/MedicationRequest/example
https://[FHIRBaseURL]/MedicationRequest?intent=proposal&patient=example
https://[FHIRBaseURL]/MedicationRequest?intent=order&patient=example&status=active
Response:-
{
"resourceType": "Bundle",
"id": "67538c52-5bb6-4cfb-9b99-42f7d3a0d091",
"meta": {
"lastUpdated": "2026-04-07T04:14:34.321126-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/MedicationRequest/_search"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:34.3211459+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"
]
},
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community"
}
],
"text": "Community"
}
],
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "312362",
"display": "Phenobarbital 30 MG Oral Tablet"
}
],
"text": "Phenobarbital 30 MG Oral Tablet"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"authoredOn": "1977-05-13T01:11:45-04:00",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"reasonReference": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"dosageInstruction": [
{
"sequence": 1,
"text": "Take orally 1 ORAL TABLET Every 24 Hours for 11 Days.",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 11,
"unit": "tablets",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:34.3211698+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"
]
},
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community"
}
],
"text": "Community"
}
],
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "211322",
"display": "Remeron 15 MG Oral Tablet"
}
],
"text": "Remeron 15 MG Oral Tablet"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"authoredOn": "1977-05-13T01:11:45-04:00",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"reasonReference": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"dosageInstruction": [
{
"sequence": 1,
"text": "Take orally 1 ORAL TABLET Every 24 Hours for 11 Days For acute pain.",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 11,
"unit": "tablets",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:34.3211757+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"
]
},
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community"
}
],
"text": "Community"
}
],
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "9990108",
"display": "ASSURE PRO METER"
}
],
"text": "ASSURE PRO METER"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"authoredOn": "1977-05-13T01:11:45-04:00",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"reasonReference": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"dosageInstruction": [
{
"sequence": 1,
"text": "Apply on injury 1 LANCETS Every 24 Hours for 10 Days For acute pain exception.",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 11,
"unit": "tablets",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:34.321181+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"
]
},
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community"
}
],
"text": "Community"
}
],
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "1876810",
"display": "SIMLIYA 28 Day Pack"
}
],
"text": "SIMLIYA 28 Day Pack"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"authoredOn": "1977-05-13T01:11:45-04:00",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"reasonReference": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"dosageInstruction": [
{
"sequence": 1,
"text": "per day 1",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 11,
"unit": "tablets",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/MedicationRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "MedicationRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:14:34.3211864+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"
]
},
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community"
}
],
"text": "Community"
}
],
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "243670",
"display": "Aspirin 81 MG Oral Tablet"
}
],
"text": "Aspirin 81 MG Oral Tablet"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"authoredOn": "1977-05-13T01:11:45-04:00",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "steven smith M.D"
},
"reasonReference": [
{
"reference": "Condition/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"dosageInstruction": [
{
"sequence": 1,
"text": "Take orally 1 ORAL TABLET Every 24 Hours for 11 Days For acute pain.",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d"
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "tablet",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 11,
"unit": "tablets",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Observation?code=72166-2&patient=[id]
Example:-
https://[FHIRBaseURL]/Observation?code=72166-2&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "c504f694-aa1a-46a0-8238-a1cd7e2c3fe6",
"meta": {
"lastUpdated": "2026-04-07T04:15:25.9834439-04:00"
},
"type": "searchset",
"total": 38,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Observation?code=72166-2&patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Observation/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Observation",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:15:25.9834484+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus"
]
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "social-history",
"display": "Social History"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "72166-2",
"display": "Tobacco smoking status"
}
],
"text": "Tobacco smoking status"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"effectiveDateTime": "2026-04-07T03:22:21-04:00",
"issued": "2026-04-07T03:22:21-04:00",
"valueCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "449868002",
"display": "Current every day smoker"
}
],
"text": "Current every day smoker"
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
patient + code: GET https://[Base_URL]/Observation?code=85354-9&patient=[id]
patient + category + date : GET https://[Base_URL]/Observation?category=vital-signs&date=[ leYYYY-MM-DD] &patient=[id]
Example:-
https://[FHIRBaseURL]/Observation?code=77606-2&patient=example
https://[FHIRBaseURL]/Observation?category=vital-signs&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "e9d02dc4-44b9-49b7-ae0a-b9cace6095c2",
"meta": {
"lastUpdated": "2026-04-01T02:45:55.2673032-04:00"
},
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Observation?code=77606-2&patient=0D941BAF-282E-4F35-92E8-A5A43DCC1B08"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Observation/0D941BAF-282E-4F35-92E8-A5A43DCC1B08",
"resource": {
"resourceType": "Observation",
"id": "0D941BAF-282E-4F35-92E8-A5A43DCC1B08",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-01T06:45:55.2673304+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/pediatric-weight-for-height"
]
},
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "vital-signs",
"display": "Vital Signs"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "77606-2",
"display": "Weight-for-length Per age and sex"
}
],
"text": "Weight-for-length Per age and sex"
},
"subject": {
"reference": "Patient/0D941BAF-282E-4F35-92E8-A5A43DCC1B08"
},
"encounter": {
"reference": "Encounter/0D941BAF-282E-4F35-92E8-A5A43DCC1B08"
},
"effectiveDateTime": "2026-04-01T01:29:20-04:00",
"issued": "2026-04-01T01:29:20-04:00",
"valueQuantity": {
"value": 198,
"unit": "%",
"system": "http://unitsofmeasure.org",
"code": "%"
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Procedure?patient=[id]
Example:-
https://[FHIRBaseURL]/Procedure?patient=example
https://[FHIRBaseURL]/Procedure?date=2015-10-14T13:13:20-06:00&patient=example
Response:-
{
"resourceType": "Bundle",
"id": "500fd2d7-4acb-48b4-a006-99a8e554e976",
"meta": {
"lastUpdated": "2026-04-07T04:16:23.4537449-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Procedure?patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Procedure/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Procedure",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:23.453762+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-procedure"
]
},
"basedOn": [
{
"reference": "ServiceRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"status": "completed",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "236578006,59621000",
"display": "Cholestrol"
}
],
"text": "Cholestrol"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"performedDateTime": "1940-09-06T01:11:45-04:00",
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/Procedure/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "Procedure",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:23.4537957+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-procedure"
]
},
"basedOn": [
{
"reference": "ServiceRequest/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"status": "completed",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "386661006,443849008",
"display": "Heart Surgery"
}
],
"text": "Heart Surgery"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"performedDateTime": "1940-09-06T01:11:45-04:00",
"location": {
"reference": "Location/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/ServiceRequest?patient=[id]
GET https://[Base_URL]/ServiceRequest?patient=Patient/[id]
Example:-
https://[FHIRBaseURL]/ServiceRequest?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "438bd51c-75c7-4375-8197-074afd9d2c83",
"meta": {
"lastUpdated": "2026-04-07T04:16:27.5631602-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/ServiceRequest?patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/Procedure/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "ServiceRequest",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:27.563181+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-servicerequest"
]
},
"status": "completed",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "387713003",
"display": "Surgical procedure"
}
],
"text": "Surgical procedure"
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "236578006",
"display": "Cholestrol"
}
],
"text": "Cholestrol"
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"encounter": {
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"occurrencePeriod": {
"start": "2021-11-20",
"end": "2021-12-04"
},
"authoredOn": "2015-03-30",
"requester": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71908006",
"display": "Ventricular fibrillation (disorder)"
}
],
"text": "Bradycardia"
}
]
},
"search": {
"mode": "match"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/ Organization /[id]
Example:-
https://[FHIRBaseURL]/Organization/example
Response:-
{
"resourceType": "Organization",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:32.8893536+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization"
]
},
"identifier": [
{
"system": "https://github.com/synthetichealth/synthea",
"value": "56090ab7-1f97-37ff-a434-194f9c6e5510"
},
{
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1588617039"
},
{
"system": "urn:oid:2.16.840.1.113883.4.7",
"value": "12D4567890"
}
],
"active": true,
"type": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/organization-type",
"code": "prov",
"display": "Healthcare Provider"
}
],
"text": "Healthcare Provider"
}
],
"name": "ADS OFFICE",
"telecom": [
{
"system": "phone",
"value": "190-875-7972"
}
],
"address": [
{
"use": "work",
"line": [
"742 Evergreen Terrace"
],
"city": "Springfield",
"state": "OR",
"postalCode": "97477",
"country": "US"
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/ Practitioner/[id]
Example:-
https://[FHIRBaseURL]/Practitioner/example
Response:-
{
"resourceType": "Practitioner",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:33.3077214+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner|6.1.0"
]
},
"identifier": [
{
"system": "https://github.com/synthetichealth/synthea",
"value": "c38e2d6b-b2d5-3f8e-acae-3044eeb5edbb"
},
{
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1588617039"
}
],
"active": true,
"name": [
{
"family": "AMICO",
"given": [
"FRANK"
],
"prefix": [
"DR"
]
}
],
"telecom": [
{
"extension": [
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-direct",
"valueBoolean": true
}
],
"system": "email",
"value": "AMICO@MAILINATOR.COM",
"use": "work"
}
],
"address": [
{
"line": [
"742 Evergreen Terrace"
],
"city": "Springfield",
"state": "OR",
"postalCode": "97477",
"country": "US"
}
],
"gender": "female"
}
Request:-
Search Parameters:-
GET https://[Base_URL]/Provenance/[id]
Example:-
https://[FHIRBaseURL]/Provenance/example
Response:-
{
"resourceType": "Provenance",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:34.6200778+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-provenance|6.1.0"
]
},
"target": [
{
"reference": "DiagnosticReport/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
{
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
{
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"recorded": "2026-04-07T04:16:34.6200905-04:00",
"agent": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "author",
"display": "Author"
}
],
"text": "Author"
},
"who": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"onBehalfOf": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type",
"code": "transmitter",
"display": "Transmitter"
}
],
"text": "Transmitter"
},
"who": {
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
},
"onBehalfOf": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/ RelatedPerson/patient=[id]
Example:-
https://[FHIRBaseURL]/RelatedPerson?patient=example
Response:-
{
"resourceType": "RelatedPerson",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:38.1811726+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson|6.1.0"
]
},
"active": false,
"patient": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"relationship": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"code": "ROOM",
"display": "Roommate"
}
]
}
],
"name": [
{
"use": "official",
"family": "Jefferson",
"given": [
"Ronald",
"MacGyver"
],
"prefix": [
"Mr."
]
}
],
"telecom": [
{
"system": "phone",
"value": "(555)164-3435",
"use": "home"
}
],
"address": [
{
"extension": [
{
"extension": [
{
"url": "latitude",
"valueDecimal": 42.33734137767395
},
{
"url": "longitude",
"valueDecimal": -71.0633497363917
}
],
"url": "http://hl7.org/fhir/StructureDefinition/geolocation"
}
],
"line": [
"508 Rempel Wall Suite 64"
],
"city": "Whitinsville",
"state": "MA",
"postalCode": "01588",
"country": "US",
"period": {
"start": "2019-02-07"
}
}
]
}
Request:-
Search Parameters:-
GET https://[Base_URL]/ Specimen/[id]
Example:-
https://[FHIRBaseURL]/Specimen/example
Response:-
{
"resourceType": "Specimen",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:38.5812163+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-specimen"
]
},
"identifier": [
{
"system": "https://github.com/inferno-framework/us-core-test-kit",
"value": "82115a91-04c9-4654-acb5-72f2806e00fc"
}
],
"accessionIdentifier": {
"system": "https://github.com/inferno-framework/us-core-test-kit",
"value": "7446d969-3293-4f51-8d48-034121156b4e"
},
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "122575003",
"display": "Urine specimen (specimen)"
}
]
},
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"collection": {
"collectedDateTime": "2026-04-07T08:16:38.5812295+00:00",
"bodySite": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "106004",
"display": "Posterior carpal region"
}
]
}
},
"container": [
{
"identifier": [
{
"value": "ContainerID"
}
],
"type": {
"text": "Sterile urine specimen container (SNOMED: 702244006)"
}
}
],
"condition": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0493",
"code": "AUT",
"display": "Autolyzed"
}
]
}
]
}
Retrieve:- Clinical Notes Guidance
Request:-
Search Parameters:-
GET https://[Base_URL]/ DocumentReference/patient=[id]
Example:-
https://[FHIRBaseURL]/DocumentReference?patient=example
Response:-
{
"resourceType": "Bundle",
"id": "42e16a35-e0ce-4e4e-adb6-75fc562d9f26",
"meta": {
"lastUpdated": "2026-04-07T04:16:41.1063168-04:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/DocumentReference?patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"entry": [
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.106467+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:acc9d16d-da9b-9dc9-fbb4-9e6f950b11e6"
}
],
"status": "superseded",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11506-3",
"display": "Progress note"
}
],
"text": "Progress note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "clinical-note",
"display": "Clinical Note"
}
]
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "1940-09-06T01:11:45.131-04:00",
"author": [
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
],
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
},
"content": [
{
"attachment": {
"contentType": "text/plain",
"data": "Tm8gZG9jdW1lbnQgYXR0YWNoZWQ6IEZpbGUgbm90IGZvdW5kIG9yIGRvd25sb2FkIGZhaWxlZC4="
},
"format": {
"system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
"code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
"display": "mimeType Sufficient"
}
}
],
"context": {
"encounter": [
{
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"period": {
"start": "2025-09-11T08:00:00-04:00",
"end": "2025-09-11T08:30:00-04:00"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1134098+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:acc9d16d-da9b-9dc9-fbb4-9e6f950b11e6"
}
],
"status": "superseded",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11506-3",
"display": "Progress note"
}
],
"text": "Progress note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "clinical-note",
"display": "Clinical Note"
}
]
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "1940-09-06T01:11:45.131-04:00",
"author": [
{
"reference": "Practitioner/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "AMICO FRANK"
}
],
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
},
"content": [
{
"attachment": {
"contentType": "text/plain",
"data": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/KQovQ3JlYXRvciAo/v8AdwBrAGgAdABtAGwAdABvAHAAZABmACAAMAAuADEAMgAuADYpCi9Qcm9kdWNlciAo/v8AUQB0ACAANAAuADgALgA3KQovQ3JlYXRpb25EYXRlIChEOjIwMjYwMzA2MDYyNDUwLTA1JzAwJykKPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovU0EgdHJ1ZQovU00gMC4wMgovY2EgMS4wCi9DQSAxLjAKL0FJUyBmYWxzZQovU01hc2sgL05vbmU+MDAgbiAKMDAwMDA2ODcwMyAwMDAwMCBuIAowMDAwMDY4OTYxIDAwMDAwIG4gCjAwMDAwNzQyMTkgMDAwMDAgbiAKMDAwMDA3NDQ4OCAwMDAwMCBuIAowMDAwMDc0MTk4IDAwMDAwIG4gCjAwMDAwNzUxMzEgMDAwMDAgbiAKMDAwMDA3NTM4NCAwMDAwMCBuIAowMDAwMDc5MTQ2IDAwMDAwIG4gCjAwMDAwNzkzNzQgMDAwMDAgbiAKMDAwMDA3OTEyNSAwMDAwMCBuIAowMDAwMDc5OTUwIDAwMDAwIG4gCjAwMDAwODAyMDUgMDAwMDAgbiAKMDAwMDA5MTMwNSAwMDAwMCBuIAowMDAwMDkxNzI3IDAwMDAwIG4gCjAwMDAwOTEyODMgMDAwMDAgbiAKdHJhaWxlcgo8PAovU2l6ZSA1NgovSW5mbyAxIDAgUgovUm9vdCAyMSAwIFIKPj4Kc3RhcnR4cmVmCjkyNzQ2CiUlRU9GCg=="
},
"format": {
"system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
"code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
"display": "mimeType Sufficient"
}
}
],
"context": {
"encounter": [
{
"reference": "Encounter/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
],
"period": {
"start": "2025-09-11T08:00:00-04:00",
"end": "2025-09-11T08:30:00-04:00"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135408+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11488-4",
"display": "Consultation note"
}
],
"text": "Consultation note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135599+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135614+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "18842-5",
"display": "Discharge summary"
}
],
"text": "Discharge summary"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135635+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135642+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "34117-2",
"display": "Procedure note"
}
],
"text": "Procedure note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135672+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135686+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "28570-0",
"display": "Operative note"
}
],
"text": "Operative note"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135701+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135709+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "18748-4",
"display": "History and physical"
}
],
"text": "History and physical"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.113574+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.1135747+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11502-2",
"display": "Imaging report"
}
],
"text": "Imaging report"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135763+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "{FHIRBaseURL}/DocumentReference/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"resource": {
"resourceType": "DocumentReference",
"id": "05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"meta": {
"versionId": "1",
"lastUpdated": "2026-04-07T08:16:41.113577+00:00",
"profile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference"
]
},
"status": "current",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11526-1",
"display": "Laboratory report"
}
],
"text": "Laboratory report"
},
"category": [
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29708-2",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP7839-6",
"display": "Imaging"
}
],
"text": "Imaging"
},
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
"code": "LP29684-5",
"display": "Procedure"
}
],
"text": "Procedure"
}
],
"subject": {
"reference": "Patient/05F62592-723E-4D50-AE5F-DBC0496F2EFF"
},
"date": "2026-04-07T08:16:41.1135803+00:00",
"custodian": {
"reference": "Organization/05F62592-723E-4D50-AE5F-DBC0496F2EFF",
"display": "ADS OFFICE"
}
},
"search": {
"mode": "match"
}
}
]
}
Retrieve:- Screening Assessments Guidance
Request:-
Search Parameters:-
GET https://[Base_URL]/ Condition?category=health-concern&patient= [id]
GET https://[Base_URL]/ Condition?category=problem-list-item&patient= [id]
GET https://[Base_URL]/Observation?category=survey&patient=[id]
Example:-
https://[FHIRBaseURL]/ Condition ? category=health-concern& patient=example
Response:-
{
"resourceType": "Bundle",
"id": "1d62aac1-1003-41c3-b52f-70020364d42f",
"meta": {
"lastUpdated": "2026-03-02T06:53:13+00:00"
},
"type": "searchset",
"total": 0,
"link": [
{
"relation": "self",
"url": "{FHIRBaseURL}/Condition?category=health-concern&patient=05F62592-723E-4D50-AE5F-DBC0496F2EFF"
}
]
}
Terms of Use
1. TERMS ACCEPTANCE AND REPRESENTATION
a. Accepting the Terms. These Terms of Use ("Terms") govern your access to and use of the Certified MedicsCloud EHR ONC Health IT API, documentation, services, etc. By accessing or using the Certified MedicsCloud EHR APIs, you agree to be bound by these Terms. ““Certified MedicsCloud EHR API” means the API provided by MEDICSCLOUD EHR to allow authorized access to query our Client(s) Electronic Health Record system. You represent and warrant that you are at least 18 years of age and that you possess the legal right and ability to agree to these Terms and to use the Certified MedicsCloud EHR APIs in accordance with these Terms.
b. Entity Representation. If you are using the Certified MedicsCloud EHR API on behalf of a legal entity (i.e. a Clinical software services company), you represent that you have proper authority to act on behalf of and bind the entity to these Terms, and by accepting, you accept on behalf of the entity (and all references to ““you” in the Terms refer to the entity).
2. REPRESENTATIONS AND RESPONSIBILITIES
a. Compliance. You agree to be financially responsible for your use of the Certified MedicsCloud EHR EHR APIs and to comply with your responsibilities and obligations as stated in these Terms. You agree to comply at all times with all applicable laws, rules and regulations relating to the use of the Certified MedicsCloud EHR APIs. You hereby grant MedicsCloud EHR the right to monitor and periodically audit in a reasonable manner your use of the Certified MedicsCloud EHR APIs, your App and other activities related to your obligations under these Terms.
b. Virus Warranty. You warrant that your Apps will not contain any viruses or other malicious computer instructions, devices, or techniques that can or were designed to threaten, infect, damage, disable, or shut down the MedicsCloud EHR APIs, any technology, software, solution, equipment or any computer system.
3. GENERAL
a. Changes. MedicsCloud EHR may, in its sole and absolute discretion, make changes, modifications or updates to the Certified MedicsCloud EHR API (including without limitation changes to the capabilities and tech specs), without notice to you.
b. Global Availability. MedicsCloud EHR makes no representations that the Certified MedicsCloud EHR APIs are appropriate or available for use in locations outside of the United States, and access to them from such territories is at your own risk. Those who choose to access the Certified MedicsCloud EHR APIs from locations outside of the United States do so at their own initiative and are responsible for compliance with applicable local laws.
c. Intellectual Property Rights. You acknowledge and agree that the Certified MedicsCloud EHR EHR APIs and MedicsCloud EHR’s software, products and services are proprietary in nature, that MedicsCloud EHR claims all intellectual property rights therein as well as in all modifications, enhancements and alterations there to, and that MedicsCloud EHR neither grants nor otherwise transfers any rights of ownership therein to you or any third party. No rights or licenses are granted by MedicsCloud EHR other than those rights expressly granted in these Terms, and MedicsCloud EHR reserves all rights not expressly granted.
d. Waiver, Release and Limitation of Liability. You acknowledge and agree that neither MedicsCloud EHR nor any of its affiliates will have any responsibility or liability with respect to your or any third party’s distribution, implementation, commercialization, use, or other form of exploitation of any app, software, solution, service or other technology created by you or another third party. As between you and MedicsCloud EHR, you are solely responsible and liable for all representations, warranties, support and other obligations made by you to any third party related to any app, software, solution, service or other technology created by you, including claims arising from product liability, breach of warranty, and intellectual property infringement. YOU HEREBY RELEASE AND FOREVER WAIVE ANY AND ALL CLAIMS YOU MAY HAVE AGAINST MedicsCloud EHR, ITS OFFICERS, DIRECTORS, EMPLOYEES, AGENTS, INFORMATION PROVIDERS OR SUPPLIERS FOR LOSSES OR DAMAGES YOU SUSTAIN IN CONNECTION WITH YOUR USE OF THE CERTIFIED MedicsCloud EHR API AND ANY MedicsCloud EHR WEBSITES. MEDICSCLOUD EHR MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY, RELIABILITY, AVAILABILITY, TIMELINESS AND ACCURACY OF THE CERTIFIED MEDICSCLOUD EMR APIs OR OTHER INFORMATION, TECHNOLOGY, SOFTWARE, PRODUCTS AND SERVICES PROVIDED BY MedicsCloud EHR FOR ANY PURPOSE. ALL SUCH TECHNOLOGY, INFORMATION, SOFTWARE, PRODUCTS AND SERVICES ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MedicsCloud EHR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS WITH REGARD TO THE CERTIFIED MedicsCloud EHR APIs, OTHER TECHNOLOGY, INFORMATION, SOFTWARE, SOLUTIONS, PRODUCTS AND SERVICES, INCLUDING ALL IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. TO THE FULLEST EXTENT PERMITTED BY LAW, IN NO EVENT SHALL MedicsCloud EHR, ITS OFFICERS, DIRECTORS, EMPLOYEES, AGENTS, AND/OR ITS SUPPLIERS BE LIABLE FOR ANY DIRECT, INDIRECT, PUNITIVE, INCIDENTAL, SPECIAL, CONSEQUENTIAL DAMAGES OR ANY OTHER DAMAGES WHATSOEVER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF USE, DATA OR PROFITS, ARISING OUT OF OR IN ANY WAY CONNECTED WITH THE ACCESS, USE OR PERFORMANCE OF THE CERTIFIED MedicsCloud EHR APIs, WITH THE DELAY OR INABILITY TO USE THE CERTIFIED MedicsCloud EHR APIs OR RELATED TECHNOLOGY, SOFTWARE OR SERVICES, THE PROVISION OF OR FAILURE TO PROVIDE THE CERTIFIED MedicsCloud EHR APIs, SOFTWARE OR SERVICES, OR FOR ANY INFORMATION, SOFTWARE, PRODUCTS AND SERVICES OBTAINED FROM MedicsCloud EHR, OR OTHERWISE ARISING OUT OF THE USE OF THE CERTIFIED MedicsCloud EHR APIs, WHETHER BASED ON CONTRACT, TORT, NEGLIGENCE, STRICT LIABILITY OR OTHERWISE, EVEN IF MedicsCloud EHR HAS BEEN ADVISED OF THE POSSIBILITY OF DAMAGES. BECAUSE SOME STATES/JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU. IF YOU ARE DISSATISFIED WITH ANY PORTION OF THE CERTIFIED MedicsCloud EHR APIs, OR WITH THESE TERMS OF USE, YOUR SOLE AND EXCLUSIVE REMEDY IS TO DISCONTINUE USING THE CERTIFIED MedicsCloud EHR APIs. NOTWITHSTANDING THE FOREGOING PARAGRAPH, THE TOTAL LIABILITY OF MedicsCloud EHR, ITS OFFICERS, DIRECTORS, EMPLOYEES, AGENTS, INFORMATION PROVIDERS AND SUPPLIERS, IF ANY, FOR LOSSES OR DAMAGES SHALL NOT EXCEED THE FEES PAID BY YOU FOR THE USE OF THE PARTICULAR TECHNOLOGY, SOFTWARE, PRODUCT, INFORMATION OR SERVICE PROVIDED BY MedicsCloud EHR.
e. Indemnification. YOU AGREE TO INDEMNIFY, DEFEND AND HOLD HARMLESS MedicsCloud EHR, ITS OFFICERS, DIRECTORS, EMPLOYEES, AGENTS, INFORMATION PROVIDERS AND SUPPLIERS FROM AND AGAINST ALL CLAIMS, LIABILITIES, LOSSES, EXPENSES, DAMAGES AND COSTS, INCLUDING REASONABLE ATTORNEYS’ FEES, RESULTING FROM ANY VIOLATION OF THESE TERMS OR ANY ACTIVITY RELATED TO YOUR USE OF THE CERTIFIED MedicsCloud EHR APIS OR THE MedicsCloud EHR WEB SITES.
f. Term and Termination. Either you or MedicsCloud EHR may terminate your right to use the Certified MedicsCloud EHR APIs at any time, with or without cause, upon notice. MedicsCloud EHR also reserves the right to disable your API access in a production environment at any time, with or without cause. MedicsCloud EHR reserves the right to disable access to the MedicsCloud EHR APIs if your App poses any security, privacy, or patient safety risks. The provisions concerning Indemnification, Waiver, Release and Limitation of Liability, and General shall survive any termination of these Terms.
g. Governing Law. These Terms are governed by US federal law or the laws of the State of New Jersey.
h. Application developer affirmations to Certified API Developers regarding the ability of their applications to secure a refresh token, a client secret, or both, must be treated in a good faith manner.