> 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/products/product-advanced/retrieve-a-single-active-simple-product.md).

# Retrieve a single active simple product

Returns the advanced representation of a single active simple product.

Pass `segment` to retrieve prices and stock from a specific segment's price list and stock list. See the list operation for full details on segment-aware pricing.

```json
{"openapi":"3.1.0","info":{"title":"Admin API","version":"1.0.0"},"tags":[{"name":"Product Advanced","description":"Read-only product list with segment-aware pricing and stock.\n\nRetrieve a lightweight, read-only list of active simple products enriched with segment-specific pricing, stock, and currency. Pass a segment identifier to resolve prices and stock quantities from the price list and stock list associated with that segment."}],"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."}},"schemas":{"ProductAdvanced":{"type":"object","description":"An active simple product with segment-aware price, stock, currency, main category, first image, and variant attribute values.","required":["pk","name","base_code","sku","product_type","is_active","price","currency","stock","variants"],"properties":{"pk":{"type":"integer","description":"Unique product identifier."},"name":{"type":"string","description":"Display name of the product."},"base_code":{"type":"string","description":"Base product code shared across all variants of the same product."},"sku":{"type":"string","description":"Stock Keeping Unit — unique code for this specific variant."},"product_type":{"allOf":[{"$ref":"#/components/schemas/ProductType"}],"description":"Product type code. Always `\"0\"` (simple) for this endpoint; the queryset is pre-filtered to simple products only."},"is_active":{"type":"boolean","description":"Whether the product is active. Always `true` for this endpoint."},"price":{"type":"string","description":"Current selling price as a decimal string.\n\nWhen a `segment` is provided, this is the price from the segment's price list. When the product has no entry on the requested price list, `\"0.00\"` is returned. When no segment is provided, the product's default price is returned."},"currency":{"type":"string","description":"Currency code for `price`.\n\nWhen a `segment` is provided, this is the currency of the segment's price list. When no segment is provided, the product's own `currency_type` is returned."},"stock":{"type":"integer","description":"Available stock quantity.\n\nWhen a `segment` is provided, this is the stock from the segment's stock list. When the product has no entry on the requested stock list, `0` is returned. When no segment is provided, the product's default stock is returned."},"category":{"type":["string","null"],"description":"Name of the product's main category. `null` when no main category is set."},"product_image":{"type":["string","null"],"format":"uri","description":"URL of the product's first image. `null` when the product has no images."},"variants":{"type":"object","description":"Variant attribute values for this product as a flat key/value map, where each key is an attribute name and the value is the product's value for that attribute.\n\nThe keys present depend on the product's attribute set configuration.","additionalProperties":true}}},"ProductType":{"type":"string","description":"The product type. The value is the numeric code as a string.\n* `-1` — Pre Product\n* `0` — Simple\n* `1` — Product Meta\n* `2` — Bundle\n* `3` — Grouped\n* `-2` — Pre Miscellaneous\n* `4` — Miscellaneous\n* `5` — Offer","enum":["-1","0","1","2","3","-2","4","5"]},"Error":{"type":"object","description":"An error response.","properties":{"detail":{"type":"string","description":"A human-readable description of the error."}},"additionalProperties":true}},"responses":{"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"}}}},"ProductNotFound":{"description":"The requested product does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/products_advanced/{id}/":{"get":{"tags":["Product Advanced"],"operationId":"retrieveProductAdvanced","summary":"Retrieve a single active simple product","description":"Returns the advanced representation of a single active simple product.\n\nPass `segment` to retrieve prices and stock from a specific segment's price list and stock list. See the list operation for full details on segment-aware pricing.","parameters":[{"name":"segment","in":"query","required":false,"description":"ID of a segment whose price list and stock list should be used.","schema":{"type":"integer"}}],"responses":{"200":{"description":"The requested product.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAdvanced"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ProductNotFound"}}}}}}
```


---

# 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/products/product-advanced/retrieve-a-single-active-simple-product.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.
