General Information
The connectivity of this FHIR endpoint is as follows:
- HTTP Method
- GET, POST
- URL Template
- https://portal.viewmymed.com/fhir/AllergyIntolerance?_id=token&
patient=reference& _count=number& date=date& status=token& _pretty=boolean& _revinclude=static - Supported OAuth 2.0 User Types
- Backend Systems, Clinicians or Administrative Users, Patients
- Operations Supported
- read search-type vread history-instance
- Scopes Supported
-
- patient/AllergyIntolerance
- user/AllergyIntolerance
- system/AllergyIntolerance
- system/*.read
- system/*.rs
- Profiles Supported
-
- Us Core Allergyintolerance
Request Parameters
The following fields and datatypes are the parameters for the request string. All fields are optional, however if no settings are set, all values will be exported up to the maximum count of 100
| Name (type) | Description (bindings) |
|---|---|
| _id (token) |
A single or comma separated list of AllergyIntolerance ids. It is a required field if the patient field is not given. |
| patient (reference) |
Who the allergyintolerance is for. It is a required field if the _id field is not given. |
| _count (number) |
The maximum number of results to return in a page. Not honored when '_id' is set. |
| date (date) |
A date or date range from which to find allergyintolerance. The 'date' parameter may be provided once without a prefix or time component to imply a date range or once without a prefix and with a time component to search for allergyintolerance at a specific time. Alternately it may be provided twice with 'le' and 'gt' prefixes to search for allergyintolerance within a specific range. The date prefix pair must create a closed range. |
| status (token) |
The overall status of the allergyintolerance. |
| _pretty (boolean) |
set to false to disable formatted output. |
| _revinclude (static) |
_revinclude parameter may be provided once with the value Provenance:target to pull the relevant Provenance information. Example: _revinclude=Provenance:target |
Returned Data Fields
The following fields and bindings are returned if valued
| Field (type) | Description (bindings) | Opt? |
|---|---|---|
| id (Id) |
Id |
|
| clinicalStatus (CodeableConcept) |
Status AllergyIntolerance Clinical Status Codes (http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical) |
|
| verificationStatus (CodeableConcept) |
If the allergy is on the patient's chart, this element specifies confirmed AllergyIntolerance Verification Status Codes (http://terminology.hl7.org/CodeSystem/allergyintolerance-verification) |
|
| patient (Reference) |
Reference to a patient resource for whom the allergy is relevant |
|
| encounter (Reference) |
Reference to a patient encounter for whom the allergy is relevant |
|
| reaction.manifestation (CodeableConcept) |
A single reaction the patient had to the substance. If unknown, the code 261665006 is utilized. SNOMED CT (http://snomed.info/sct) |
|
| onset (Period) |
If an allergy has a noted date or a resolved date, those dates are specified here |
|
| criticality (String) |
Refers to the risk of clinical harm of a reaction to the substance. If NKDA value shall be unable-to-assess. |
|
| recorder (Reference) |
Reference to the practitioner who updated the allergy |
|
| code (CodeableConcept) |
The allergy/intolerance name/codes SNOMED CT (http://snomed.info/sct) RxNorm (http://www.nlm.nih.gov/research/umls/rxnorm) Substance Code (http://hl7.org/fhir/ValueSet/substance-code) |
Default Patient Query
The following are live queries representative of a data request on our sandbox environment.
Headers
Accept: application/fhir+json Authorization: <OAuth2 Bearer Token>
Request
GET https://portal.viewmymed.com/fhir/AllergyIntolerance?patient=99999.122753-00&_count=1
HTTP/1.0 200 OK
Cache-Control: no-cache, private
Content-Type: application/fhir+json
Date: Mon, 02 Feb 2026 13:39:07 GMT
Etag: W/"1"
{
"resourceType": "Bundle",
"id": "6980a8fb5c2156980a8fb5c216",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://portal.viewmymed.com/api/AllergyIntolerance"
}
],
"entry": [
{
"fullUrl": "https://portal.viewmymed.com/fhir/AllergyIntolerance/0e43ec556f1f60074f7b9f8830d52f30",
"resource": {
"resourceType": "AllergyIntolerance",
"type": "allergy",
"id": "0e43ec556f1f60074f7b9f8830d52f30",
"meta": {
"versionId": "0e43ec556f1f60074f7b9f8830d52f30",
"lastUpdated": "2023-01-26T06:33:04+00:00"
},
"clinicalStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
"code": "active",
"display": "active"
}
],
"text": "active"
},
"verificationStatus": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
"code": "confirmed",
"display": "Confirmed"
}
],
"text": "Active"
},
"patient": {
"reference": "Patient/99997.122753-00"
},
"encounter": {
"reference": "Encounter/fb9f088c689044da7a617c6ae144be05"
},
"reaction": [
{
"manifestation": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "261665006",
"display": "Unknown"
}
],
"text": "Unknown"
}
],
"exposureRoute": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode": "unknown"
}
]
}
}
],
"text": {
"status": "generated",
"div": "Name: NONE
\nReaction:
\nSeverity:
\nStatus: Active
\n"
},
"onsetDateTime": "2023-01-20T00:00:00+00:00",
"criticality": "unable-to-assess",
"recorder": {
"reference": "Practitioner/005f82e80d1d738e38ae796703ddd8b5",
"display": "Fenderson, Howard"
},
"code": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-NullFlavor",
"code": "NI",
"display": "NoInformation",
"userSelected": false
}
],
"text": "Name: NONE Reaction: Severity: Status: Active"
}
}
}
]
}
Error Codes / Outcomes
All endpoints share the same error codes and common outcomes.