Fetch Allergies Linked to a Specific Drug Endpoint

Overview

This endpoint retrieves a list of allergies associated with a given drug, identified by its trade name or generic name. It is designed to aid healthcare providers in checking for potential allergic reactions when prescribing medication.

HTTP Request

GET https://www.britelink.io/api/v1/allergies

Headers

HeaderValueDescription
AuthorizationBearer BRITE_API_KEYThe API key for authorization.

Query Parameters

ParameterRequiredDescription
qYesThe trade name or generic name of the drug.

Response

The response is a JSON array of allergy objects formatted according to FHIR standards. Each object includes details of the allergy, cross-sensitivity, sensitive drugs, incidence rate, and the associated drug details.

Response Object

FieldTypeDescription
resourceTypeStringThe type of the FHIR resource, e.g., "AllergyIntolerance".
idStringThe unique identifier of the allergy.
clinicalStatusStringThe clinical status of the allergy.
verificationStatusStringVerification status of the allergy report.
typeStringThe type of the allergy, e.g., "allergy".
categoryArrayCategories of the allergy, e.g., ["medication"].
criticalityStringThe criticality of the allergic reaction.
codeObjectAn object containing the textual description of the allergy.
drugObjectAn object containing details of the associated drug.

Sample Response

[
  {
    "resourceType": "AllergyIntolerance",
    "id": "clqkksrze000d49c995nezd51",
    "clinicalStatus": "active",
    "verificationStatus": "unconfirmed",
    "type": "allergy",
    "category": ["medication"],
    "criticality": "low",
    "code": {
      "text": "Symptoms may include rash, swelling, itching, difficulty breathing, and severe dizziness. Anaphylaxis, a severe allergic reaction, is extremely rare."
    },
    "drug": {
      "id": "clqjl06p4000449l7qe6kop1g",
      "tradeName": "Tylenol",
      "genericName": "Acetaminophen"
    }
  }
]

Error Responses

Status CodeMessageDescription
400Search query is requiredThe trade name or generic name was not provided in the query parameter.
404No allergies found for the specified drugNo allergy records found for the given drug.
500An error occurred while fetching allergiesServer error or database connection issue.

Use Cases

  • Healthcare providers can use this endpoint to quickly identify potential allergic reactions to prescribed medications.
  • Pharmacists can verify allergy information for dispensing purposes.
  • Patients can use this to inform healthcare providers of known allergies.

Make sure to replace BRITE_API_KEY with the actual API key provided for authorization. The documentation can be further customized to include more details specific to your API's implementation and usage.