---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/promos/getPromos.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/promos/getPromos.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/promos/getPromos.md
  - href: zh/reference/promos/getPromos.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/zh/llms.txt

<!-- source: zh/api/promos/getPromos.md -->
<div class="openapi">

# 获取股票列表

<!-- markdownlint-disable-file -->

{% list tabs %}

- Info

  
  <!-- source: zh/_auto/method_scopes/getPromos.md -->
  **方法适用于模式：[FBY, FBS, Express 和 DBS](https://yandex.com/dev/market/partner-api/doc/zh/overview/business.md).**

  目前不适用于卖家Market Yandex Go.

  {% cut "**如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一**" %}

  * pricing — [价格管理](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/pricing.md)
  * pricing:read-only — [查看价格](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/pricing_read-only.md)
  * promotion — [商品推广](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/promotion.md)
  * promotion:read-only — [查看商品推广信息](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/promotion_read-only.md)
  * all-methods — 全面管理账户
  * all-methods:read-only — 查看所有数据

  {% endcut %}
  <!-- endsource: zh/_auto/method_scopes/getPromos.md -->
  
  
  返回有关市场促销的信息。 它不返回有关卖方创建的股票的数据。
  
  默认情况下，卖方参与或可能参与的促销活动将被退回。
  
  要获取当前或已完成的促销，请传递参数 `participation`.
  
  响应中返回的共享类型:
  
  * 直接折扣;
  * flash推广;
  * 通过促销代码折扣.
  
  
  <!-- source: zh/_auto/method_limits/getPromos.md -->
  |<div style="text-align: left;">**⚙️ 限额:** 1 000 请求 每小时</div>|
  |-|
  <!-- endsource: zh/_auto/method_limits/getPromos.md -->
  
  
  
  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  POST {.openapi__method}
  ```text translate=no
  https://api.partner.market.yandex.ru/v2/businesses/{businessId}/promos
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Path parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  内阁ID。
  
  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "participation": "PARTICIPATING_NOW",
    "mechanics": "DIRECT_DISCOUNT"
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _mechanics_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  推广类别:
  
  * `DIRECT_DISCOUNT` — 直接折扣。
  
  * `BLUE_FLASH` — 一个闪光的促销。
  
  * `MARKET_PROMOCODE` — 通过促销代码折扣.
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `DIRECT_DISCOUNT`, `BLUE_FLASH`, `MARKET_PROMOCODE`
  {.table-cell}
  ||
  ||
  
  _participation_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  在不指定过滤器的情况下，将返回卖家参与或可能参与的促销活动。
  
  指定过滤器时将返回哪些共享:
  
  * `PARTICIPATING_NOW` — 卖方参与的当前促销活动。
  
  * `PARTICIPATED` — 完成了卖家在过去一年中参与的促销活动。 如果一年内少于15股，则响应将始终显示最后15股。
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `PARTICIPATING_NOW`, `PARTICIPATED`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  的市场份额列表。
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "result": {
      "promos": [
        {
          "id": "example",
          "name": "example",
          "period": {},
          "participating": true,
          "assortmentInfo": {},
          "mechanicsInfo": {},
          "bestsellerInfo": {},
          "channels": [
            null
          ],
          "constraints": {}
        }
      ]
    }
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _status_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    响应的类型。
    可能的值:
    * `OK` — 没有错误。
    * `ERROR` — 处理请求时出错。
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    服务器响应的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _result_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _promos_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _assortmentInfo_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _activeOffers_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    参与或参与促销的产品数量。
  
    自动添加的产品不计算在内。
  
    阅读有关产品自动和手动添加到促销活动的信息 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/marketing/promos/market/index).
  
    {.table-cell}
    ||
    ||
  
    _potentialOffers_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    促销中可用产品的数量。
  
    该参数仅针对当前和未来的促销活动返回。
  
    {.table-cell}
    ||
    ||
  
    _processing_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: boolean
  
    产品范围是否有任何尚未应用的变化？ 保存更改需要一些时间。
  
    该参数仅针对当前和未来的促销活动返回。
  
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    有关促销中的产品的信息。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "activeOffers": 0,
      "potentialOffers": 0,
      "processing": true
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _bestsellerInfo_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _bestseller_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: boolean
  
    促销是"市场畅销书"吗？ 阅读更多有关此推广活动的资料 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/marketing/promos/market/bestsellers).
    {.table-cell}
    ||
    ||
  
    _entryDeadline_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string&lt;date-time&gt;
  
    我可以在什么日期将商品添加到"市场畅销书"促销活动中？
  
    该参数仅用于当前和未来的畅销书市场促销。
  
  
    _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
    {.table-cell}
    ||
    ||
  
    _renewalEnabled_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: boolean
  
    是否启用了"市场畅销书"促销之间的分类自动转移。 阅读它是如何工作的。 [在市场对卖家的帮助](https://yandex.ru/support/marketplace/ru/marketing/promos/market/bestsellers#next).
  
    该参数仅用于当前和未来的畅销书市场促销。
  
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    有关"市场畅销书"促销的信息。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "bestseller": true,
      "entryDeadline": "2025-01-01T00:00:00Z",
      "renewalEnabled": true
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _id_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    促销的ID。
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _mechanicsInfo_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _type_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    推广类别:
  
    * `DIRECT_DISCOUNT` — 直接折扣。
  
    * `BLUE_FLASH` — 一个闪光的促销。
  
    * `MARKET_PROMOCODE` — 通过促销代码折扣.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `DIRECT_DISCOUNT`, `BLUE_FLASH`, `MARKET_PROMOCODE`
    {.table-cell}
    ||
    ||
  
    _promocodeInfo_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _discount_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    促销代码的折扣百分比。
    {.table-cell}
    ||
    ||
  
    _promocode_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    促销代码。
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    类型的信息 `MARKET_PROMOCODE`.
  
    该参数仅针对此类型的提升填写。
  
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "promocode": "example",
      "discount": 0
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    促销类型的信息。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "DIRECT_DISCOUNT",
      "promocodeInfo": {
        "promocode": "example",
        "discount": 0
      }
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _name_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    促销的名称。
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _participating_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: boolean
  
    无论卖家是否参与此促销活动。
  
    对于当前和未来的促销，它将随值返回 `true` 如果促销中有手动添加的产品。 如果产品未包含在促销中或已自动添加到促销中，则将随值返回参数 `false`.
  
    对于过去的促销活动，它始终与值一起返回 `true`.
  
    阅读有关产品自动和手动添加到促销活动的信息 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/marketing/promos/market/index).
  
    {.table-cell}
    ||
    ||
  
    _period_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _dateTimeFrom_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string&lt;date-time&gt;
  
    促销开始的日期和时间。
  
    _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
    {.table-cell}
    ||
    ||
  
    _dateTimeTo_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string&lt;date-time&gt;
  
    促销结束的日期和时间。
  
    _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    促销的时间。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "dateTimeFrom": "2025-01-01T00:00:00Z",
      "dateTimeTo": "2025-01-01T00:00:00Z"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _channels_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    品推广渠道列表。
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "PUSH"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _constraints_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _warehouseIds_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer[] &#124; null
  
    促销有效的仓库id。 储存在其他仓库的货物将不会在促销活动下出售。
  
    仅当促销条款中存在库存限制时，才返回该参数。
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      0
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    促销活动的限制。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "warehouseIds": [
        0
      ]
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    燕基科斯. 市场推广。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "id": "example",
        "name": "example",
        "period": {
          "dateTimeFrom": "2025-01-01T00:00:00Z",
          "dateTimeTo": "2025-01-01T00:00:00Z"
        },
        "participating": true,
        "assortmentInfo": {
          "activeOffers": 0,
          "potentialOffers": 0,
          "processing": true
        },
        "mechanicsInfo": {
          "type": "DIRECT_DISCOUNT",
          "promocodeInfo": {
            "promocode": "example",
            "discount": 0
          }
        },
        "bestsellerInfo": {
          "bestseller": true,
          "entryDeadline": "2025-01-01T00:00:00Z",
          "renewalEnabled": true
        },
        "channels": [
          "PUSH"
        ],
        "constraints": {
          "warehouseIds": [
            0
          ]
        }
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    有关市场促销的信息。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "promos": [
        {
          "id": "example",
          "name": "example",
          "period": {
            "dateTimeFrom": "2025-01-01T00:00:00Z",
            "dateTimeTo": "2025-01-01T00:00:00Z"
          },
          "participating": true,
          "assortmentInfo": {
            "activeOffers": 0,
            "potentialOffers": 0,
            "processing": true
          },
          "mechanicsInfo": {
            "type": "DIRECT_DISCOUNT",
            "promocodeInfo": {
              "promocode": "example",
              "discount": 0
            }
          },
          "bestsellerInfo": {
            "bestseller": true,
            "entryDeadline": "2025-01-01T00:00:00Z",
            "renewalEnabled": true
          },
          "channels": [
            "PUSH"
          ],
          "constraints": {
            "warehouseIds": [
              0
            ]
          }
        }
      ]
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "result": {
        "promos": [
          {
            "id": "example",
            "name": "example",
            "period": {
              "dateTimeFrom": "2025-01-01T00:00:00Z",
              "dateTimeTo": "2025-01-01T00:00:00Z"
            },
            "participating": true,
            "assortmentInfo": {
              "activeOffers": 0,
              "potentialOffers": 0,
              "processing": true
            },
            "mechanicsInfo": {
              "type": "DIRECT_DISCOUNT",
              "promocodeInfo": {}
            },
            "bestsellerInfo": {
              "bestseller": true,
              "entryDeadline": "2025-01-01T00:00:00Z",
              "renewalEnabled": true
            },
            "channels": [
              "PUSH"
            ],
            "constraints": {
              "warehouseIds": [
                null
              ]
            }
          }
        ]
      }
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  请求包含不正确的数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#400)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__401">
  
  ## 401 Unauthorized
  
  请求中未指定授权数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#401)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__403">
  
  ## 403 Forbidden
  
  授权数据不正确或禁止访问资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#403)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__404">
  
  ## 404 Not Found
  
  找不到请求的资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#404)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__420">
  
  ## 420 Method Failure
  
  已超出资源访问限制。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#420)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__500">
  
  ## 500 Internal Server Error
  
  Yandex中的内部错误。 市场。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#500)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  pathParams:
    - description: "内阁ID。\n\n\n:::no-translate\n{% if audience == \"partner\" %}\n:::\n\n\n要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n\n\n:::no-translate\n{% endif %}\n:::\n\n"
      name: businessId
      in: path
      required: true
      schema:
        type: integer
        format: int64
        minimum: 1
  searchParams: []
  headers: []
  body: |-
    {
      "participation": "PARTICIPATING_NOW",
      "mechanics": "DIRECT_DISCOUNT"
    }
  schema:
    description: 用于获取股票列表的过滤器。
    type: object
    properties:
      participation:
        description: >
          在不指定过滤器的情况下，将返回卖家参与或可能参与的促销活动。
  
  
          指定过滤器时将返回哪些共享:
  
  
          * `PARTICIPATING_NOW` — 卖方参与的当前促销活动。
  
  
          * `PARTICIPATED` — 完成了卖家在过去一年中参与的促销活动。
          如果一年内少于15股，则响应将始终显示最后15股。
        type: string
        enum:
          - PARTICIPATING_NOW
          - PARTICIPATED
      mechanics:
        description: |
          推广类别:
  
          * `DIRECT_DISCOUNT` — 直接折扣。
  
          * `BLUE_FLASH` — 一个闪光的促销。
  
          * `MARKET_PROMOCODE` — 通过促销代码折扣.
        type: string
        enum:
          - DIRECT_DISCOUNT
          - BLUE_FLASH
          - MARKET_PROMOCODE
  bodyType: application/json
  method: post
  security:
    - type: apiKey
      name: 'Api-Key'
      in: header
    - type: oauth2
      x-inline: true
      flows:
        implicit:
          authorizationUrl: https://oauth.yandex.ru/authorize
          scopes:
            market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
  path: v2/businesses/{businessId}/promos
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>
<!-- endsource: zh/api/promos/getPromos.md -->


[*Deprecated]: No longer supported, please use an alternative and newer version.