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
Number of products per page
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: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": [...]
}