Pharmacy SKUs

Manage pharmacy SKU stock levels and pricing

Pharmacy SKUs

View and update your pharmacy’s product stock levels, pricing, and external system IDs.

List SKUs

GET /v1/external_pharmacy_api/pharmacy_skus/

page · integer · default: "0"

Page number (0-indexed)

limit · integer · default: "50"

Items per page. Capped at a maximum of 500 — values above 500 are silently reduced to 500.

pharmacy_uid · string

Required for group-wide API keys

Response

{
  "data": [
    {
      "uid": "psku-abc123",
      "external_id": "EXT-001",
      "price": 1299,
      "stock": 50,
      "pharmacy": "pharmacy-123",
      "sku": {
        "uid": "sku-456",
        "display_name": "Medication X 100mg",
        "pzn": "12345678",
        "product_uid": "prod-789",
        "product_display_name": "Medication X",
        "standard_selling_unit": 10.0,
        "unit": "g",
        "product_handle": "medication-x",
        "digital": false
      },
      "created_at": 1716200000,
      "updated_at": 1716203600,
      "deleted_at": null
    }
  ],
  "totalRegistries": 150,
  "totalPages": 3
}

The price field is in euro cents (e.g., 1299 = €12.99).

Hidden SKU types: Your account may be configured to hide SKUs of a particular type (digital or physical). SKUs of a hidden type are automatically excluded from this listing — they will not appear in the data array and are not counted in totalRegistries. This setting is off by default and is configured by your rxscale administrator. If you believe SKUs are missing from your listing, contact rxscale support.

Update SKU

If your account is configured to hide a SKU type, any attempt to update a pharmacy SKU of that hidden type — via PATCH /pharmacy_skus/{uid}, PATCH /pharmacy_skus/{uid}/stock, or PATCH /pharmacy_skus/{uid}/external_id — returns 404 Not Found. Check that the SKU appears in your GET /pharmacy_skus listing before attempting to update it.

Update price, stock, and/or external_id for a pharmacy SKU.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}

Request Body

All fields are optional — include only the fields you want to update.

{
  "price": 1499,
  "stock": 25,
  "external_id": "EXT-002"
}

Stock values may be negative (for example, -40) to represent oversold inventory in your own system.

Update Stock Only

A convenience endpoint to update only the stock level.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}/stock

{
  "stock": 100
}

Update External ID

Link a pharmacy SKU to your external system.

PATCH /v1/external_pharmacy_api/pharmacy_skus/{pharmacy_sku_uid}/external_id

{
  "external_id": "YOUR-SYSTEM-ID"
}