REST API

Power your internal tools with global pharmaceutical data.

Integrate cross-border product registrations, live pricing shifts, and predictive drug shortage signals directly into your ERP via a single, normalized JSON API.

JOIN THE DEVELOPER BETA EXPLORE THE ENDPOINTS

curl -X GET "https://api.pharmafootpath.com/v1/shortages/?country=HU&is_active=true" \
  -H "Authorization: Bearer sk_test_12345" \
  -H "Accept: application/json"

# Response: 200 OK
# 1 active shortage signal retrieved.

Core API Endpoints

Designed for speed and reliability. Build alerting systems, enrich your master data, and map international equivalents in seconds.

GET /api/v1/product_registrations/

Product Registrations Map

Resolve international cross-border complexities instantly. Provide a local registration number (e.g., a German PZN) and return all related registration codes across other markets, including the overarching EU-level code.

Parameters
`country`	Required
`reg_number`	Required
`page`	Optional
`page_size`	Optional

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "count": 3,
      "page_number": 1,
      "next": null,
      "previous": null,
      "results": [
        {
          "code": "EU/1/97/031/026",
          "country": {
            "name": "European Union",
            "code": "EU"
          }
        },
        {
          "code": "100125490",
          "country": {
            "name": "Poland",
            "code": "PL"
          }
        },
        {
          "code": "003689",
          "country": {
            "name": "Slovenia",
            "code": "SI"
          }
        }
      ]
    }
  ]
}

GET /api/v1/latest_prices/

Latest Prices

Fetch the most recent wholesale, ex-factory, and retail list prices for a specific product. Excellent for dynamic margin calculations. Each price node is flagged as actual or estimated and returned in local currency.

Parameters
`country`	Required
`reg_number`	Required

{
  "wholesale_price": "3116.57",
  "is_wholesale_price_estimated": true,
  "ex_factory_price": "3066.93",
  "is_ex_factory_price_estimated": false,
  "retail_price": "3676.76",
  "is_retail_price_estimated": true,
  "date": "2025-11-27",
  "country": {
    "name": "Belgium",
    "code": "BE"
  },
  "currency": "USD"
}

GET /api/v1/price_shifts/

Price Shifts (Alerting)

Designed for automated alerting systems. Surfaces products and markets with the most significant price volatility over a rolling 30-day window, eliminating the need to poll your entire product database individually.

Parameters
`country`	Required
`reg_number`	Required
`page`	Optional

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "wholesale_price": "3116.57",
      "is_wholesale_price_estimated": true,
      "ex_factory_price": "3066.93",
      "is_ex_factory_price_estimated": false,
      "retail_price": "3676.76",
      "is_retail_price_estimated": true,
      "date": "2025-11-27",
      "country": {
        "name": "Belgium",
        "code": "BE"
      },
      "currency": "USD"
    }
  ]
}

GET /api/v1/shortages/

Shortage Signals

Access active and historical drug shortage records. Ideal for feeding procurement risk models. Returns detailed data including expected end dates and root causes (e.g., manufacturing problems, active ingredient scarcity).

Parameters
`country`	Optional
`is_active`	Optional
`notification_date_before`	Optional
`notification_date_from`	Optional
`page`	Optional
`page_size`	Optional

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "count": 1,
      "page_number": 1,
      "next": null,
      "previous": null,
      "results": [
        {
          "name": "BEWIM 10 mg filmtabletta",
          "country": {
            "name": "Hungary",
            "code": "HU"
          },
          "registration_number": "OGYI-T-23424/03",
          "notification_date": "2026-06-24",
          "start_date": "2026-06-24",
          "expected_end_date": "2026-07-13",
          "reason": {
            "name": "Manufacturing Problem"
          }
        }
      ]
    }
  ]
}

Frequently Asked Questions

Our closed beta currently offers four primary endpoints: Product Registrations Map (cross-border code linking), Latest Prices (wholesale/retail), Price Shifts (30-day alerts), and Shortage Signals (current and historical records).

Yes. Our Registrations Map endpoint takes a local registration number (e.g., German PZN) and returns the overarching EU code alongside equivalents in other markets like Poland or Slovenia.

Pricing data is aggregated and normalized continuously from national registries and verified sources. The API returns the most recent timestamp alongside whether the price is an actual listed value or an algorithmic estimate based on market rules.

Our API is currently in a closed beta "Painted Door" phase. You can request access via our developer portal. Our data engineering team will review your use case and contact you regarding onboarding.

Ready to start building?

The PharmaFootpath API is currently in a closed beta with select enterprise partners. Request a sandbox API key to test the endpoints and explore our full documentation.

By requesting access, you agree to our Developer Terms of Service.