> For the complete documentation index, see [llms.txt](https://docs.esimpay.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.esimpay.net/eng/api/price-list.md).

# Price List

Current catalog with product IDs and prices.

Available packages and retail prices for the merchant.

## Get merchant price list

> \
> Returns the current package price list for the merchant.  \
> Requires authentication via the \`CF-MERCHANT-ID\` header.  \
> Returns a list of available packages with prices for this merchant.<br>

```json
{"openapi":"3.1.1","info":{"title":"API","version":"v1"},"tags":[{"name":"Price List","description":"Available packages and retail prices for the merchant."}],"servers":[{"url":"https://api.esimpay.net/api/v1"}],"paths":{"/customer/inventory":{"get":{"operationId":"get_price_list","summary":"Get merchant price list","description":"\nReturns the current package price list for the merchant.  \nRequires authentication via the `CF-MERCHANT-ID` header.  \nReturns a list of available packages with prices for this merchant.\n","parameters":[{"schema":{"type":"string"},"name":"CF-MERCHANT-ID","in":"header","description":"Merchant identifier for authentication","required":true}],"responses":{"200":{"description":"Price list retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"description":"Request status","type":"string"},"message":{"description":"Error message (null on success)","type":["string","null"]},"inventory":{"description":"Merchant package list","type":"array","items":{"type":"object","properties":{"productId":{"description":"Product identifier","type":"string"},"name":{"description":"Package name","type":"string"},"countrySet":{"description":"Country or region code","type":"string"},"includedCountries":{"description":"All countries included in the region","type":"array","items":{"type":"string"}},"sizeValue":{"description":"Data volume","type":"integer"},"sizeUnit":{"description":"Data volume unit (MB, GB)","type":"string"},"validitySize":{"description":"Validity duration","type":"integer"},"validityUnit":{"description":"Validity unit","type":"string"},"priceUsd":{"description":"Package retail price in USD","type":"number"},"reward":{"description":"Merchant reward in USD","type":["number","null"]},"rewardPercent":{"description":"Reward percent","type":["number","null"]}}}}}}}}},"401":{"description":"Authentication error or general error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"description":"Request status","type":"string"},"message":{"description":"Error description","type":"string"}}}}}}},"tags":["Price List"]}}}}
```