> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SKUs

> Create, read, update, and delete SKUs via the Management API

# SKUs

Manage SKUs that belong to products in your organisation.

**Read permission:** `product:read`\
**Write permission:** `product:write`

## List SKUs

```bash theme={null}
GET /v1/management/skus
```

<ParamField query="page" type="integer" default="0">
  Page number (0-indexed)
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Number of SKUs per page
</ParamField>

<ParamField query="search" type="string">
  Prefix search on SKU display name, PZN, or product display name
</ParamField>

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/skus?limit=25" \
  -H "X-API-Key: your-api-key-here"
```

```json theme={null}
{
  "data": [
    {
      "uid": "sku-456",
      "display_name": "Medication X 100mg",
      "pzn": "12345678",
      "digital": false,
      "product_uid": "prod-abc123"
    }
  ],
  "totalRegistries": 12,
  "totalPages": 1
}
```

## Create SKU

```bash theme={null}
POST /v1/management/skus
```

`product_uid` and `display_name` are required. Optional fields include `pzn`, `digital`, `dosage`, `unit`, `pcs`, `weight`, `therapy_duration`, `standard_selling_unit`, `prescription_name`, and `skip_for_pharmacy_orders`.

```bash theme={null}
curl -X POST "https://api.rxscale.com/v1/management/skus" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "product_uid": "prod-abc123",
    "display_name": "Medication X 100mg",
    "pzn": "12345678",
    "digital": false
  }'
```

Returns HTTP 201.

## Get / Update / Delete SKU

```bash theme={null}
GET    /v1/management/skus/{sku_uid}
PATCH  /v1/management/skus/{sku_uid}
DELETE /v1/management/skus/{sku_uid}
```

PATCH accepts a subset of SKU fields. `display_name`, `digital`, and `skip_for_pharmacy_orders` cannot be set to `null`.

Delete returns HTTP 204. The SKU is soft-deleted.