Pyrls API Reference

Authorization: Bearer YOUR_API_KEY

curl --location 'https://api.pyrls.com/v3/counseling?q=metoprolol&limit=5&mode=fuzzy' \
--header 'Authorization: Bearer YOUR_API_KEY'

{
  "data": {
    "id": "1",
    "genericName": "abacavir",
    "brandNames": ["Ziagen"],
    "counseling": [...]
  }
}

{
  "data": null
}

curl --location 'https://api.pyrls.com/v3/counseling/ndc/003784105' \
--header 'Authorization: Bearer YOUR_API_KEY'

"counseling": [
  {
    "section": "Proper Use",
    "data": [
      {
        "text": "<p>Take at the <strong>same time each day</strong>, with or without food</p>",
        "moreInfo": "<p>Food does not alter the bioavailability of lisinopril tablets or solution.</p>"
      }
    ]
  },
  {
    "section": "Side Effects",
    "data": [
      {
        "text": "<p><strong>Symptomatic</strong> hypotension (e.g. light-headedness) after starting therapy</p>",
        "moreInfo": "<p>Patients should be cautious in the <strong>first few days</strong> of therapy...</p>"
      }
    ]
  },
  {
    "section": "Warnings",
    "data": [
      {
        "text": "Avoid use of over-the-counter <strong>NSAIDs</strong> (e.g. ibuprofen, naproxen)",
        "moreInfo": "<p>Use of <strong>NSAIDs</strong> with ACE inhibitors may result in increased risk...</p>"
      }
    ]
  }
]

curl --location 'https://api.pyrls.com/v3/resources?q=glp1' \
--header 'Authorization: Bearer YOUR_API_KEY'

interface Image {
  id: string;
  title: string;
  description: string;
  image_url: string;
  width: number;
  height: number;
}

interface ResourceProperties {
  name: string;
  version: string;
  pdf_url: string;
  images: Image[];
}

interface PharmacotherapyResource {
  id: string;
  kind: string;
  labels: string[];
  keywords: string[];
  properties: ResourceProperties;
}

interface ScoredItem<T> {
  score: number;
  item: T;
}

interface ResourcesResponse {
  total: number;
  hasMore: boolean;
  results: ScoredItem<PharmacotherapyResource>[];
}

{
  "total": 2,
  "hasMore": false,
  "results": [
    {
      "score": 3,
      "item": {
        "id": "4",
        "kind": "chart",
        "labels": [
          "pharmacotherapy",
          "product_comparison",
          "dosing_guidance",
          "injectables",
          "endocrinology"
        ],
        "keywords": [
          "glp1",
          "gip_glp1",
          "receptor_agonist",
          "semaglutide",
          "tirzepatide",
          "liraglutide",
          "dulaglutide",
          "exenatide",
          "diabetes",
          "type_2_diabetes",
          "weight_management",
          "obesity"
        ],
        "properties": {
          "name": "GLP-1 and GIP/GLP-1 Receptor Agonist Chart",
          "version": "2025.11.16.1.0.0",
          "pdf_url": "https://firebasestorage.googleapis.com/...",
          "images": [
            {
              "id": "1",
              "title": "GLP-1 and GIP/GLP-1 Receptor Agonists Comparison",
              "description": "A chart comparing GLP-1 and dual GIP/GLP-1 receptor agonist medications",
              "image_url": "https://firebasestorage.googleapis.com/...",
              "width": 1500,
              "height": 1940
            }
          ]
        }
      }
    },
    {
      "score": 1,
      "item": {
        "id": "8",
        "kind": "chart",
        "labels": [
          "pharmacotherapy",
          "product_comparison",
          "dosing_guidance",
          "endocrinology",
          "diabetes"
        ],
        "keywords": [
          "diabetes",
          "type_2_diabetes",
          "t2dm",
          "pharmacotherapy",
          "metformin",
          "sglt2",
          "dpp4",
          "sulfonylurea",
          "thiazolidinedione",
          "glp1",
          "insulin",
          "a1c",
          "glycemic_control",
          "oral_antidiabetic"
        ],
        "properties": {
          "name": "Diabetes Pharmacotherapy Review",
          "version": "2026.01.01.1.0.0",
          "pdf_url": "https://firebasestorage.googleapis.com/...",
          "images": [
            {
              "id": "1",
              "title": "T2DM Pharmacotherapy Overview",
              "description": "Type 2 diabetes pharmacotherapy review including drug classes, mechanisms, efficacy, and place in therapy",
              "image_url": "https://cosmas-api.vercel.app/dm1.png",
              "width": 1500,
              "height": 1940
            },
            {
              "id": "2",
              "title": "T2DM Pharmacotherapy Continued",
              "description": "Type 2 diabetes pharmacotherapy review continued",
              "image_url": "https://cosmas-api.vercel.app/dm2.png",
              "width": 1500,
              "height": 1940
            }
          ]
        }
      }
    }
  ]
}

{
  "error": {
    "code": "validation_error",
    "status": 400,
    "message": "Request validation failed",
    "request_id": "req_abc123",
    "errors": [
      {
        "param": "limit",
        "code": "out_of_range",
        "message": "limit must be between 1 and 100"
      }
    ],
    "help_url": "",
    "retryable": false,
    "retry_after": null
  }
}

const response = await fetch('https://api.pyrls.com/v3/counseling?q=metoprolol', {
  headers: { Authorization: 'Bearer YOUR_API_KEY' }
});
const data = await response.json();

if (data.error) {
  switch (data.error.code) {
    case 'rate_limited':
      // Wait and retry
      await sleep(data.error.retry_after * 1000);
      return retry();

    case 'validation_error':
      // Show field-level errors to user
      data.error.errors.forEach(err => {
        showFieldError(err.param, err.message);
      });
      break;

    case 'unauthorized':
    case 'invalid_api_key':
      // Redirect to authentication
      redirectToLogin();
      break;

    default:
      // Log and show generic message
      console.error(`API Error [${data.error.request_id}]:`, data.error);
      showToast('Something went wrong. Please try again.');
  }
}