Get Boxed Warnings of A Drug

HTTP Method: GET

URL: https://www.britelink.io/api/v1/drugs/{drugId}/warnings

This endpoint retrieves all boxed warnings associated with a specific drug, identified by its unique drug ID.

URL Parameters:

  • drugId: The unique identifier of the drug for which boxed warnings are to be retrieved.

Response Structure:

The response is a JSON array where each element represents a boxed warning associated with the drug. Each warning contains the following fields:

  • kind: The type or category of the warning.
  • recommendation: Recommended actions or precautions.
  • lab_values: List of lab values relevant to the warning (if any).
  • route: List of routes of administration related to the warning (if any).
  • dose_form: List of dose forms related to the warning (if any).
  • risk: An object containing information about the risk factor associated with the warning, including:
    • name: Name of the risk factor.
    • briteLinkId: Drug identifier for the risk factor.
    • meddra_id: Medical Dictionary for Regulatory Activities (MedDRA) identifier.
    • snomed_id: SNOMED Clinical Terms (CT) identifier.
    • icd10_id: International Classification of Diseases (ICD-10) identifier.

Request Example:

curl -X GET 'https://www.britelink.io/api/v1/drugs/{drugId}/warnings' \
-H 'Authorization: Bearer {apikey}'

Response Example:

[
  {
    "kind": "Hepatotoxicity",
    "recommendation": "Monitor liver function regularly",
    "lab_values": [],
    "route": [],
    "dose_form": [],
    "risk": {
      "name": "Liver Failure",
      "drugbank_id": "BAP0031848",
      "meddra_id": "pt/10019663",
      "snomed_id": "c/235883002",
      "icd10_id": "c/K72.9"
    }
  }
  // Additional warnings...
]

Use Case

Who Should Use This Endpoint:

  • Healthcare professionals seeking detailed warning information for specific medications.
  • Pharmacists verifying boxed warnings for prescription drugs.
  • Medical researchers analyzing drug safety profiles.
  • Health applications integrating drug safety data.

Applicable Scenarios:

  • A pharmacist wants to inform a patient about the potential risks and safety precautions associated with a prescribed medication.
  • A healthcare provider is reviewing a patient's medication regimen and needs to be aware of any severe warnings for each drug.
  • A medical research project requires the collection of boxed warning data for a set of drugs for analysis.