October
2025
New
New
Added methods for campaigns with manual bids:
Added the method for getting search cluster statistics for campaigns with manual and unified bids.
Changed
New
New
Added the Underreporting of package dimensions method. Use this method to get new reports:
New
New
To the response of the method for getting stickers for cross-border assembly orders added the field parcelId — assembly order tracking number in the sticker.
Deprecated
Deprecated
Starting from October 27, the deprecated size field will be removed completely from the method responses:
New
New
Now you can use the Realization sales report method to get details for the daily realization reports. Specify period=daily in the request to do this.
New
New
Added the field isBadTurnover — an indicator of a non-liquid product — to the responses of the methods:
The field will only be displayed for products with a low inventory index.
Changed
Changed
Added a method for getting stickers for cross-border assembly orders. Use this method to directly get stickers in PDF format.
Starting from October 23, we will disable the method for getting a list of links to stickers that are required for cross-bordering.
Changed
Changed
To the responses of the methods for getting supplies list and supply details added thestatusID field — supply status ID.
On November 3 will be disabled the fields with supplies types and statuses:
statusName — supply statusboxTypeName — supply typevirtualTypeName — virtual supply typeNow, to specify the supply status and type, use the IDs:
statusID — supply status IDboxTypeID — supply type IDvirtualTypeID — virtual supply type IDThe corresponding of values is provided in the ID descriptions.
Changed
Changed
Combined campaigns with custom and standard bids into one type — 9. Campaign type 8 is deprecated, it will be impossible to create campaigns of this type starting from October 23. The bid type in a campaign is now specified in a separate field.
Updated the methods for Promotion campaigns to work with campaign type 9:
9 with custom or standard bid. The bid type is specified in the bid_type field in the response of the Custom bid campaigns information methodbid_type field:
manual — custom bidunified — standard bidChanging bids in campaigns with custom bid is now called Changing campaigns bids.
To the request of this method added the placement parameter:
search — in search (for campaigns with custom bid)recommendations— in recommendations (for campaigns with custom bid)combined — in search and recommendations (for campaigns with standard bid)type field:
4 — in catalog (deprecated type)5 — in product card (deprecated type)6 — in search (deprecated type)7 — in recommendations on the main page (deprecated type)Changing the list of product cards in campaigns with custom bid is now called Changing the list of product cards in campaignsSeptember
2025
Changed
Changed
Now you can create campaign with custom or standard bid via one method.
To specify the bid type in the campaign, pass it in the bid_type parameter of the method request:
manual — custom bid, specified by defaultunified — standard bidFor campaign with custom bid, specify the display zones in the placement_types parameter:
search — display in search, specified by defaultrecommendations — display in recommendationsThe method for creating campaign with standard bid is available by October 23.
Deprecated
Deprecated
On October 24 we will disable the field needFRefund with product refund information from the methods:
Use the separate method to retrieve buyers returns applications.
Changed
Changed
Added to the details for the weekly realization report:
cashback_commission_change — loyalty program participation costNew
New
Added new method for getting prices. Now you can specify more than one article in request.
Changed
Changed
Moved Promotion Statistics from Analytics and Data to Marketing and Promotions.
Added new version of the method for getting promotion statistics:
canceled — cancellations, pcs. The number of promoted products that were ordered but not delivered to the customer due to technical reasons.Current version is available until September 30.
New
New
Added new fields to the response of the Courier info method:
fullName — courier's full namepTimeFrom — date and time from which the courier will arrivepTimeTo — date and time by which the courier will arriveChanged
Changed
Added to the details for the weekly realization report:
order_uid — transaction ID. Orders in the same buyer's cart will have the same order_uidDeprecated
Deprecated
On September 30 we will disable the methods:
Changed
Changed
From September 17, IMEI will be required for the Smartphones subject, "subjectId":515 for the DBW and DBS assembly orders.
If IMEI is not specified, the assembly order cannot be transferred to delivery.
The previous conditions are no longer applicable.
New
New
A cashbacks array with information about promo bonuses added to the response of the method for getting balance:
sum — promo bonuses, ₽percent — the percentage of the campaign budget top-up amount that can be paid with promo bonuses at one timeexpiration_date — promo bonuses expiration dateAdded parameters for topping up the campaign budget with promo bonuses:
cashback_sum — top-up budget sum paid with promo bonuses cashback_percent — The percentage of the top-up amount that can be paid with promo bonusesNew
Changed
Changed
Added new error of the 200 response to the Processed upload details method:
You can't change the item price. Item was added to the Sale due to high inventory
The error means that the product is put on sale based on its inventory index.
Changed
Changed
Added new version of the method for getting list of failed product cards with errors (drafts). In the new version of the method implemented pagination and data transfer in batches.
The current version will be disabled on September 30.
New
New
Added fields descriptions to the method for getting seller warehouses list:
isDeleting — warehouse is being deleted: false — no, true — yes.isProcessing — warehouse is being updated: false — no, true — yes. true, update and deletion of inventory will be unavailable
August
2025
Changed
Changed
We are disabling the ability to update inventory for small-sized products for the FBS model on warehouses that correspond to over dimensional cargo products and dimensional cargo+ products.
All small-sized product inventories on unsuitable warehouses ("cargoType": 2 and "cargoType": 3) will be automatically deleted on September 10. Please move the inventories to suitable virtual warehouses ("cargoType": 1) before this date.
Changed
Changed
On September 8:
Deprecated
Deprecated
Starting from September 1, we will disable the method for obtaining the Turnover Dynamics report.
You can obtain the turnover dynamics data in the Stocks Report: the saleRate and avgStockTurnover objects.
New
New
Added method for getting minimum bids for product cards. Now you can obtain minimum bids by parameters:
nm_id — WB articles arrayadvert_id — campaign IDpayment_type — payment typeplacement_types — display zonesWe will disable the method for getting promotional configuration values on September 16. New method for obtaining configuration values will be announced later.
Changed
Changed
Added new fields to the response of getting new assembly orders method:
finalPrice — the sum charged to the buyer in the currency of sale including all discounts, multiplied by 100convertedFinalPrice — the sum charged to the buyer in the currency of the seller's country including all discounts, multiplied by 100Currency codes are specified in thecurrencyCode and convertedСurrencyCode fields. The sums are provided for informational purposes only.
New
New
Added the wholesale object to the requests and responses of the Content methods.
Use it to:
New
New
Added new methods for campaigns with custom bid, previously, Auction:
Starting from September 9, it will be impossible to get campaigns with custom bid and change their bids using the Campaigns information and Changing bids methods.
New
New
Added list of complaint reasons submitted through the seller portal in the response of the method for getting list of reasons for complaints about feedbacks and product issues:
The lists of complaint reasons on the seller portal and in the API are different. It is not possible to submit a complaint via the API using a reason from the seller portal.
If a complaint is submitted via the seller portal (for example, 13 — Spam in the text), the reason specified on the portal (13 — Spam in the text) will be displayed in the responses of the methods for getting the feedback by ID, feedbacks list and the list of archived feedbacks.
If a complaint is submitted via the API (for example, with reason 3 — Spam), the reason passed via the API will be displayed in the responses of the same methods, while the corresponding reason from the seller portal list (13 — Spam in the text) will be displayed on the seller portal.
Changed
Changed
Starting September 1, IMEI is required for products costing 20,000 rubles or more for assembly orders of DBW, DBS, and In-Store Pickup models.
If the IMEI is not specified:
Changed
Changed
Now in the sandbox In-Store Pickup assembly orders automatically receive the same orderCode, if you create multiple assembly orders with a single request. The generated orderCode is passed in the response of the method of getting new assembly orders.
New
New
Added new fields to the response of the Box tariffs method:
boxDeliveryCoefExpr — coefficient Logistics, %. The logistics cost is multiplied by it. Already included in the tariffsboxDeliveryMarketplaceBase — FBS logistics of the first liter, ₽boxDeliveryMarketplaceCoefExpr — coefficient FBS, %. The FBS logistics cost is multiplied by it. Already included in the tariffsboxDeliveryMarketplaceLiter — FBS logistics of every next liter, ₽ boxStorageCoefExpr — coefficient Storage, %. The storage cost is multiplied by it. Already included in the tariffsgeoName — country, for Russian Federation — federal district The field boxDeliveryAndStorageExpr will be removed on August 19.
Deprecated
Deprecated
Now when forming a supply for delivery to a pickup point, it is enough to specify the number of boxes when adding them to the supply. It is no longer necessary to add a list of assembly orders to the box.
Starting August 18, will be disabled:
orders array will be removed from the method responseNew
New
Separate environment for working with DBW model methods:
https://marketplace-api.wildberries.ru/api/v3/dbw/...Information on all DBW methods is now in the new DBW Orders section of the documentation.
Changed
Changed
Divided rate limits for Marketplace methods according to sales models:
Separated the limits for getting and deleting metadata for FBS, DBS, and In-Store Pickup from the limits for methods for adding metadata.
Allocated separate rate limits for methods:
New
New
Changes in the FBW Supplies section:
July
2025
New
New
To the response of the method Chat List added new object goodCard with information about the product card, for which the buyer started the chat:
date — order dateneedRefund — has refund been requestednmID — WB articleprice — actual price with all discounts applied. Charged to the buyerpriceCurrency — currencyrid — unique order IDsize — product sizestatusID — product statusChanged
Changed
officeID field — ID of the WB warehouse associated with the seller's warehouse — to the methods:
destinationOfficeId field — ID of the destination office for the supply — to the methods:
Starting from September 1, in the method for adding assembly orders to a supply, an error 409 will be returned if the officeID of the assembly order does not match the destinationOfficeID of the supply.
The destinationOfficeId field will only be present in new supplies. If the supply has a cargoType field, changes will not affect it.
New
New
In the sandbox added new fields with the final product price that the customer paid to the information about DBS and In-Store Pickup assembly orders:
• finalPrice — the price in the currency of sale including all discounts, multiplied by 100
• convertedFinalPrice — the price in the currency of seller’s country including all discounts, multiplied by 100
Also added new fields to the information about In-Store Pickup assembly orders in the sandbox:
• convertedPrice — the price in the currency of seller’s country including all discounts, except the WB Wallet discount, multiplied by 100
• convertedCurrencyCode — the currency code of the seller's country
The prices are provided for informational purposes.
New fields are added to the responses of the methods:
New
New
cashback_amount — amount withheld for accured loyalty program pointscashback_discount — reimbursement of the loyalty programFor more details about product cashback, see on the sellers' portal
New
New
reason — the reason for the returnorderId — assembly order numberreadyToReturnDt — date and time when the return is ready for deliveryexpiredDt — expiration date and time of the storage periodcompletedDt — date and time the seller received returnNew
New
Starting from July 21, you can set the product expiration date in the metadata of FBS assembly order.
To check if you can set the product expiration date for assembly order, use the method Get new orders. If the response to the method has the value expiration in the requiredMeta field, you can set the product expiration date. If the response does not return the expiration value, it is not possible to set the product expiration date for this assembly order.
To set the product expiration date, use the new method Add expiration date to the order. The minimum period is 30 days. The product expiration date can only be set for assembly orders in the confirm status. To change the expiration date, send a request with the new date.
To check the set product expiration date, use the method Get order metadata. The set expiration date will be displayed in the expiration field. If the field expiration contains the value null, the product expiration date hasn’t been set yet.
It is impossible to remove the expiration date from the metadata of the assembly order.
Changed
Changed
To the method response for getting the WB offices added the new federalDistrict field — federal district of the WB office. If the value of the field is null, the office is located outside the Russian Federation or the federal district is not specified.
New
New
Added fields in the response of the method for getting the list of warehouses:
isActive — whether the warehouse is available as a destination warehouseisTransitActive — whether the warehouse is available as a transit warehouseStarting from July 14, the limit for the method of getting reception options is 6 requests per minute.
June
2025
New
New
In the new sandbox, you can test the In-Store Pickup orders methods. The sandbox is available via token with the Test Scope option.
The sandbox allows you to manage:
Methods for managing warehouses and warehouse inventory are also available.
Updated the sandbox description with a status model and separate test methods for creating and cancelling In-Store Pickup assembly orders.
Changed
Changed
sale_percent — Harmonized product discount, %product_discount_for_report — Final agreed discount, %supplier_promo — Promo code, %ppvz_spp_prc — Regular Customer Discount (RCD), %ppvz_kvw_prc_base — The amount of the Wildberries remuneration coefficient (cWR) without VAT, % Basicppvz_kvw_prc — The final Wildberries remuneration coefficient (cWR) without VAT, % Basicsup_rating_prc_up — The amount of reduction in the Wildberries remuneration coefficient (cWR) due to the rating, %rid fieldNew
New
SearchReportProductReq of creating reports in CSV format method:
includeSubstitutedSKUs — Show data for direct queries with promo itemsincludeSearchTexts — Show data for search queries without promo itemsfalse at the same timeSearchReportProductRes reports in CSV format:
isSubstitutedSKU — If the product was searched by the promo item. Displayed if the request contains the includeSubstitutedSKUs and/or includeSearchTexts parameterslimit parameter in the request of the getting the top search texts by product and the model SearchReportTextReq of creating reports in CSV format methodsearchTexts request array of the getting data on the number of orders and positions by queries methodDeprecated
Deprecated
June 23New
New
Added new fields with the final product price that the customer paid to the information about DBS and In-Store Pickup assembly tasks:
• finalPrice — the price in the currency of sale including all discounts, multiplied by 100
• convertedFinalPrice — the price in the currency of seller’s country including all discounts, multiplied by 100
Also added new fields to the information about In-Store Pickup assembly tasks:
• convertedPrice — the price in the currency of seller’s country including all discounts, except the WB Wallet discount, multiplied by 100
• convertedCurrencyCode — the currency code of the seller's country
The prices are provided for informational purposes.
New fields are added to the responses of the methods:
Deprecated
Deprecated
The refund object has been deprecated from the method for retrieving chat events. Now, events can only be of the message type. To obtain refund claims, use the buyers returns methods.
New
New
Finance categoryNew
New
Added the field replacementPhone to the retrieving buyer information method response — the main phone number for contacting the customer. It eliminates the need to enter additional codes.
The current contact method remains as a backup in case the replacementPhone is unavailable.
New
New
In the new sandbox, you can test the FBS orders methods The sandbox is available via token with the Test Scope option.
The sandbox allows you to manage:
Additionally, methods for managing warehouses and warehouse inventory methods are available in the FBS orders sandbox
May
2025
Changed
Changed
New
New
We are gradually transitioning to a mechanism for retrieving files by ID instead of direct link access. This new approach eliminates direct access to message files.
Currently, the new mechanism affects a small portion of files. The file ID is provided along with "url":"". Gradually, files from all new messages will be accessible only by ID.
Changes:
• added a downloadID field to the files and images message structures — the file ID.
• added a method for retrieving a file from a message — use the file ID from the message body to obtain the file through this method.
We will notify you once the transition to the new file retrieval mechanism is complete.
For all messages containing a direct file link, the file retrieval mechanism will remain unchanged.
New
New
kgvpPickup — Commission on the model In-store pickup (C&C), %kgvpBooking — Commission on the model Booking, %New
New
New
New
Changed
Changed
errorText values (see details below)April
2025
Deprecated
Deprecated
Deprecated
Deprecated
New
New
wibes_wb_discount_percent — Wibes discount, %installment_cofinancing_amount — Co-financing program discountChanged
Changed
Starting April 30, you will not be able to delete or update inventory at warehouses if the warehouse is already being updated or deleted.
In response to a request for such a warehouse, you will receive an error with status code 409 and the message "The store is processing"
Please wait a few seconds and try the request again.
Changed
Changed
Starting May 26, you will not be able to update the inventory of small-sized goods ("cargoType": 1) using the FBS model if the virtual warehouse is designated for oversized and large items. These inventories can only be deleted.
Therefore, we recommend transferring the inventory of small-sized goods to appropriate virtual warehouses now.
New
New
As per your requests, we wrote the instruction on rate limits in the General section. Included links to the instruction in annotations for all methods
New
New
needKiz field – is a labeling code required for the productMarch
2025
Changed
Changed
New
New
Added a method for changing product cards bids.
The Bid update method will be disabled on 27 april.
New
New
StocksReportReqStocksReportResNew
New
Added a method for obtaining delivery date and time.
The fields: ddate — planned delivery date, dTimeFrom — delivery time "from" and dTimeTo — delivery time "to" in the method for obtaining new orders will be disabled on April 9.
New
New
You can learn more about working with the In-Store Pickup model in the description.
Changed
Changed
inWayToClient, inWayFromClient, and quantityWarehousesFull fields from the getting report methodwarehouses array —in the fields warehouseName and quantity. In warehouseName, the column names from the report version in the personal account are specified. This means that the value of warehouseName can be both "Koledino" and "To the client"New
New
Added a B2B sale indicator to the API orders methods.
Date of update: 06.03.2025
Added a B2B sale indicator to the orders information (FBS and DBS) — the isB2B field in the options structure.
In orders completed before February 26, the isB2B will always be false, even if it was a B2B sale.
List of methods to whose responses we have added the indicator:
Get new orders (FBS)
Get orders (FBS)
Get new orders list (DBS)
Changed
Changed
packed product must now be provided in the weightBrutto parameter of the dimensions object during the creation, creation with merge, and editing of product cards. The weight should always be in kilograms.weightBrutto field to the dimensions object in the list of product cards and list of product cards in the trash.On March 12, we will disable the transmission of objects containing the weight of the packed product in the responses of the method for obtaining subject characteristics.On March 31, we will disable specifying the weight of the packed product in the characteristics array. Afterward, if requests for creation, creation with merge, and editing of product cards contain objects with the weight of the packed product, a response with a status code of 400 will be returned.March 31, we will disable the transmission of the packed product in the characteristics array in the list of product cards and list of product cards in the trash.unpacked product. It will continue to be transmitted in the characteristics array in all the methods mentioned earlier.February
2025
New
New
Deprecated
Deprecated
Changed
Changed
content field instead of the text field — and without HTML formattingtypesChanged
Changed
SearchReportTextReq model — search texts:
subjectIds — IDs of subjects for filteringtagIds — IDs of tags for filteringsubjectId and tagId in the SearchReportProductReq model — search parametersDeprecated
Deprecated
We plan to disable all subdomains ending with wb.ru that were listed on the openapi.wb.ru portal — they are not used in the new documentation. Instead of supporting two domains — wildberries.ru and wb.ru — we will only retain wildberries.ru.
Currently, the following services are operating on the wb.ru domain:
The same methods and data are available on the wildberries.ru domain as on wb.ru.
It is necessary to switch from wb.ru to the current domain wildberries.ru by April 15, as the discontinuation of the wb.ru domain will affect the integration functionality.
Changed
Changed
section parameter from the request of the offer edit method. The change does not need a required update on your part, as it does not affect API integrations. If you don't remove the parameter from the request, it will be ignored by the system.New
New
SearchReportTextReqSearchReportTextResnmId — WB articlesubjectName — subject namebrandName — brand namevendorCode — seller's articlename — product nameisCardRated — if the product card has a ratingrating — product card ratingfeedbackRating — feedbacks ratingprice — pricemedianPosition — median positionJanuary
2025
New
New
Test Environment option is not selected.New
New
dlv_prc – Fixed warehouse supply ratiofix_tariff_date_from – Commitment start datefix_tariff_date_to – Commit expiration datepayment_processing – Type of payment for Acquiring/Payment organization feessrv_dbs – A sign of a paid delivery serviceassembly_id – Assembly task numberis_legal_entity – B2B sale attributetrbx_id – The number of the box for paid acceptanceNew
New
categories.December
2024
New
New
warehouseType field to the descriptions of the orders and sales methods. The field can have the following values:
Склад WB — WB WarehouseСклад продавца — seller's WarehouseNew
New
Added a method for retrieving data on daily dynamics
New
New
Added the display of Auction products bids in the response of the method for retrieving campaigns information. Structure — auction_multibids
New
New
A field named srid has been added to the response of the method for retrieving buyers returns claims. This field represents the unique order ID for which a product claim was created
New
New
Added a method for obtaining the service's configuration values, such as minimum campaign budget, minimum bid size for automatic campaigns and auctions and so on
Changed
Changed
ranging array to the responses of the detailed promotion information method, if product ranking in promotions is enabled. The array consists of objects based on ranking conditions. The objects include the following fields:condition — type of rankingparticipationRate — percentage of seller's products needed to advance to the next ranking level, %boost — current search boost level, %Changed
Changed