--- title: "Orders" description: "The method returns order information. The data updated every 30 minutes." lang: en-US source: https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/reports/get-api-v1-supplier-orders --- # Orders ```http GET /api/v1/supplier/orders ``` **Base URL:** `https://statistics-api.wildberries.ru` · **Module:** [`reports`](https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/reports/) · **Section:** Main Reports · [Specification doc ↗](https://dev.wildberries.ru/en/docs/openapi/reports#tag/mainReports/operation/getV1SupplierOrders) The method returns order information. The data updated every 30 minutes. 1 line means 1 order and means 1 item. The `srid` field should be used to identify the order. Data storage is guaranteed for no more than 90 days from the date of order. The responses do not include orders for which payment was not confirmed. For example, it could be orders with delayed payments or installment payments. However, if there are sales for such orders, you can get it using [details for the sales reports](https://dev.wildberries.ru/openapi/documents-and-accounting#tag/financialReports). To receive all completed orders, use [Order Feed](https://dev.wildberries.ru/openapi/analytics#tag/orderFeed). The data in this report is preliminary and is used for operational monitoring For a single response to a request with `flag=0` or without `flag`, a conditional limit of 80,000 rows is set. Therefore, more than one request may be necessary to retrieve all orders. In the second and subsequent requests, use the full value of the `lastChangeDate` field of the last row from the response of the previous request in the `dateFrom` parameter. If the response returns an empty array `[]`, all orders have already been retrieved. [Request limit](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Rate-Limits) per one seller account: | Type | Period | Limit | Interval | Burst | | ---------------- | ------ | --------- | -------- | ----------- | | Personal | 1 min | 1 request | 1 min | 10 requests | | Service | 1 min | 1 request | 1 min | 10 requests | | Base with secret | 1 min | 1 request | 1 min | 10 requests | | Base | 3 h | 1 request | 3 h | 1 request | ## Parameters | Name | In | Type | Req. | Description | | ---------- | ----- | -------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dateFrom` | query | `string` | yes | Date and time of last change on the order. Date format: RFC3339. You may send date or date with time. Time could be specified in seconds or milliseconds. The time stands in Moscow time zone (UTC+3). Examples: - `2019-06-20` - `2019-06-20T23:59:59` - `2019-06-20T00:00:00.12345` - `2017-03-25T00:00:00` | ## Responses | Code | Description | Schema | | ----- | ----------------- | -------------------------------- | | `200` | Success | `GetV1SupplierOrdersResponse200` | | `400` | Bad request | `object` | | `401` | Unauthorized | `object` | | `402` | Payment required | `object` | | `403` | Access denied | `object` | | `429` | Too many requests | `object` | **Structure `200` — `OrdersItem[]`:** - `date` `string` — Date and time of order. This field equals to `dateFrom` in request if `flag=1`. If the time zone is not specified, then Moscow time UTC+3 is taken. - `lastChangeDate` `string` — Date and time of refreshing info of service. This field corresponds to the `dateFrom` parameter in the request if the `flag=0` parameter exist or not specified. If the time zone is not specified, then Moscow time UTC+3 is taken. - `warehouseName` `string` — Shipping warehouse name - `warehouseType` `string` = `Склад WB` | `Склад продавца` — Type of items storage warehouse: - `Склад WB` — WB warehouse - `Склад продавца` — seller warehouse - `countryName` `string` — Country - `oblastOkrugName` `string` — Area - `regionName` `string` — Region - `supplierArticle` `string` — Seller item number - `nmId` `integer` — WB item number - `barcode` `string` — SKU - `category` `string` — Category - `subject` `string` — Subcategory - `brand` `string` — Brand - `techSize` `string` — Item size - `incomeID` `integer` — Supply number - `isSupply` `boolean` — Supply contract - `isRealization` `boolean` — Implementation contract - `totalPrice` `number` — Price without discounts - `discountPercent` `integer` — Seller discount, % - `spp` `number` — WB discount, % - `finishedPrice` `number` — Price with all discounts, except WB Wallet sum - `priceWithDisc` `number` — Price with seller discount, including WB Club discount - `isCancel` `boolean` — Order cancel: - `true` — the order is cancelled - `cancelDate` `string` — Date and time for order canceling. If order wasn't canceled, then `"0001-01-01T00:00:00"`. If the time zone is not specified, then Moscow time UTC+3 is taken. - `sticker` `string` — sticker ID - `gNumber` `string` — Buyer cart ID. Orders within a single transaction will have the same `gNumber` - `srid` `string` — Unique order ID. Note for those working with Marketplace API: `srid` equals `rid` in response of orders methods **Structure `400`:** - one of: `responseErrorStatistics`, `responseErrorStatistics2` **Structure `401`:** - `title` `string` — Error title - `detail` `string` — Error details - `code` `string` — Internal error code - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID - `status` `number` — HTTP status code - `statusText` `string` — Text of the HTTP status code - `timestamp` `string` — Request date and time **Structure `402`:** - `title` `string` — Error title - `detail` `string` — Error details. The error is only returned to services from the [Solutions for business Catalog](https://dev.wildberries.ru/business-solutions) **Structure `403`:** - `title` `string` — Error title - `detail` `string` — Error details - `code` `string` — Internal error code - `requestId` `string` — Request ID - `origin` `string` — WB internal service ID - `status` `number` — HTTP status code - `statusText` `string` — Text of the HTTP status code - `timestamp` `string` — Request date and time **Structure `429`:** - `title` `string` — Error title - `detail` `string` — Error details - `code` `string` — Internal error code - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID - `status` `number` — HTTP status code - `statusText` `string` — Text of the HTTP status code - `timestamp` `string` — Request date and time ## Call examples Arguments are shown as parameter names — substitute your own values. Languages whose client does not expose this operation are omitted. **Python** ```python from wb_api_client.reports import Configuration, ApiClient from wb_api_client.reports.api import ReportsApi cfg = Configuration(access_token="") api = ReportsApi(ApiClient(cfg)) result = api.get_v1_supplier_orders(date_from=..., flag=...) print(result) ``` **TypeScript** ```ts import { Configuration, ReportsApi, } from "@valeryverkhoturov/wb-api-client/reports"; const cfg = new Configuration({}); cfg.setAccessToken(""); const api = new ReportsApi(cfg); const { data } = await api.getV1SupplierOrders(dateFrom, flag); console.log(data); ``` **Go** ```go import ( "context" "fmt" wbreports "github.com/ValeryVerkhoturov/wb-api-client-go/reports" ) cfg := wbreports.NewConfiguration() cfg.SetAccessToken("") client := wbreports.NewAPIClient(cfg) result, _, err := client.ReportsAPI.GetV1SupplierOrders(context.Background()).DateFrom(dateFrom).Execute() if err != nil { panic(err) } fmt.Printf("%+v\n", result) ``` **Java** ```java import io.github.valeryverkhoturov.wbapi.reports.ApiClient; import io.github.valeryverkhoturov.wbapi.reports.SecretString; import io.github.valeryverkhoturov.wbapi.reports.api.ReportsApi; ApiClient client = new ApiClient(); client.setAccessToken(new SecretString("")); ReportsApi api = new ReportsApi(client); System.out.println(api.getV1SupplierOrders(dateFrom, flag)); ``` **PHP** ```php use ValeryVerkhoturov\WbApiClient\Reports\Configuration; use ValeryVerkhoturov\WbApiClient\Reports\SecretString; use ValeryVerkhoturov\WbApiClient\Reports\Api\ReportsApi; use GuzzleHttp\Client; $config = (new Configuration()) ->setAccessTokenSecret(new SecretString('')); $api = new ReportsApi(new Client(), $config); print_r($api->getV1SupplierOrders($date_from)); ``` **OneScript** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен(""); Клиент = Новый ReportsApi(Настройки); Сообщить(Клиент.GetV1SupplierOrders(dateFrom).Тело); ``` **C#** ```csharp using ValeryVerkhoturov.WbApiClient.Reports.Api; using ValeryVerkhoturov.WbApiClient.Reports.Client; var config = new Configuration(); config.AccessTokenSecret = new SecretString(""); var api = new ReportsApi(config); Console.WriteLine(api.GetV1SupplierOrders(dateFrom)); ``` **Rust** ```rust use wb_api_client::reports::apis::{configuration::Configuration, reports_api}; #[tokio::main] async fn main() { let mut cfg = Configuration::new(); cfg.set_access_token(""); let result = reports_api::get_v1_supplier_orders(&cfg, date_from, flag).await; println!("{:#?}", result); } ```