Products

List products and SKUs via the Management API

Products

Retrieve a paginated list of all products for your organisation, including connected SKUs, shop SKUs, shop products, and pharmacy SKUs.

List Products

GET /v1/management/products

page · integer · default: "0"

Page number (0-indexed)

limit · integer · default: "50"

Number of products per page

Required permission: product:read

Example Request

curl -X GET "https://api.rxscale.com/v1/management/products?page=0&limit=25" \
  -H "X-API-Key: your-api-key-here"

Response

{
  "products": [
    {
      "uid": "prod-abc123",
      "display_name": "Medication X",
      "skus": [
        {
          "uid": "sku-456",
          "display_name": "Medication X 100mg",
          "pzn": "12345678",
          "shop_skus": [
            {
              "uid": "ssku-789",
              "shop_uid": "shop-001",
              "external_id": "shopify-variant-123"
            }
          ],
          "pharmacy_skus": [
            {
              "uid": "psku-012",
              "pharmacy_uid": "ph-xyz",
              "price": 1299,
              "stock": 50,
              "external_id": "EXT-001"
            }
          ]
        }
      ],
      "shop_products": [
        {
          "uid": "sp-345",
          "shop_uid": "shop-001",
          "external_id": "shopify-product-456"
        }
      ]
    }
  ],
  "totalRegistries": 42,
  "totalPages": 2
}

Response Fields

Field	Type	Description
products	array	List of product objects
products[].uid	string	Product UID
products[].display_name	string	Product display name
products[].skus	array	SKUs belonging to this product
products[].skus[].pzn	string	Pharmazentralnummer (German pharmaceutical ID)
products[].skus[].pharmacy_skus	array	Pharmacy-specific SKU data (price, stock)
totalRegistries	integer	Total number of products
totalPages	integer	Total number of pages for the given limit

The price field on pharmacy SKUs is in euro cents (e.g., 1299 = 12.99 EUR).

Get Product Details

GET /v1/management/products/{product_uid}

product_uid · string · required

The product UID

Required permission: product:read

Example Request

curl -X GET "https://api.rxscale.com/v1/management/products/prod-abc123" \
  -H "X-API-Key: your-api-key-here"

Response

Returns the same product structure as the list endpoint, but for a single product including all connected SKUs, shop SKUs, shop products, and pharmacy SKUs.

{
  "uid": "prod-abc123",
  "display_name": "Medication X",
  "skus": [...],
  "shop_products": [...]
}