WB API Digest — January 2026

In January 2026, Wildberries released 7 API updates. Key topics: a new method for retrieving B2B buyer data in DBS, cross-border support in FBS assembly orders and supplies, and continued expansion of the sales report with new discount fields.

Disclaimer: Practical recommendations in this digest may vary depending on the specifics of your implementation.

Ready-made Postman collection: For convenient testing and working with the API, we've prepared a collection of methods from this digest. Import it into your Postman, set your API key in the api_key variable, and start working with the methods right away.

---

At a Glance

---

Reminders from Previous Digests

If you missed the December digest, note that several deadlines are still ahead:

---

Critical Changes with Deadlines

---

DBS Orders

New Method: B2B Buyer Information

A new method for retrieving B2B buyer information has been added for the DBS model. You can now get B2B buyer data via the API: TIN, KPP, and organization name.

The method accepts an array of assembly order IDs and returns buyer details for each one. To determine whether an order is a B2B sale, check the options.isB2b field in the response of the Get new DBS assembly orders method. If isB2b: true — call the new method to get the buyer's details.

What This Enables

For business:

• Automatic generation of closing documents for legal entities
• Faster B2B order processing without manually requesting details
• Ability to maintain separate B2B and B2C sales accounting

For developers:

• Integration with accounting systems (1C, MoySklad) for automatic invoice generation
• Order data enrichment with buyer details without manual entry

---

FBS Orders

crossBorderType Field in Assembly Orders and Supplies

The crossBorderType field has been added to the responses of four FBS methods, indicating whether an assembly order or supply is cross-border.

The field appears in assembly order methods:

• Get new assembly orders list
• Get assembly order information

And in supply methods:

• Get supply list
• Get supply information

How supplies work: you can add any assembly order — cross-border or not — to an empty supply. The supply inherits the type of the first added order, after which only orders of the same type can be added. This behavior is analogous to how a supply inherits its cargo type (cargoType) from the first order.

If you work with cross-border via FBS, use crossBorderType to route orders into separate supplies and correctly handle logistics flows.

---

Documents and Accounting

New Fields in Sales Report Details

The Sales by realization report method continues to expand — two sets of fields were added in January. As a reminder, in December the same method received the delivery_method, seller_promo_id, and seller_promo_discount fields.

Loyalty Discounts (from January 12)

The loyalty_id and loyalty_discount fields have been added to the response — they show the ID and percentage of the seller's loyalty discount. More about the loyalty discount mechanics: announcement.

Promo Code Discounts (from January 19)

Similarly, uuid_promocode and sale_price_promocode_discount_prc have been added — the promo code ID and its discount percentage. More about promo codes: announcement.

Both updates are available in daily and weekly reports starting from the dates listed above. If you build management reporting based on the API, add processing for the new fields for accurate discount accounting.

---

Customer Communication

Deprecated Field Removal from Chats

Wildberries continues cleaning up deprecated fields in the Chat list and Chat events methods. The clientID field (buyer ID) will be removed on February 2, and the statusID field (product status) on February 10.

Both fields have long been obsolete and were marked as deprecated in the documentation. If your code processes these fields — remove them before the respective deadlines to avoid parsing errors.

Image Format in Feedbacks

Starting February 5, images in the photoLinks field will be returned in webp format instead of jpg for the following methods:

• Feedbacks List
• Get Feedback by ID
• Archived Feedbacks List

The URL format in the fullSize and miniSize fields will change — file extensions in links will be .webp instead of .jpg. If you save or process feedback photos, make sure your code handles the webp format correctly. Most modern image processing libraries support webp, but if you validate file extensions or MIME types — update those checks.

---

Migration Checklist

Before February 2

• Remove clientID field handling in chat methods
• (from December) Complete migration from type 8 campaigns to type 9

Before February 5

• Update image format handling in photoLinks (webp instead of jpg)

Before February 9

• (from December) Replace barcodes with chrtId in all inventory methods

Before February 10

• Remove statusID field handling in chat methods

Before March 11

• (from December) Migrate from the "Supplies" method to "Supply Information" methods

Recommended Improvements

• Integrate the B2B buyer data method into DBS order processing
• Use crossBorderType to route cross-border FBS orders
• Add loyalty_id, loyalty_discount, uuid_promocode, and sale_price_promocode_discount_prc to financial reporting

---

Useful Links

Official documentation and resources

• Official WB API Documentation
• Release Notes with all updates
• Sandbox for API testing