How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Bitrix24 E-Commerce API

The E-Commerce API from Bitrix24 — 139 operation(s) for e-commerce.

Bitrix24 E-Commerce API is one of 36 APIs that Bitrix24 publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include E-Commerce. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 139 operations across 139 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 2 base URLs: https://{portal}.bitrix24.com/rest, https://{host}/rest.

139 operations 139 paths 3 schemas 139 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://{installation}.bitrix24.com/rest/
Authentication
API Key, OAuth 2.0
License
Resource Areas
1

Authentication & Security 2

Bitrix24 E-Commerce API declares 2 security schemes for authenticating requests. An API key is passed in the query as auth (AccessToken). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 45 scopes. By default, every request must be authenticated.

  • AccessToken — OAuth 2.0 accesstoken or incoming webhook token
  • OAuth2 — OAuth 2.0 authorization

Paths & Operations 139

Across 139 paths, the API surfaces 139 operations — 139 POST. Each is listed below with its method, path, parameters, and response codes.

E-Commerce 139
POST
/sale.basketitem.add
Add Item (Position) to the Cart of an Existing Order sale.basketitem.add
sale_basketitem_add body → 2004XX
POST
/sale.basketitem.addCatalogProduct
Add a position with a product or service from the catalog module to the cart of an existing order sale.basketitem.addCatalogProduct
sale_basketitem_addCatalogProduct body → 2004XX
POST
/sale.basketitem.delete
Remove item (position) from the cart using sale.basketitem.delete
sale_basketitem_delete body → 2004XX
POST
/sale.basketitem.get
Get Information About a Basket Item (Position) sale.basketitem.get
sale_basketitem_get body → 2004XX
POST
/sale.basketitem.getFields
Get Available Fields of the Basket Item (sale.basketitem.getFields)
sale_basketitem_getFields body → 2004XX
POST
/sale.basketitem.getFieldsCatalogProduct
Get Available Fields of a Basket Item (Product from Catalog) sale.basketitem.getFieldsCatalogProduct
sale_basketitem_getFieldsCatalogProduct body → 2004XX
POST
/sale.basketitem.list
Get a List of Items (Positions) in the Cart sale.basketitem.list
sale_basketitem_list body → 2004XX
POST
/sale.basketitem.update
Change the position of the basket in an existing order sale.basketitem.update
sale_basketitem_update body → 2004XX
POST
/sale.basketitem.updateCatalogProduct
Change the basket item position (catalog product) of an existing order sale.basketitem.updateCatalogProduct
sale_basketitem_updateCatalogProduct body → 2004XX
POST
/sale.basketproperties.add
Create a property for a basket item sale.basketproperties.add
sale_basketproperties_add body → 2004XX
POST
/sale.basketproperties.delete
Delete Basket Property sale.basketproperties.delete
sale_basketproperties_delete body → 2004XX
POST
/sale.basketproperties.get
Get the value of the basket property sale.basketproperties.get
sale_basketproperties_get body → 2004XX
POST
/sale.basketproperties.getFields
Get Fields of Basket Properties sale.basketproperties.getFields
sale_basketproperties_getFields body → 2004XX
POST
/sale.basketproperties.list
Get a List of Basket Properties sale.basketproperties.list
sale_basketproperties_list body → 2004XX
POST
/sale.basketproperties.update
Change the property of the basket item sale.basketproperties.update
sale_basketproperties_update body → 2004XX
POST
/sale.businessValuePersonDomain.add
Add Correspondence to a Natural or Legal Person sale.businessValuePersonDomain.add
sale_businessValuePersonDomain_add body → 2004XX
POST
/sale.businessValuePersonDomain.deleteByFilter
Delete the correspondence with a natural or legal person sale.businessValuePersonDomain.deleteByFilter
sale_businessValuePersonDomain_deleteByFilter body → 2004XX
POST
/sale.businessValuePersonDomain.getFields
Get Fields Corresponding to a Natural or Legal Person sale.businessValuePersonDomain.getFields
sale_businessValuePersonDomain_getFields body → 2004XX
POST
/sale.businessValuePersonDomain.list
Get a list of matches for a natural or legal person sale.businessValuePersonDomain.list
sale_businessValuePersonDomain_list body → 2004XX
POST
/sale.cashbox.add
Add Cash Register sale.cashbox.add
sale_cashbox_add body → 2004XX
POST
/sale.cashbox.check.apply
Save the result of printing the receipt sale.cashbox.check.apply
sale_cashbox_check_apply body → 2004XX
POST
/sale.cashbox.delete
Delete cash register sale.cashbox.delete
sale_cashbox_delete body → 2004XX
POST
/sale.cashbox.handler.add
Add Cashbox Handler sale.cashbox.handler.add
sale_cashbox_handler_add body → 2004XX
POST
/sale.cashbox.handler.delete
Delete Cashbox Handler sale.cashbox.handler.delete
sale_cashbox_handler_delete body → 2004XX
POST
/sale.cashbox.handler.list
Get a list of available cash register handlers sale.cashbox.handler.list
sale_cashbox_handler_list body → 2004XX
POST
/sale.cashbox.handler.update
Update Cash Register Handler sale.cashbox.handler.update
sale_cashbox_handler_update body → 2004XX
POST
/sale.cashbox.list
Get a list of configured cash registers sale.cashbox.list
sale_cashbox_list body → 2004XX
POST
/sale.cashbox.update
Update Existing Cash Register sale.cashbox.update
sale_cashbox_update body → 2004XX
POST
/sale.delivery.add
Add Delivery Service sale.delivery.add
sale_delivery_add body → 2004XX
POST
/sale.delivery.config.get
Get Delivery Service Settings sale.delivery.config.get
sale_delivery_config_get body → 2004XX
POST
/sale.delivery.config.update
Update Delivery Service Settings sale.delivery.config.update
sale_delivery_config_update body → 2004XX
POST
/sale.delivery.delete
Delete Delivery Service sale.delivery.delete
sale_delivery_delete body → 2004XX
POST
/sale.delivery.extra.service.add
Add Delivery Service sale.delivery.extra.service.add
sale_delivery_extra_service_add body → 2004XX
POST
/sale.delivery.extra.service.delete
Delete the delivery service sale.delivery.extra.service.delete
sale_delivery_extra_service_delete body → 2004XX
POST
/sale.delivery.extra.service.get
Get Information About All Services of a Specific Delivery Service sale.delivery.extra.service.get
sale_delivery_extra_service_get body → 2004XX
POST
/sale.delivery.extra.service.update
Update Delivery Service sale.delivery.extra.service.update
sale_delivery_extra_service_update body → 2004XX
POST
/sale.delivery.getlist
Get a list of delivery services sale.delivery.getlist
sale_delivery_getlist body → 2004XX
POST
/sale.delivery.handler.add
Add Delivery Service Handler sale.delivery.handler.add
sale_delivery_handler_add body → 2004XX
POST
/sale.delivery.handler.delete
Delete Delivery Service Handler sale.delivery.handler.delete
sale_delivery_handler_delete body → 2004XX
POST
/sale.delivery.handler.list
Get a list of delivery service handlers sale.delivery.handler.list
sale_delivery_handler_list body → 2004XX
POST
/sale.delivery.handler.update
Update Delivery Service Handler sale.delivery.handler.update
sale_delivery_handler_update body → 2004XX
POST
/sale.delivery.request.delete
Delete Delivery Request sale.delivery.request.delete
sale_delivery_request_delete body → 2004XX
POST
/sale.delivery.request.sendmessage
Create Notifications for Delivery Request sale.delivery.request.sendmessage
sale_delivery_request_sendmessage body → 2004XX
POST
/sale.delivery.request.update
Update Delivery Request sale.delivery.request.update
sale_delivery_request_update body → 2004XX
POST
/sale.delivery.update
Update Delivery Service sale.delivery.update
sale_delivery_update body → 2004XX
POST
/sale.order.add
Add Order sale.order.add
sale_order_add body → 2004XX
POST
/sale.order.delete
Delete Order and Related Objects sale.order.delete
sale_order_delete body → 2004XX
POST
/sale.order.get
Get Order Field Values and Related Objects sale.order.get
sale_order_get body → 2004XX
POST
/sale.order.getfields
Get Order Fields sale.order.getfields
sale_order_getfields body → 2004XX
POST
/sale.order.list
Get the list of orders sale.order.list
sale_order_list body → 2004XX
POST
/sale.order.update
Update Order sale.order.update
sale_order_update body → 2004XX
POST
/sale.payment.add
Add Payment sale.payment.add
sale_payment_add body → 2004XX
POST
/sale.payment.delete
Delete Payment sale.payment.delete
sale_payment_delete body → 2004XX
POST
/sale.payment.get
Get Payment by Id sale.payment.get
sale_payment_get body → 2004XX
POST
/sale.payment.getFields
Get Payment Fields sale.payment.getFields
sale_payment_getFields body → 2004XX
POST
/sale.payment.list
Get the list of payments sale.payment.list
sale_payment_list body → 2004XX
POST
/sale.payment.update
Update Payment sale.payment.update
sale_payment_update body → 2004XX
POST
/sale.paymentItemShipment.add
Add Payment Binding to Shipment sale.paymentItemShipment.add
sale_paymentItemShipment_add body → 2004XX
POST
/sale.paymentItemShipment.delete
Remove the binding sale.paymentItemShipment.delete
sale_paymentItemShipment_delete body → 2004XX
POST
/sale.paymentItemShipment.get
Get Payment Binding by Id sale.paymentItemShipment.get
sale_paymentItemShipment_get body → 2004XX
POST
/sale.paymentItemShipment.getFields
Get Fields for sale.paymentItemShipment.getFields
sale_paymentItemShipment_getFields body → 2004XX
POST
/sale.paymentItemShipment.list
Get a list of bindings sale.paymentItemShipment.list
sale_paymentItemShipment_list body → 2004XX
POST
/sale.paymentItemShipment.update
Change Payment Binding to Shipment sale.paymentItemShipment.update
sale_paymentItemShipment_update body → 2004XX
POST
/sale.paymentitembasket.add
Add Basket Item Binding to Payment sale.paymentitembasket.add
sale_paymentitembasket_add body → 2004XX
POST
/sale.paymentitembasket.delete
Delete the binding of the cart item to the payment sale.paymentitembasket.delete
sale_paymentitembasket_delete body → 2004XX
POST
/sale.paymentitembasket.get
Get Values of All Fields for the Basket Item Binding to Payment sale.paymentitembasket.get
sale_paymentitembasket_get body → 2004XX
POST
/sale.paymentitembasket.getfields
Get Available Fields for Payment Item Basket Bindings sale.paymentitembasket.getfields
sale_paymentitembasket_getfields body → 2004XX
POST
/sale.paymentitembasket.list
Get a list of basket item bindings to payments sale.paymentitembasket.list
sale_paymentitembasket_list body → 2004XX
POST
/sale.paymentitembasket.update
Update the binding of the cart item to the payment sale.paymentitembasket.update
sale_paymentitembasket_update body → 2004XX
POST
/sale.persontype.add
Add payer type sale.persontype.add
sale_persontype_add body → 2004XX
POST
/sale.persontype.delete
Delete payer type sale.persontype.delete
sale_persontype_delete body → 2004XX
POST
/sale.persontype.get
Get the payer type by Id sale.persontype.get
sale_persontype_get body → 2004XX
POST
/sale.persontype.getFields
Get Fields of the Payer Type sale.persontype.getFields
sale_persontype_getFields body → 2004XX
POST
/sale.persontype.list
Get a list of payer types sale.persontype.list
sale_persontype_list body → 2004XX
POST
/sale.persontype.update
Change the payer type sale.persontype.update
sale_persontype_update body → 2004XX
POST
/sale.property.add
Add Order Property sale.property.add
sale_property_add body → 2004XX
POST
/sale.property.delete
Delete Order Property sale.property.delete
sale_property_delete body → 2004XX
POST
/sale.property.get
Get Order Property sale.property.get
sale_property_get body → 2004XX
POST
/sale.property.getfieldsbytype
Get Fields and Settings of Order Properties for a Specific Property Type sale.property.getfieldsbytype
sale_property_getfieldsbytype body → 2004XX
POST
/sale.property.list
Get the list of order properties sale.property.list
sale_property_list body → 2004XX
POST
/sale.property.update
Update Order Property sale.property.update
sale_property_update body → 2004XX
POST
/sale.propertyRelation.add
Add Property Binding sale.propertyRelation.add
sale_propertyRelation_add body → 2004XX
POST
/sale.propertyRelation.deleteByFilter
Remove Property Relation with sale.propertyRelation.deleteByFilter
sale_propertyRelation_deleteByFilter body → 2004XX
POST
/sale.propertyRelation.getFields
Get Fields of Property Binding sale.propertyRelation.getFields
sale_propertyRelation_getFields body → 2004XX
POST
/sale.propertyRelation.list
Get a list of property bindings sale.propertyRelation.list
sale_propertyRelation_list body → 2004XX
POST
/sale.propertygroup.add
Create Property Group sale.propertygroup.add
sale_propertygroup_add body → 2004XX
POST
/sale.propertygroup.delete
Delete Property Group sale.propertygroup.delete
sale_propertygroup_delete body → 2004XX
POST
/sale.propertygroup.get
Get Values of All Fields in a Property Group by ID sale.propertygroup.get
sale_propertygroup_get body → 2004XX
POST
/sale.propertygroup.getFields
Get Available Fields of Property Groups sale.propertygroup.getFields
sale_propertygroup_getFields body → 2004XX
POST
/sale.propertygroup.list
Get a list of property groups sale.propertygroup.list
sale_propertygroup_list body → 2004XX
POST
/sale.propertygroup.update
Update Property Group Fields sale.propertygroup.update
sale_propertygroup_update body → 2004XX
POST
/sale.propertyvalue.delete
Delete Order Property Value sale.propertyvalue.delete
sale_propertyvalue_delete body → 2004XX
POST
/sale.propertyvalue.get
Get Property Value with sale.propertyvalue.get
sale_propertyvalue_get body → 2004XX
POST
/sale.propertyvalue.getfields
Get Available Fields of the Property Value sale.propertyvalue.getfields
sale_propertyvalue_getfields body → 2004XX
POST
/sale.propertyvalue.list
Get a list of property values sale.propertyvalue.list
sale_propertyvalue_list body → 2004XX
POST
/sale.propertyvalue.modify
Change the Value of the Property sale.propertyvalue.modify
sale_propertyvalue_modify body → 2004XX
POST
/sale.propertyvariant.add
Add Property Variant sale.propertyvariant.add
sale_propertyvariant_add body → 2004XX
POST
/sale.propertyvariant.delete
Delete Property Variant sale.propertyvariant.delete
sale_propertyvariant_delete body → 2004XX
POST
/sale.propertyvariant.get
Get Property Variant Value by ID sale.propertyvariant.get
sale_propertyvariant_get body → 2004XX
POST
/sale.propertyvariant.getFields
Get Available Fields of Property Variant sale.propertyvariant.getFields
sale_propertyvariant_getFields body → 2004XX
POST
/sale.propertyvariant.list
Get a list of property variants sale.propertyvariant.list
sale_propertyvariant_list body → 2004XX
POST
/sale.propertyvariant.update
Update Property Variant Fields sale.propertyvariant.update
sale_propertyvariant_update body → 2004XX
POST
/sale.shipment.add
Add Shipment sale.shipment.add
sale_shipment_add body → 2004XX
POST
/sale.shipment.delete
Delete Shipment sale.shipment.delete
sale_shipment_delete body → 2004XX
POST
/sale.shipment.get
Get Shipment Fields sale.shipment.get
sale_shipment_get body → 2004XX
POST
/sale.shipment.getfields
Get Available Shipment Fields sale.shipment.getfields
sale_shipment_getfields body → 2004XX
POST
/sale.shipment.list
Get the list of shipments sale.shipment.list
sale_shipment_list body → 2004XX
POST
/sale.shipment.update
Update Shipment sale.shipment.update
sale_shipment_update body → 2004XX
POST
/sale.shipmentitem.add
Add an item to the shipment table part sale.shipmentitem.add
sale_shipmentitem_add body → 2004XX
POST
/sale.shipmentitem.delete
Delete Shipment Item from Collection sale.shipmentitem.delete
sale_shipmentitem_delete body → 2004XX
POST
/sale.shipmentitem.get
Accessing Fields of the sale.shipmentitem.get Element
sale_shipmentitem_get body → 2004XX
POST
/sale.shipmentitem.getfields
Get Fields of Shipment Item from sale.shipmentitem.getfields
sale_shipmentitem_getfields body → 2004XX
POST
/sale.shipmentitem.list
Get a list of shipment item table elements sale.shipmentitem.list
sale_shipmentitem_list body → 2004XX
POST
/sale.shipmentitem.update
Update an item in the shipment table part sale.shipmentitem.update
sale_shipmentitem_update body → 2004XX
POST
/sale.shipmentproperty.add
Add Shipment Property sale.shipmentproperty.add
sale_shipmentproperty_add body → 2004XX
POST
/sale.shipmentproperty.delete
Delete Shipment Property sale.shipmentproperty.delete
sale_shipmentproperty_delete body → 2004XX
POST
/sale.shipmentproperty.get
Get Shipment Property sale.shipmentproperty.get
sale_shipmentproperty_get body → 2004XX
POST
/sale.shipmentproperty.getfieldsbytype
Get Fields and Settings of Shipment Property for a Specific Property Type sale.shipmentproperty.getfieldsbytype
sale_shipmentproperty_getfieldsbytype body → 2004XX
POST
/sale.shipmentproperty.list
Get a list of shipment properties sale.shipmentproperty.list
sale_shipmentproperty_list body → 2004XX
POST
/sale.shipmentproperty.update
Update Shipment Property sale.shipmentproperty.update
sale_shipmentproperty_update body → 2004XX
POST
/sale.shipmentpropertyvalue.delete
Delete Shipment Property Value sale.shipmentpropertyvalue.delete
sale_shipmentpropertyvalue_delete body → 2004XX
POST
/sale.shipmentpropertyvalue.get
Get Shipment Property Value by ID sale.shipmentpropertyvalue.get
sale_shipmentpropertyvalue_get body → 2004XX
POST
/sale.shipmentpropertyvalue.getfields
Get Available Fields of Shipment Property Values sale.shipmentpropertyvalue.getfields
sale_shipmentpropertyvalue_getfields body → 2004XX
POST
/sale.shipmentpropertyvalue.list
Get a list of shipment property values sale.shipmentpropertyvalue.list
sale_shipmentpropertyvalue_list body → 2004XX
POST
/sale.shipmentpropertyvalue.modify
Update Shipment Property Values sale.shipmentpropertyvalue.modify
sale_shipmentpropertyvalue_modify body → 2004XX
POST
/sale.status.add
Create status sale.status.add
sale_status_add body → 2004XX
POST
/sale.status.delete
Delete Status sale.status.delete
sale_status_delete body → 2004XX
POST
/sale.status.get
Get Values of All Status Fields by ID sale.status.get
sale_status_get body → 2004XX
POST
/sale.status.list
Get the list of statuses sale.status.list
sale_status_list body → 2004XX
POST
/sale.status.update
Update status sale.status.update
sale_status_update body → 2004XX
POST
/sale.statusLang.add
Add Localization sale.statusLang.add
sale_statusLang_add body → 2004XX
POST
/sale.statusLang.deleteByFilter
Delete localization sale.statusLang.deleteByFilter
sale_statusLang_deleteByFilter body → 2004XX
POST
/sale.statusLang.getFields
Get Localization Fields for Statuses sale.statusLang.getFields
sale_statusLang_getFields body → 2004XX
POST
/sale.statusLang.getListLangs
Get the list of languages for localization sale.statusLang.getListLangs
sale_statusLang_getListLangs body → 2004XX
POST
/sale.statusLang.list
Get a list of localizations for sale.statusLang.list
sale_statusLang_list body → 2004XX
POST
/sale.tradeBinding.getFields
Get Available Order Fields from sale.tradeBinding.getFields
sale_tradeBinding_getFields body → 2004XX
POST
/sale.tradeBinding.list
Get a list of orders from sources sale.tradeBinding.list
sale_tradeBinding_list body → 2004XX
POST
/sale.tradePlatform.getFields
Get Available Fields of Order Sources sale.tradePlatform.getFields
sale_tradePlatform_getFields body → 2004XX
POST
/sale.tradePlatform.list
Get a List of Order Sources: sale.tradePlatform.list
sale_tradePlatform_list body → 2004XX

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are BitrixTime (8 properties), BitrixResponse (4 properties), BitrixError (2 properties). Each schema is shown below with its type and property counts.

BitrixError
object
Bitrix24 REST API error response
2 properties 2 required
BitrixTime
object
Request execution time information
8 properties
BitrixResponse
object
Standard Bitrix24 REST API response
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bitrix24-e-commerce-api-openapi.yml Raw ↑

Other APIs Bitrix24 publishes across the network.

Bitrix24 REST API
Bitrix24 BIconnector API
Bitrix24 Business Processes API
Bitrix24 Calendar API
Bitrix24 Chatbots API
Bitrix24 Chats API
Bitrix24 Company Structure API
Bitrix24 CoPilot / AI API
Bitrix24 CRM API
Bitrix24 Data Storage API
Bitrix24 Deprecated Methods API
Bitrix24 Document Generator API
Where this information came from

This is an independent, third-party profile of Bitrix24 E-Commerce API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.