> 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/bundle-chapter-products/retrieve-a-bundle-chapter-product.md).

# Retrieve a bundle chapter product

Returns a single chapter–product association, expanded with the full bundle chapter and the full product record.

```json
{"openapi":"3.1.0","info":{"title":"Admin API","version":"1.0.0"},"tags":[{"name":"Bundle Chapter Products","description":"Administrative endpoints for **bundle chapter products** — the association records that define which miscellaneous products (`product_type` `4`) a customer can choose from inside a single chapter of a **Bundle** product. Each record links exactly one **bundle chapter** to exactly one **product**; together, the records of a chapter form its set of selectable options. See the **Bundle Chapters** section for the chapters themselves and the **Products** section for the shared product-type table.\n\n## Core Capabilities\n\n**1. Association Listing & Filtering**\n* Retrieve a paginated list of chapter–product associations, each expanded with the full bundle chapter and the full product record.\n* Filter by chapter or by product, negate either filter, and order the results with `sort`.\n* The same data is also reachable under the `/detailed/` aliases (`/bundle_chapter_products/detailed/` and `/bundle_chapter_products/{id}/detailed/`), which return exactly the same payloads as the plain list and retrieve operations.\n\n**2. Association Lifecycle Management**\n* Add a miscellaneous product to a chapter's selectable options.\n* Repoint an existing association at a different chapter or product.\n* Remove an association, taking the product out of the chapter's options.\n\n## Payload Shapes\n\nThis resource returns two different representations, selected by the operation. Plan client code accordingly — the object returned by **create** is not shaped like the object returned by **retrieve**.\n\n| Operation | Representation |\n|-----------|----------------|\n| list, retrieve, `/detailed/` aliases, partial update (`PATCH`) | **Expanded** — `bundle_chapter` and `product` are full nested objects. |\n| create (`POST`), update (`PUT`) | **Flat** — `bundle_chapter` and `product` are identifiers, in both the request and the response. |\n\nBecause every row of the expanded representation carries a complete product and a complete chapter (including their attribute data and images), listing is comparatively expensive. Filter by `bundle_chapter` and keep `limit` modest rather than paging through the unfiltered list.\n\n## Filtering & Ordering\n\n| Query parameter | Effect |\n|-----------------|--------|\n| `bundle_chapter` | Keeps only the associations of the given chapter. |\n| `product` | Keeps only the associations of the given product. |\n| `bundle_chapter!` | Negated form — excludes the associations of the given chapter. |\n| `product!` | Negated form — excludes the associations of the given product. |\n\nAny other query parameter is ignored; related lookups such as `product__sku` are not supported. A non-numeric value for any of the four is rejected with a `400` validation error.\n\nThe stored records carry no ordering of their own, so results are returned **ordered by `id` ascending** by default. `sort` accepts only `pk`, `bundle_chapter`, and `product`, each optionally prefixed with `-` for descending order; ordering by `bundle_chapter` or `product` sorts by the related record's identifier. **Any other value — including `id`, `created_date`, and `modified_date` — is silently ignored** and the default ordering applies, so a client cannot tell an unsupported sort key from a supported one by the response alone.\n\n## Validation Rules\n\n* `product` must reference a product whose `product_type` is **Miscellaneous** (`4`). Any other product type (or a non-existent id) is rejected as an invalid identifier — a standard `400` validation error, not a business-rule error.\n* `bundle_chapter` must reference an existing chapter; a bad id is likewise a `400` validation error.\n* The combination of `bundle_chapter` and `product` must be **unique**. Adding a product that is already among the chapter's options fails with a `400` validation error rather than silently returning the existing association, so create is not idempotent.\n* **`PATCH` cannot change an association — use `PUT`.** Partial update is served by the expanded representation, in which `bundle_chapter` and `product` are nested objects rather than identifiers. Sending either as an id fails validation with `400`; sending either as an object passes validation but is not supported by the endpoint and fails as a server error. Only an empty body (`{}`) succeeds, and it leaves the record unchanged.\n* **Deleting an association is not blocked when the product is the chapter's `default_product`.** The record is removed and the chapter keeps pointing at a default product that is no longer among its selectable options. Verify the chapter's `default_product` before deleting, and update the chapter first if needed.\n* Deletion is a **hard delete** — the association row is removed from the database. The product and the chapter themselves are untouched.\n\n## Dynamic Settings & Environment Variables\n\nNo dynamic setting changes the request or response schema of these endpoints, but the two below affect their behavior. Each is referenced again in the description of the operations it affects.\n\n| Key | Type | Default | Effect |\n|-----|------|---------|--------|\n| `IGNORE_ACCEPT_LANGUAGE_HEADER` | boolean | `true` | Whether the `Accept-Language` header is discarded before the request is processed. Affects every operation that returns the **expanded** representation (**list**, **retrieve**, the `/detailed/` aliases, **partial update**): the nested chapter and product are translated records, so this setting decides whether their translated fields follow `Accept-Language` or the server's default language. While it is `true` (the default), the header is honored only when the request also carries an `X-Omnitron-Session` header. |\n| `IGNORE_DELETED_ITEMS_SIGNAL` | array of strings | `[\"django_audit_events.AuditEvent\", \"django_audit_events.ArchivedAuditEvent\", \"sessions.Session\", \"datawarehouse.DeletedItem\"]` | The model labels excluded from delete tracking. Affects **delete**: unless `products.BundleChapterProduct` is added to this list, removing an association also records a tombstone entry that the data-warehouse export consumes. The API response is identical either way; only the downstream export is affected. |\n\n**Environment variables and server settings**\n\n| Setting | Default | Effect |\n|---------|---------|--------|\n| `LANGUAGE_CODE` | `tr-tr` | The server's default language. Applied to the translated fields of the nested chapter and product (names, attribute labels) and to the nested product's `absolute_url` whenever the request language is not resolved to something else — see `IGNORE_ACCEPT_LANGUAGE_HEADER` above. |\n| `CDN_DOMAIN` | — | Set only where object storage is configured. It determines the form of the image URLs inside the nested product (`productimage_set`, image-valued attributes): absolute URLs on this domain when object storage is in use, relative `/media/...` paths otherwise. |"}],"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":{"BundleChapterProduct":{"type":"object","description":"The expanded representation of a chapter–product association: one miscellaneous product offered as a selectable option inside one bundle chapter. Returned by **list**, **retrieve**, and **partial update**. Create and update return the flat `BundleChapterProductReference` instead.","properties":{"pk":{"type":"integer","description":"The unique identifier of the association.","readOnly":true},"bundle_chapter":{"allOf":[{"$ref":"#/components/schemas/BundleChapter"}],"description":"The bundle chapter the product is offered in, expanded in full.","readOnly":true},"product":{"allOf":[{"$ref":"#/components/schemas/Product"}],"description":"The associated miscellaneous product, expanded in full.","readOnly":true}}},"BundleChapter":{"type":"object","description":"A configurable selection chapter of a bundle product.","properties":{"pk":{"type":"integer","description":"The unique identifier of the bundle chapter.","readOnly":true},"name":{"type":"string","maxLength":255,"description":"The chapter's display name."},"slug":{"type":"string","maxLength":128,"description":"The chapter's identifier within its bundle product. Must be unique per `bundle_product`."},"bundle_product":{"type":"integer","description":"The identifier of the parent product. Must reference a product whose `product_type` is Bundle (`2`). Fixed at creation — a chapter's bundle product cannot be changed afterwards."},"default_product":{"type":["integer","null"],"description":"The identifier of the miscellaneous product pre-selected for this chapter, when set. Must reference a product whose `product_type` is Miscellaneous (`4`). Can be set or replaced through an update, but not cleared back to `null` once set."},"attribute_set":{"type":"integer","description":"The identifier of the attribute set that defines this chapter's selectable attributes. Can only be set at creation — sending a different value on update has no effect."},"order":{"type":"integer","default":0,"description":"The chapter's position among its bundle product's chapters. Chapters are listed ordered by this value by default."},"is_active":{"type":"boolean","default":true,"description":"Whether the chapter is active."},"is_required":{"type":"boolean","default":true,"description":"Whether the customer must make a selection for this chapter."},"is_form_required":{"type":"boolean","default":false,"description":"Whether this chapter renders a form requiring additional input, rather than a plain selection."},"attributes":{"type":"object","readOnly":true,"description":"The chapter's attribute values, keyed by attribute name.","additionalProperties":true},"attributes_kwargs":{"type":"object","readOnly":true,"description":"Additional attribute metadata for the chapter.","additionalProperties":true},"attr_key":{"type":"array","readOnly":true,"description":"The attribute definitions relevant to this chapter: when `is_form_required` is `true`, the attributes required by the chapter's form; otherwise, the attribute set's variant-distinguishing attributes.","items":{"$ref":"#/components/schemas/Attribute"}}}},"Attribute":{"type":"object","description":"An attribute definition as returned by the API.","properties":{"pk":{"type":"integer","description":"The unique identifier of the attribute.","readOnly":true},"key":{"type":"string","maxLength":255,"description":"The unique machine key of the attribute. Matches `^[a-zA-Z_][a-zA-Z0-9_-]*$`."},"name":{"type":"string","maxLength":255,"description":"The human-readable, translatable name of the attribute."},"data_type":{"$ref":"#/components/schemas/AttributeDataType"},"default_value":{"type":["integer","null"],"description":"The identifier of the attribute value used as the default, when any."},"is_required":{"type":"boolean","description":"Whether the attribute must have a value on the product."},"is_visible":{"type":"boolean","description":"Whether the attribute is shown in management and storefront contexts."},"is_searchable":{"type":"boolean","description":"Whether the attribute is indexed for search."},"is_filterable":{"type":"boolean","description":"Whether the attribute can be used as a storefront filter."},"is_variant":{"type":"boolean","description":"Whether the attribute distinguishes variants of a product."},"is_variant_listable":{"type":"boolean","description":"Whether the attribute participates in choosing the listable variant."},"is_form_required":{"type":"boolean","description":"Whether the attribute is required in the product form."},"is_form_field_required":{"type":"boolean","description":"Whether the attribute's form field is required."}}},"AttributeDataType":{"type":"string","description":"The data type of an attribute, controlling how its value is entered and interpreted. See the **Data Types** table under **Attributes**.","enum":["text","email","area","date","datetime","bool","valuelabel","dropdown","multiple","price","nested","image","file","model","bundle"]},"Product":{"type":"object","description":"A product in the catalog.","properties":{"pk":{"type":"integer","description":"The unique identifier of the product.","readOnly":true},"name":{"type":"string","description":"The product name."},"base_code":{"type":["string","null"],"description":"The base code shared by variants of the same product."},"sku":{"type":"string","description":"The unique stock keeping unit."},"product_type":{"$ref":"#/components/schemas/ProductType"},"is_active":{"type":"boolean","description":"Whether the product is active."},"parent":{"type":["integer","null"],"description":"The identifier of the parent product, when the product is a variant."},"attributes":{"type":"object","description":"The attribute values of the product, keyed by attribute name.","additionalProperties":true},"attributes_kwargs":{"type":"object","description":"Additional attribute metadata for the product.","additionalProperties":true},"extra_attributes":{"type":"object","description":"Free-form extra attribute data for the product.","additionalProperties":true},"is_seller_product":{"type":"boolean","description":"Whether the product belongs to a seller."},"group_products":{"type":["array","null"],"description":"The identifiers of products grouped under this product.","items":{"type":"integer"}},"productimage_set":{"type":"array","description":"The images attached to the product.","readOnly":true,"items":{"$ref":"#/components/schemas/ProductImage"}},"attribute_set":{"type":"integer","description":"The identifier of the attribute set that defines the product's attributes."},"custom_attribute_set":{"type":["integer","null"],"description":"The identifier of an additional custom attribute set."},"is_listable":{"type":"boolean","description":"Whether the product is publicly listable. Determined by the system.","readOnly":true},"listing_code":{"type":["string","null"],"description":"The code that identifies the listable variant grouping."},"data_source":{"type":["integer","null"],"description":"The identifier of the default data source (seller) for the product."},"absolute_url":{"type":["string","null"],"description":"The storefront URL of the product, when available.","readOnly":true},"is_form_required":{"type":"boolean","description":"Whether the product requires form input."}}},"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"]},"ProductImage":{"type":"object","description":"An image attached to the product.","properties":{"pk":{"type":"integer","readOnly":true},"status":{"type":"string","description":"The processing status of the image.","readOnly":true},"image":{"type":"string","description":"The image file path."},"order":{"type":"integer","description":"The display order of the image."},"created_date":{"type":"string","format":"date-time","description":"The date and time the image was created.","readOnly":true},"specialimage_set":{"type":"array","description":"Special image variants associated with the image.","items":{"type":"object"}}}},"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"}}}},"BundleChapterProductNotFound":{"description":"The requested bundle chapter product association does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/bundle_chapter_products/{id}/":{"get":{"tags":["Bundle Chapter Products"],"operationId":"retrieveBundleChapterProduct","summary":"Retrieve a bundle chapter product","description":"Returns a single chapter–product association, expanded with the full bundle chapter and the full product record.","responses":{"200":{"description":"The requested bundle chapter product.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleChapterProduct"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/BundleChapterProductNotFound"}}}}}}
```


---

# 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/bundle-chapter-products/retrieve-a-bundle-chapter-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.
