> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/commerce-openapis/admin/product-price/list-product-prices.md).

# List product prices

Returns a paginated list of product-price records.

Narrow the list by record identifier or product with the query parameters below. Query parameters other than the ones listed are ignored.

```json
{"openapi":"3.1.0","info":{"title":"Admin API","version":"1.0.0"},"tags":[{"name":"Product Price","description":"Administrative endpoints for **product price** — the primary selling price of a product in the catalog. There is at most one price record per product (`product` is a one-to-one reference), holding the selling price, the currency, the tax rate, and an optional retail (original) price.\n\nAdditional per-seller or per-price-list prices are managed separately through the `extra_product_price` endpoints.\n\n## Core Capabilities\n\n**1. Listing & Filtering**\n* Retrieve a paginated list of product-price records.\n* Filter by record identifier (`id`) or by product identifier (`product`).\n* Order results with the `sort` parameter.\n\n**2. Full CRUD**\n* Create a price record for a product.\n* Retrieve a single record.\n* Fully or partially update a record.\n* Call `DELETE` to have the endpoint acknowledge the request without making any change — the record is **never removed** (see **Deleting a Product Price** below).\n\n**3. Bulk Upsert**\n* Create or update many records in one request through `POST /product_price/bulk_upsert/`.\n\n## Product Price Fields\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `pk` | integer | The unique identifier of the record. Read-only. |\n| `product` | integer | The identifier of the product this price belongs to. Required on create. One record per product; the product cannot be changed on update. |\n| `price` | string (decimal) | The selling price. A positive decimal with up to 12 digits and 2 decimal places. Required on create. |\n| `currency_type` | string | The ISO 4217 currency code (see **Currency Codes** below). Defaults to `try`. |\n| `tax_rate` | string (decimal) | The tax rate applied to the price. A decimal with up to 5 digits and 2 decimal places. |\n| `retail_price` | string (decimal) or `null` | The original or reference retail price. Optional; `null` when not set. |\n| `extra_field` | object | Free-form JSON for extra data. Optional; defaults to an empty object. |\n\n## Currency Codes\n\nThe `currency_type` field accepts the following ISO 4217 currency codes.\n\n| Value | Currency |\n|-------|----------|\n| `try` | Turkish Lira |\n| `eur` | Euro |\n| `usd` | US Dollar |\n| `egp` | Egyptian Pound |\n| `gbp` | Pound Sterling |\n| `mad` | Moroccan Dirham |\n| `pln` | Polish Zloty |\n| `sar` | Saudi Riyal |\n| `ron` | Romanian Leu |\n| `uah` | Ukrainian Hryvnia |\n| `czk` | Czech Koruna |\n| `huf` | Hungarian Forint |\n| `rub` | Russian Ruble |\n| `bgn` | Bulgarian Lev |\n| `iqd` | Iraqi Dinar |\n| `kwd` | Kuwaiti Dinar |\n| `bhd` | Bahraini Dinar |\n| `omr` | Omani Rial |\n| `qar` | Qatari Riyal |\n| `aed` | UAE Dirham |\n| `ngn` | Nigerian Naira |\n| `inr` | Indian Rupee |\n| `lei` | Romanian Leu (alternative code) |\n| `kzt` | Kazakhstani Tenge |\n| `jod` | Jordanian Dinar |\n| `rsd` | Serbian Dinar |\n| `amd` | Armenian Dram |\n| `cfa` | CFA Franc |\n| `lyd` | Libyan Dinar |\n\n## Deleting a Product Price\n\n> **Important:** `DELETE /product_price/{id}/` is a **no-op** — the endpoint returns `204 No Content` but the record is **not** modified and **not** removed. A price record cannot be deleted through the API.\n\n## Dynamic Settings & Environment Variables\n\nThe write endpoints are affected by the following dynamic setting, configured in the management panel. It is referenced again in the description of the operations it affects.\n\n| Key | Type | Default | Effect |\n|-----|------|---------|--------|\n| `GROUPED_PRODUCT_PRICE_SELECTOR` | string (dotted Python path) | `\"omnishop.catalogs.selector.group_product_min_price_selector\"` | Selects how a grouped product's representative price is computed from its children after a child price is written. Available selectors: `group_product_min_price_selector` (minimum), `group_product_max_price_selector` (maximum), `group_product_sum_price_selector` (sum). Does not affect read operations or non-grouped products. |\n\n**Environment variables:** No environment variables are read directly by these endpoints."}],"servers":[{"description":"Omnitron Remote Proxy (external access — recommended)","url":"https://{omnitron_url}/api/v1/remote/{channel_id}","variables":{"omnitron_url":{"default":"sandbox.akinon.com","description":"Omnitron server URL (e.g., {omnitron.akinon.com})"},"channel_id":{"default":"1","description":"The channel identifier the remote request is routed through"}}},{"description":"Commerce API Server (internal / direct access only)","url":"https://{commerce_url}/api/v1","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Internal commerce server URL, reachable only from within the Omnitron network"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token credential sent in the Authorization header, in the form: `Token <your-token>`. Requires a staff (admin) account."}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"The page number to return.","schema":{"type":"integer","default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"The number of items to return per page.","schema":{"type":"integer","default":10}},"sort":{"name":"sort","in":"query","required":false,"description":"Orders the results by one or more fields. Separate multiple fields with commas. Prefix a field with a hyphen (`-`) for descending order.","schema":{"type":"string"}}},"schemas":{"PaginatedProductPriceList":{"type":"object","description":"A paginated list of product-price records.","properties":{"count":{"type":"integer","description":"Total number of records matching the request."},"next":{"type":["string","null"],"format":"uri","description":"URL of the next page, or `null` if this is the last page."},"previous":{"type":["string","null"],"format":"uri","description":"URL of the previous page, or `null` if this is the first page."},"results":{"type":"array","description":"The product-price records on the current page.","items":{"$ref":"#/components/schemas/ProductPrice"}}}},"ProductPrice":{"type":"object","description":"A product-price record — the primary selling price of a single product.","properties":{"pk":{"type":"integer","readOnly":true,"description":"The unique identifier of the record."},"product":{"type":"integer","description":"The identifier of the product this price belongs to. One record per product."},"price":{"type":"string","format":"decimal","description":"The selling price. A positive decimal with up to 12 digits and 2 decimal places."},"currency_type":{"$ref":"#/components/schemas/ProductPriceCurrencyType"},"tax_rate":{"type":"string","format":"decimal","description":"The tax rate applied to the price. A decimal with up to 5 digits and 2 decimal places."},"retail_price":{"type":["string","null"],"format":"decimal","description":"The original or reference retail price. `null` when not set."},"extra_field":{"type":["object","null"],"description":"Free-form JSON for extra data."}}},"ProductPriceCurrencyType":{"type":"string","description":"An ISO 4217 currency code accepted by the product-price endpoints.","enum":["try","eur","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd","amd","cfa","lyd"]},"ValidationError":{"type":"object","description":"Returned when the request contains invalid or missing data. Errors are grouped by the field they apply to: each key is the name of a field from the request and its value is a list of one or more messages describing what is wrong with that field. Messages that do not belong to any single field are grouped under `non_field_errors`.","properties":{"non_field_errors":{"type":"array","description":"Error messages that apply to the request as a whole rather than to a specific field.","items":{"type":"string"}}},"additionalProperties":{"type":"array","description":"The list of error messages for the field named by the key.","items":{"type":"string"}}},"Error":{"type":"object","description":"An error response.","properties":{"detail":{"type":"string","description":"A human-readable description of the error."}},"additionalProperties":true}},"responses":{"ValidationError":{"description":"The request contains invalid or missing data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"Unauthorized":{"description":"Authentication credentials were not provided or are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The authenticated user does not have administrator privileges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/product_price/":{"get":{"tags":["Product Price"],"operationId":"listProductPrice","summary":"List product prices","description":"Returns a paginated list of product-price records.\n\nNarrow the list by record identifier or product with the query parameters below. Query parameters other than the ones listed are ignored.","parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/sort"},{"name":"id","in":"query","description":"Filter by the exact record identifier.","required":false,"schema":{"type":"integer"}},{"name":"product","in":"query","description":"Filter by the identifier of the related product.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A page of product-price records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedProductPriceList"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://apidocs.akinon.com/commerce-openapis/admin/product-price/list-product-prices.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
