> 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/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 `. 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://apidocs.akinon.com/commerce-openapis/admin/products/product-advanced/retrieve-a-single-active-simple-product.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.