Skip to main content

Products

Retrieve a paginated list of products available in a specific shop, filtered by market.

List Products

GET /v2/public/products/{shop_identifier}
shop_identifier
string
required
Unique identifier for the shop
market
string
required
Market identifier (e.g. DE for Germany)
Filter products and SKUs by name
page
integer
default:"0"
Page number (0-indexed)
limit
integer
default:"50"
Results per page (max 150)
Required permission: product:read

Example Request

curl -X GET "https://api.rxscale.com/v2/public/products/my-shop?market=DE&page=0&limit=25" \
  -H "X-API-Key: your-api-key-here"

Response

{
  "data": [
    {
      "uid": "prod-abc123",
      "display_name": "Medication X",
      "attributes": [
        {
          "key": "category",
          "value": "Pain Relief"
        }
      ],
      "skus": [
        {
          "uid": "sku-456",
          "display_name": "Medication X 100mg",
          "pzn": "12345678",
          "price": 1299
        },
        {
          "uid": "sku-789",
          "display_name": "Medication X 200mg",
          "pzn": "87654321",
          "price": 1999
        }
      ]
    }
  ],
  "totalRegistries": 42,
  "totalPages": 2
}

Response Fields

FieldTypeDescription
dataarrayList of product objects
data[].uidstringProduct UID
data[].display_namestringProduct display name
data[].attributesarrayProduct attributes (key-value pairs)
data[].skusarrayAvailable SKUs for this product in the given market
data[].skus[].uidstringSKU UID (use this when creating checkouts)
data[].skus[].pznstringPharmazentralnummer
data[].skus[].priceintegerPrice in euro cents
totalRegistriesintegerTotal number of matching products
totalPagesintegerTotal number of pages

Error Responses

Status CodeDescription
400Missing market query parameter
404Shop not found