---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/orders-receive.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/orders-receive.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/orders-receive.md
  - href: en/step-by-step/orders-receive.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Receiving orders: API survey or notifications

Choose one of the following methods: API notifications (recommended) or through a regular survey of order information.

## Method 1. API notifications

<!-- source: en/_includes/mermaid/orders-receive-notification.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
      note right of Merchant: Receiving a new order notification
      Market -->> Merchant: POST notification
    end

    rect rgb(251, 243, 232)
      note right of Merchant: Retrieving new order information
      Merchant ->> Market: POST v1/businesses/{businessId}/orders
      Market -->>+ Merchant: OK: order information.
      Merchant ->>- Merchant: Checks availability<br>of ordered items.
    end
```
<!-- endsource: en/_includes/mermaid/orders-receive-notification.md -->

- Enable request acceptance [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md). How to work with notifications: [Instruction manual](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/index.md)
- Receive order events and request details immediately: [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/en/reference/orders/getBusinessOrders.md)
- Notification types and data format: [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md)

## Method 2. Regular API survey

<!-- source: en/_includes/mermaid/orders-receive-poll.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting a list of new orders
        Merchant ->> Market: POST v1/businesses/{businessId}/orders
        Market -->>+ Merchant: OK: list of orders.
        Merchant ->>- Merchant: Checks availability<br>of ordered items.
    end
```
<!-- endsource: en/_includes/mermaid/orders-receive-poll.md -->

- Request order lists:
  - [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/en/reference/orders/getBusinessOrders.md)
- Use filters:
  - `fromDate` and `toDate` — range of delivery dates for sampling new orders
  - `updatedAtFrom` and `updatedAtTo` — selection of orders with changes
- Observe the polling intervals:
  - Express — every 10-15 minutes
  - FBS, DBS — at least once an hour
- To process a specific order, get the details using the method [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/en/reference/orders/getBusinessOrders.md)