> 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/extra-product-price/list-extra-product-prices.md).

# List extra product prices

Returns a paginated list of extra product-price records.

Narrow the list by record identifier, product, or price list with the query parameters below.

```json
{"openapi":"3.1.0","info":{"title":"Admin API","version":"1.0.0"},"tags":[{"name":"Extra Product Price","description":"Administrative endpoints for **extra product price** — a per-price-list override price for a product. The primary selling price lives on `product_price` (one record per product); an extra product price adds a price for the same product in a **specific price list** (for example a marketplace-seller list, a B2B tier, or a per-currency list). A product may have many extra prices, but at most one per price list.\n\n## Core Capabilities\n\n**1. Listing & Filtering**\n* Retrieve a paginated list of extra product-price records.\n* Filter by record identifier (`id`), product (`product`), or price list (`price_list`).\n* Order results with the `sort` parameter.\n\n**2. Full CRUD**\n* Create an extra price for a product in a price list.\n* Retrieve a single record — by its identifier, or by the combined `{price_list_code}-{pk}` form (see **Addressing a 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 an Extra Product Price**).\n\n## Extra 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 priced product. Required on create. |\n| `price` | string (decimal) | The selling price, tax included. A 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** under **Product Price**). Defaults to `try`. Must match the currency of `price_list`. |\n| `tax_rate` | string (decimal) | The VAT rate applied to `price`, as a percentage. A decimal with up to 5 digits and 2 decimal places. Required on create. |\n| `retail_price` | string (decimal) or `null` | The original or reference retail price. Optional; `null` when not set. |\n| `price_list` | integer | The identifier of the price list this price belongs to. Required on create. |\n| `price_list_detailed` | object | Read-only expansion of `price_list` — its `pk`, `name`, `code`, and `currency`. |\n| `extra_field` | object | Free-form JSON for extra data. Optional; defaults to an empty object. |\n\nA record is unique per `(product, price_list)` pair: creating a second extra price for the same product in the same price list is rejected with a validation error.\n\n## Addressing a Record\n\nA single record can be addressed two ways: by its numeric identifier (`/extra_product_price/{pk}/`) or by the combined form `/extra_product_price/{price_list_code}-{pk}/`, where `{price_list_code}` is the `code` of the record's price list. The combined value is split on its **last** hyphen, so a price-list code that itself contains hyphens is supported.\n\n## Currency Consistency\n\nThe `currency_type` of an extra product price must equal the `currency` of its `price_list`. A mismatch is rejected with a `400` validation error on the `currency_type` field. This is enforced on both create and update; on update the effective values fall back to the record's current `price_list`/`currency_type` for any field not supplied.\n\n## Deleting an Extra Product Price\n\n> **Important:** `DELETE /extra_product_price/{id}/` is a **no-op** — the endpoint returns `204 No Content` but the record is **not** modified and **not** removed. An extra price cannot be deleted through the API.\n\n## Filtering & Ordering\n\n| Parameter | Match |\n|-----------|-------|\n| `id` | The record by its exact identifier. |\n| `product` | The related product by identifier (exact). |\n| `price_list` | The related price list by identifier (exact). |\n\nResults can be ordered with the `sort` parameter; prefix a field with a hyphen for descending order.\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\"` | After an extra price is written for a **simple** product that belongs to a grouped product, the grouped product's representative price is recomputed with the selected strategy. 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":{"PaginatedExtraProductPriceList":{"type":"object","description":"A paginated list of extra 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 extra product-price records on the current page.","items":{"$ref":"#/components/schemas/ExtraProductPrice"}}}},"ExtraProductPrice":{"type":"object","description":"An extra product-price record — a price for a product in a price list other than the primary one, typically a seller-specific or channel-specific price.","properties":{"pk":{"type":"integer","readOnly":true,"description":"The unique identifier of the record."},"product":{"type":"integer","description":"The identifier of the priced product."},"price":{"type":"string","format":"decimal","description":"The selling price, tax included."},"currency_type":{"$ref":"#/components/schemas/OrderItemCurrency"},"tax_rate":{"type":"string","format":"decimal","description":"The VAT rate applied to `price`, as a percentage."},"retail_price":{"type":["string","null"],"format":"decimal","description":"The recommended retail price, used to show a strike-through price."},"price_list":{"type":"integer","description":"The identifier of the price list this price belongs to."},"price_list_detailed":{"readOnly":true,"description":"The price list this price belongs to, expanded.","oneOf":[{"$ref":"#/components/schemas/PriceListSummary"},{"type":"null"}]},"extra_field":{"type":["object","null"],"description":"Free-form data carried on the price record. Snapshotted into the order item's `extra_field` as `price_extra_field` at creation."}}},"OrderItemCurrency":{"type":"string","description":"ISO 4217 currency code the order item's price is expressed in.","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"]},"PriceListSummary":{"type":"object","description":"The price list an extra product price belongs to.","properties":{"pk":{"type":"integer","readOnly":true,"description":"The unique identifier of the price list."},"name":{"type":"string","description":"The display name of the price list."},"code":{"type":["string","null"],"description":"The machine-readable code of the price list."},"currency":{"$ref":"#/components/schemas/OrderItemCurrency"}}},"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"}}}},"ExtraProductPricePageNotFound":{"description":"The requested page of the extra product-price list does not exist — the page number is beyond the last page or is not a number.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/extra_product_price/":{"get":{"tags":["Extra Product Price"],"operationId":"listExtraProductPrice","summary":"List extra product prices","description":"Returns a paginated list of extra product-price records.\n\nNarrow the list by record identifier, product, or price list with the query parameters below.","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"}},{"name":"price_list","in":"query","description":"Filter by the identifier of the related price list.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A page of extra product-price records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedExtraProductPriceList"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ExtraProductPricePageNotFound"}}}}}}
```


---

# 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/extra-product-price/list-extra-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.
