# Baskets

## GET /baskets/basket-items/

> This method returns details about a specific item in a shopping basket, including its ID, quantity, product reference, and version. It also includes information such as the associated basket ID, product ID, and any additional attributes (like tax rate, unit price, image, and extra product details), if available.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Server base URL with dynamic channel_id.","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com"}}},{"description":"Server base URL with Commerce URL.","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.commerce.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"PaginatedBasketItemList":{"properties":{"count":{"description":"Numerical value representing quantity or total amount.","type":"integer"},"next":{"description":"This field defines the URL of the next page.","format":"uri","nullable":true,"type":"string"},"previous":{"description":"This field defines the URL of the previous page.","format":"uri","nullable":true,"type":"string"},"results":{"description":"This field returns a list of results.","items":{"$ref":"#/components/schemas/BasketItem"},"type":"array"}},"type":"object"},"BasketItem":{"properties":{"attributes":{"description":"The field defines the attributes of the category node.","nullable":true},"attributes_kwargs":{"description":"The field defines the details of the category node.","nullable":true},"basket":{"description":"This field defines the ID of the basket that contains the product.","type":"integer"},"created_date":{"description":"Timestamp indicating when the record was created.","format":"date-time","type":"string"},"currency_type":{"$ref":"#/components/schemas/CurrencyTypeEnum","description":"The classification or type related to this field."},"datasource":{"description":"The field defines the ID that indicates which seller the item belongs to.","nullable":true,"type":"integer"},"extra_product_price":{"description":"The field defines the ID of the extra product price associated with the product. If not specified, the default price applies.","nullable":true,"type":"integer"},"extra_product_stock":{"description":"The field defines the ID of the extra product stock associated with the product. If not specified, the default stock applies.","nullable":true,"type":"integer"},"id":{"description":"Unique identifier for the record.","type":"integer"},"image":{"description":"This field defines the URL or path to the product's image.","format":"uri","nullable":true,"type":"string"},"localized_attributes":{"description":"The field defines the category node that has been translated into other languages.","nullable":true},"localized_attributes_kwargs":{"description":"The field defines the details of the translations for the category node attributes.","nullable":true},"modified_date":{"description":"This field defines the last updated date.","format":"date-time","type":"string"},"parent":{"description":"The field defines the ID of the associated basket item, if there is a related basket item.","nullable":true,"type":"integer"},"product":{"description":"The field defines the product ID associated with the product price.","type":"integer"},"quantity":{"description":"This field defines the quantity of the product.","maximum":2147483647,"minimum":0,"type":"integer"},"reference":{"description":"This field defines a reference for the basket item.","maxLength":255,"type":"string"},"tax_rate":{"description":"The field defines the tax rate applied to the product.","format":"decimal","nullable":true,"pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","type":"string"},"unit_price":{"description":"This field defines the unit price of the product.","format":"decimal","nullable":true,"pattern":"^-?\\d{0,10}(?:\\.\\d{0,2})?$","type":"string"},"version":{"description":"record revision number","type":"integer"}},"type":"object"},"CurrencyTypeEnum":{"description":"* `try` - TL\n* `eur` - EUR\n* `usd` - USD\n* `egp` - EGP\n* `gbp` - GBP\n* `mad` - MAD\n* `pln` - PLN\n* `sar` - SAR\n* `ron` - RON\n* `uah` - UAH\n* `czk` - CZK\n* `huf` - HUF\n* `rub` - RUB\n* `bgn` - BGN\n* `iqd` - IQD\n* `kwd` - KWD\n* `bhd` - BHD\n* `omr` - OMR\n* `qar` - QAR\n* `aed` - AED\n* `ngn` - NGN\n* `inr` - INR\n* `lei` - LEI\n* `kzt` - KZT\n* `jod` - JOD\n* `rsd` - RSD","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"],"type":"string"}}},"paths":{"/baskets/basket-items/":{"get":{"description":"This method returns details about a specific item in a shopping basket, including its ID, quantity, product reference, and version. It also includes information such as the associated basket ID, product ID, and any additional attributes (like tax rate, unit price, image, and extra product details), if available.","operationId":"baskets_basket_items_list","parameters":[{"description":"Query parameter `attributes` used to filter results based on specific conditions.","in":"query","name":"attributes","schema":{"nullable":true}},{"description":"Query parameter `attributes_kwargs` used to filter results based on specific conditions.","in":"query","name":"attributes_kwargs","schema":{"nullable":true}},{"description":"Query parameter `basket` used to filter results based on specific conditions.","in":"query","name":"basket","schema":{"type":"integer"}},{"description":"Query parameter `created_date` used to filter results based on specific conditions.","in":"query","name":"created_date","schema":{"format":"date-time","type":"string"}},{"description":"Query parameter `currency_type` used to filter results based on specific conditions.","in":"query","name":"currency_type","schema":{"type":"string"}},{"description":"Query parameter `datasource` used to filter results based on specific conditions.","in":"query","name":"datasource","schema":{"type":"integer"}},{"description":"Query parameter `extra_product_price` used to filter results based on specific conditions.","in":"query","name":"extra_product_price","schema":{"type":"integer"}},{"description":"Query parameter `extra_product_stock` used to filter results based on specific conditions.","in":"query","name":"extra_product_stock","schema":{"type":"integer"}},{"description":"Query parameter `id` used to filter results based on specific conditions.","in":"query","name":"id","schema":{"type":"integer"}},{"description":"Filters records where `id` is greater than the given value.","in":"query","name":"id__gt","schema":{"type":"integer"}},{"description":"Filters records where `id` is greater than or equal to the given value.","in":"query","name":"id__gte","schema":{"type":"integer"}},{"description":"Filters records where `id` is less than the given value.","in":"query","name":"id__lt","schema":{"type":"integer"}},{"description":"Filters records where `id` is less than or equal to the given value.","in":"query","name":"id__lte","schema":{"type":"integer"}},{"description":"Query parameter `image` used to filter results based on specific conditions.","in":"query","name":"image","schema":{"type":"string"}},{"description":"Limits the number of results returned in the response.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Query parameter `localized_attributes` used to filter results based on specific conditions.","in":"query","name":"localized_attributes","schema":{"nullable":true}},{"description":"Query parameter `localized_attributes_kwargs` used to filter results based on specific conditions.","in":"query","name":"localized_attributes_kwargs","schema":{"nullable":true}},{"description":"Query parameter `modified_date` used to filter results based on specific conditions.","in":"query","name":"modified_date","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is greater than the given value.","in":"query","name":"modified_date__gt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is greater than or equal to the given value.","in":"query","name":"modified_date__gte","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is less than the given value.","in":"query","name":"modified_date__lt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is less than or equal to the given value.","in":"query","name":"modified_date__lte","schema":{"format":"date-time","type":"string"}},{"description":"Query parameter `page` used to filter results based on specific conditions.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Query parameter `parent` used to filter results based on specific conditions.","in":"query","name":"parent","schema":{"type":"integer"}},{"description":"Query parameter `product` used to filter results based on specific conditions.","in":"query","name":"product","schema":{"type":"integer"}},{"description":"Query parameter `quantity` used to filter results based on specific conditions.","in":"query","name":"quantity","schema":{"type":"integer"}},{"description":"Query parameter `reference` used to filter results based on specific conditions.","in":"query","name":"reference","schema":{"type":"string"}},{"description":"Query parameter `sort` used to filter results based on specific conditions.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Query parameter `tax_rate` used to filter results based on specific conditions.","in":"query","name":"tax_rate","schema":{"type":"number"}},{"description":"Query parameter `unit_price` used to filter results based on specific conditions.","in":"query","name":"unit_price","schema":{"type":"number"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedBasketItemList"}}},"description":"Successful response for status code 200."}},"tags":["baskets"]}}}}
```

## GET /baskets/basket-items/{id}/

> This method returns details about a specific item in a shopping basket, including its ID, quantity, product reference, and version. It also includes information such as the associated basket ID, product ID, and any additional attributes (like tax rate, unit price, image, and extra product details), if available. This endpoint retrieves a specific record by its unique identifier.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Server base URL with dynamic channel_id.","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com"}}},{"description":"Server base URL with Commerce URL.","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.commerce.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"BasketItem":{"properties":{"attributes":{"description":"The field defines the attributes of the category node.","nullable":true},"attributes_kwargs":{"description":"The field defines the details of the category node.","nullable":true},"basket":{"description":"This field defines the ID of the basket that contains the product.","type":"integer"},"created_date":{"description":"Timestamp indicating when the record was created.","format":"date-time","type":"string"},"currency_type":{"$ref":"#/components/schemas/CurrencyTypeEnum","description":"The classification or type related to this field."},"datasource":{"description":"The field defines the ID that indicates which seller the item belongs to.","nullable":true,"type":"integer"},"extra_product_price":{"description":"The field defines the ID of the extra product price associated with the product. If not specified, the default price applies.","nullable":true,"type":"integer"},"extra_product_stock":{"description":"The field defines the ID of the extra product stock associated with the product. If not specified, the default stock applies.","nullable":true,"type":"integer"},"id":{"description":"Unique identifier for the record.","type":"integer"},"image":{"description":"This field defines the URL or path to the product's image.","format":"uri","nullable":true,"type":"string"},"localized_attributes":{"description":"The field defines the category node that has been translated into other languages.","nullable":true},"localized_attributes_kwargs":{"description":"The field defines the details of the translations for the category node attributes.","nullable":true},"modified_date":{"description":"This field defines the last updated date.","format":"date-time","type":"string"},"parent":{"description":"The field defines the ID of the associated basket item, if there is a related basket item.","nullable":true,"type":"integer"},"product":{"description":"The field defines the product ID associated with the product price.","type":"integer"},"quantity":{"description":"This field defines the quantity of the product.","maximum":2147483647,"minimum":0,"type":"integer"},"reference":{"description":"This field defines a reference for the basket item.","maxLength":255,"type":"string"},"tax_rate":{"description":"The field defines the tax rate applied to the product.","format":"decimal","nullable":true,"pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","type":"string"},"unit_price":{"description":"This field defines the unit price of the product.","format":"decimal","nullable":true,"pattern":"^-?\\d{0,10}(?:\\.\\d{0,2})?$","type":"string"},"version":{"description":"record revision number","type":"integer"}},"type":"object"},"CurrencyTypeEnum":{"description":"* `try` - TL\n* `eur` - EUR\n* `usd` - USD\n* `egp` - EGP\n* `gbp` - GBP\n* `mad` - MAD\n* `pln` - PLN\n* `sar` - SAR\n* `ron` - RON\n* `uah` - UAH\n* `czk` - CZK\n* `huf` - HUF\n* `rub` - RUB\n* `bgn` - BGN\n* `iqd` - IQD\n* `kwd` - KWD\n* `bhd` - BHD\n* `omr` - OMR\n* `qar` - QAR\n* `aed` - AED\n* `ngn` - NGN\n* `inr` - INR\n* `lei` - LEI\n* `kzt` - KZT\n* `jod` - JOD\n* `rsd` - RSD","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"],"type":"string"}}},"paths":{"/baskets/basket-items/{id}/":{"get":{"description":"This method returns details about a specific item in a shopping basket, including its ID, quantity, product reference, and version. It also includes information such as the associated basket ID, product ID, and any additional attributes (like tax rate, unit price, image, and extra product details), if available. This endpoint retrieves a specific record by its unique identifier.","operationId":"baskets_basket_items_retrieve","parameters":[{"description":"A unique integer value identifying this basket item.","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasketItem"}}},"description":"Successful response for status code 200."},"404":{"content":{"application/json":{}},"description":"Object not found."}},"tags":["baskets"]}}}}
```

## GET /baskets/baskets/

> This method returns details about a specific shopping basket, including its ID, status, creation and modification timestamps, version, and associated voucher code. It also provides information about the user and any namespaces linked to the basket, if applicable.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Server base URL with dynamic channel_id.","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com"}}},{"description":"Server base URL with Commerce URL.","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.commerce.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"PaginatedBasketList":{"properties":{"count":{"description":"Numerical value representing quantity or total amount.","type":"integer"},"next":{"description":"This field defines the URL of the next page.","format":"uri","nullable":true,"type":"string"},"previous":{"description":"This field defines the URL of the previous page.","format":"uri","nullable":true,"type":"string"},"results":{"description":"This field returns a list of results.","items":{"$ref":"#/components/schemas/Basket"},"type":"array"}},"type":"object"},"Basket":{"properties":{"created_date":{"description":"Timestamp indicating when the record was created.","format":"date-time","type":"string"},"id":{"description":"Unique identifier for the record.","type":"integer"},"modified_date":{"description":"This field defines the last updated date.","format":"date-time","type":"string"},"namespace":{"description":"The full name or label associated with the record.","maxLength":128,"nullable":true,"type":"string"},"status":{"$ref":"#/components/schemas/BasketStatusEnum","description":"Current status of the record (e.g., active, inactive)."},"user":{"description":"This field defines the user who triggered the event.","nullable":true,"type":"integer"},"version":{"description":"record revision number","type":"integer"},"voucher_code":{"description":"The field defines the code of the voucher applied to the basket.","maxLength":128,"nullable":true,"type":"string"}},"type":"object"},"BasketStatusEnum":{"description":"* `active` - Active\n* `inactive` - Inactive\n* `expired` - Expired\n* `merged` - Merged\n* `frozen` - Frozen\n* `submitted` - Submitted","enum":["active","inactive","expired","merged","frozen","submitted"],"type":"string"}}},"paths":{"/baskets/baskets/":{"get":{"description":"This method returns details about a specific shopping basket, including its ID, status, creation and modification timestamps, version, and associated voucher code. It also provides information about the user and any namespaces linked to the basket, if applicable.","operationId":"baskets_baskets_list","parameters":[{"description":"Query parameter `created_date` used to filter results based on specific conditions.","in":"query","name":"created_date","schema":{"format":"date-time","type":"string"}},{"description":"Query parameter `id` used to filter results based on specific conditions.","in":"query","name":"id","schema":{"type":"integer"}},{"description":"Filters records where `id` is greater than the given value.","in":"query","name":"id__gt","schema":{"type":"integer"}},{"description":"Filters records where `id` is greater than or equal to the given value.","in":"query","name":"id__gte","schema":{"type":"integer"}},{"description":"Filters records where `id` is less than the given value.","in":"query","name":"id__lt","schema":{"type":"integer"}},{"description":"Filters records where `id` is less than or equal to the given value.","in":"query","name":"id__lte","schema":{"type":"integer"}},{"description":"Limits the number of results returned in the response.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Query parameter `modified_date` used to filter results based on specific conditions.","in":"query","name":"modified_date","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is greater than the given value.","in":"query","name":"modified_date__gt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is greater than or equal to the given value.","in":"query","name":"modified_date__gte","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is less than the given value.","in":"query","name":"modified_date__lt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `modified_date` is less than or equal to the given value.","in":"query","name":"modified_date__lte","schema":{"format":"date-time","type":"string"}},{"description":"Query parameter `namespace` used to filter results based on specific conditions.","in":"query","name":"namespace","schema":{"type":"string"}},{"description":"Query parameter `page` used to filter results based on specific conditions.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Query parameter `sort` used to filter results based on specific conditions.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Query parameter `status` used to filter results based on specific conditions.","in":"query","name":"status","schema":{"enum":["active","expired","frozen","inactive","merged","submitted"],"type":"string"}},{"description":"Query parameter `user` used to filter results based on specific conditions.","in":"query","name":"user","schema":{"type":"integer"}},{"description":"Query parameter `voucher_code` used to filter results based on specific conditions.","in":"query","name":"voucher_code","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedBasketList"}}},"description":"Successful response for status code 200."}},"tags":["baskets"]}}}}
```

## GET /baskets/baskets/{id}/

> This method returns details about a specific shopping basket, including its ID, status, creation and modification timestamps, version, and associated voucher code. It also provides information about the user and any namespaces linked to the basket, if applicable. This endpoint retrieves a specific record by its unique identifier.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Server base URL with dynamic channel_id.","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com"}}},{"description":"Server base URL with Commerce URL.","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.commerce.akinon.com"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"Basket":{"properties":{"created_date":{"description":"Timestamp indicating when the record was created.","format":"date-time","type":"string"},"id":{"description":"Unique identifier for the record.","type":"integer"},"modified_date":{"description":"This field defines the last updated date.","format":"date-time","type":"string"},"namespace":{"description":"The full name or label associated with the record.","maxLength":128,"nullable":true,"type":"string"},"status":{"$ref":"#/components/schemas/BasketStatusEnum","description":"Current status of the record (e.g., active, inactive)."},"user":{"description":"This field defines the user who triggered the event.","nullable":true,"type":"integer"},"version":{"description":"record revision number","type":"integer"},"voucher_code":{"description":"The field defines the code of the voucher applied to the basket.","maxLength":128,"nullable":true,"type":"string"}},"type":"object"},"BasketStatusEnum":{"description":"* `active` - Active\n* `inactive` - Inactive\n* `expired` - Expired\n* `merged` - Merged\n* `frozen` - Frozen\n* `submitted` - Submitted","enum":["active","inactive","expired","merged","frozen","submitted"],"type":"string"}}},"paths":{"/baskets/baskets/{id}/":{"get":{"description":"This method returns details about a specific shopping basket, including its ID, status, creation and modification timestamps, version, and associated voucher code. It also provides information about the user and any namespaces linked to the basket, if applicable. This endpoint retrieves a specific record by its unique identifier.","operationId":"baskets_baskets_retrieve","parameters":[{"description":"A unique integer value identifying this basket.","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basket"}}},"description":"Successful response for status code 200."},"404":{"content":{"application/json":{}},"description":"Object not found."}},"tags":["baskets"]}}}}
```


---

# Agent Instructions: 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:

```
GET https://apidocs.akinon.com/commerce-openapis/data-warehouse/baskets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.