---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/getOfferMappings.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/business-offer-mappings/getOfferMappings.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/business-offer-mappings/getOfferMappings.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

<!-- source: en/api/business-offer-mappings/getOfferMappings.md -->
<div class="openapi">

# Information about the products in the catalog

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

{% list tabs %}

- Info

  
  <!-- source: en/_auto/method_scopes/getOfferMappings.md -->
  **The method is available for [all models](https://yandex.com/dev/market/partner-api/doc/en/overview/business.md).**

  {% cut "**If you are using an API Key token, one of the accesses in the list is required to call the method**" %}

  * offers-and-cards-management — [Manage products and cards](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/offers-and-cards-management.md)
  * offers-and-cards-management:read-only — [View products and cards](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/offers-and-cards-management_read-only.md)
  * all-methods — Full account management
  * all-methods:read-only — View all data

  {% endcut %}
  <!-- endsource: en/_auto/method_scopes/getOfferMappings.md -->
  
  
  Returns a list of products in the catalog, their categories on the Market, and the characteristics of each product.
  
  It can be used in three ways:
  * set a list of people of interest SKU;
  * set a filter — in this case, the results are returned page by page;
  * do not send the request body to get a list of all the products in the catalog.
  
  To get the categorical characteristics of the products, use the method [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getOfferCardsContentStatus.md).
  
  
  <!-- source: en/_auto/method_limits/getOfferMappings.md -->
  |<div style="text-align: left;">**⚙️ Limit without subscription:** 100 requests per minute<br>**⭐️ [Limit with Medium subscription](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 600 requests per minute</div>|
  |-|
  <!-- endsource: en/_auto/method_limits/getOfferMappings.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}/offer-mappings
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Path parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  Cabinet ID.
  
  
  
  
  To find out, use the request [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/reference/campaigns/getCampaigns.md).
  
  ℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)
  
  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  ### Query parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _language_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  The language in which the values in the parameters are accepted and returned `name` and `description`.
  
  Default value: `RU`.
  
  Language:
  
  * `RU` — Russian.
  * `UZ` — uzbek.
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `RU`, `UZ`
  {.table-cell}
  ||
  ||
  
  _limit_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer
  
  The number of values per page. <br><br> If the parameter value exceeds the maximum allowed value, it will be reduced to the maximum.
  
  
  _Default:_{.json-schema-reset .json-schema-value} `50`
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Max value:_{.json-schema-reset .json-schema-assertion} `100`
  {.table-cell}
  ||
  ||
  
  _pageToken_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  ID of the results page.
  
  If the parameter is omitted, the first page is returned.
  
  Pass the value of the output parameter `nextPageToken`, received during the last request.
  
  
  _Example:_{.json-schema-reset .json-schema-example} ``
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "offerIds": [
      "example"
    ],
    "cardStatuses": [
      "HAS_CARD_CAN_NOT_UPDATE"
    ],
    "categoryIds": [
      0
    ],
    "vendorNames": [
      "example"
    ],
    "tags": [
      "example"
    ],
    "archived": true
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _archived_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: boolean
  
  Filter by location in the archive.
  
  Pass it on `true` to receive the items in the archive. If the filter is not filled or passed `false`, the response returns items that are not in the archive.
  
  {.table-cell}
  ||
  ||
  
  _cardStatuses_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  Filter by card status.
  
  [What is a product card?](https://yandex.ru/support/marketplace/assortment/content/index.html)
  
  
  _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
  [
    "HAS_CARD_CAN_NOT_UPDATE"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _categoryIds_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer[] &#124; null
  
  Filter by category on the Market.
  
  _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}
  ||
  ||
  
  _offerIds_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  The IDs of the products that information is needed about.
  
  
  {% note warning "Такой список возвращается только целиком" %}
  
  
  If you are requesting information on specific SKU, do not fill in:
  * `pageToken`;
  * `limit`;
  * `cardStatuses`;
  * `categoryIds`;
  * `vendorNames`;
  * `tags`;
  * `archived`.
  
  
  {% endnote %}
  
  
   
  
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Max items:_{.json-schema-reset .json-schema-assertion} `100`
  
  _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    "example"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _tags_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  Filter by tags.
  
  _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
  [
    "example"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _vendorNames_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  Filter by brand.
  
  _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
  [
    "example"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  Information about the products in the catalog.
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "result": {
      "paging": {
        "nextPageToken": "example"
      },
      "offerMappings": [
        {
          "offer": {},
          "mapping": {},
          "showcaseUrls": [
            null
          ]
        }
      ]
    }
  }
  ```
  
  {% 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
  
    The type of response.
    Possible values:
    * `OK` — There are no errors.
    * `ERROR` — an error occurred while processing the request.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The standard wrapper for server responses.
  
    {% 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" %}
  
    #|
    ||
  
    _offerMappings_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _mapping_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _marketSku_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: integer
  
      The ID of the product card on the Market.
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `1`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      A card on the Market that, from your point of view, fits the product. To determine the ID of the appropriate card, use the search in the cabinet (**Products** → **Catalog** → **Upload products**).
  
      Based on the verification results, the Market can link the product to a more suitable card.
  
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "marketSku": 1
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _marketCategoryId_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: integer
  
      ID of the category on the Market that the product belongs to.
  
      It may be missing from the response if the Market has not yet determined the product category.
  
      {.table-cell}
      ||
      ||
  
      _marketCategoryName_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the card's category on the Market.
  
      It may be missing from the response if the Market has not yet determined the product category.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _marketModelName_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
      {.table-cell}|
      **Type**: string
  
      The name of the model on the Market.
  
      It may not be included in the response if the product is not linked to the card yet.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _marketSkuName_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the product card.
  
      It may not be included in the response if the product is not linked to the card yet.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "marketSkuName": "example",
        "marketModelName": "example",
        "marketCategoryId": 0,
        "marketCategoryName": "example"
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    Information about the products in the catalog.
  
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "marketSku": 1,
      "marketSkuName": "example",
      "marketModelName": "example",
      "marketCategoryId": 0,
      "marketCategoryName": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _offer_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _offerId_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Your SKU — the product ID in your system.
  
      Usage rules SKU:
  
      * For each product SKU there must be one.
  
      * Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
  
      SKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).
  
  
      {% note warning %}
  
  
      Spaces at the beginning and end of the value are automatically deleted. For example, `"  SKU123  "` and `"SKU123"` they will be treated as identical values.
  
  
      {% endnote %}
  
  
      [What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)
  
  
      _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `255`
  
      _Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _adult_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: boolean
  
      The parameter includes the label 18+ for the product. Set it only for products that are related to satisfying sexual needs.
  
      {.table-cell}
      ||
      ||
  
      _age_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _ageUnit_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Age measurement units:
  
      * `YEAR` — year.
      * `MONTH` — month.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `YEAR`, `MONTH`
      {.table-cell}
      ||
      ||
  
      _value_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      Meaning.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Age in the specified units of measurement.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "value": 0,
        "ageUnit": "YEAR"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _barcodes_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      Barcode.
  
      Specify it as a sequence of numbers. The codes will do EAN-13, EAN-8, UPC-A, UPC-E or Code 128. For books — ISBN.
  
      For products [certain categories and brands](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx) The barcode must be a valid code. GTIN. Please note: internal barcodes starting with 2 or 02, and format codes Code 128 They are not GTIN.
  
      [What is it GTIN](*gtin)
  
  
      _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
      [
        "46012300000000"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _boxCount_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: integer
  
      The number of cargo spaces.
  
      This parameter is used if the product consists of several boxes, packages, and so on. For example, the air conditioner takes up two seats — the external and internal units are in two boxes.
  
      For products that occupy one place, do not pass this parameter.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `1`
      {.table-cell}
      ||
      ||
  
      _category_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
      {.table-cell}|
      **Type**: string
  
  
      {% note warning "Вместо него используйте `marketCategoryId`." %}
  
  
       
  
  
      {% endnote %}
  
  
      The product category in your store.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _certificates_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      The numbers of the documents for the product: certificate, declaration of conformity, etc.
  
      You can only transfer the numbers of the documents, the scans of which are uploaded in the merchant's office by [Instructions](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html).
  
  
      _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
      [
        "example"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _commodityCodes_{.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
  
      Product code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _type_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Type of product code:
  
      * `CUSTOMS_COMMODITY_CODE` — the product code in the unified Commodity Nomenclature of Foreign Economic Activity (HS) — 10 or 14 digits without spaces.
      * `IKPU_CODE` — The identification code of products and services in Uzbekistan is 17 digits without spaces.
  
      Do not send multiple codes of the same type.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `CUSTOMS_COMMODITY_CODE`, `IKPU_CODE`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Product codes.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "type": "CUSTOMS_COMMODITY_CODE"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _condition_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _quality_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Product appearance:
  
      * `PERFECT` — ideal.
      * `EXCELLENT` — excellent.
      * `GOOD` — good.
      * `NOT_SPECIFIED` — not selected.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `PERFECT`, `EXCELLENT`, `GOOD`, `NOT_SPECIFIED`
      {.table-cell}
      ||
      ||
  
      _reason_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Product description. Describe the defects in detail, how noticeable they are and where to look for them.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _type_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Markdown type:
  
      * `PREOWNED` —  used goods that used to belong to another person.
      * `SHOWCASESAMPLE` — showcase sample.
      * `REFURBISHED` — re-sale of the product.
      * `REDUCTION` — the product is defective.
      * `RENOVATED` — the restored product.
      * `NOT_SPECIFIED` — not selected.
  
      `REFURBISHED` — special value for clothes, shoes and accessories. It is used only for discounted products from this category. Other values for clothing, shoes, and accessories are not used.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `PREOWNED`, `SHOWCASESAMPLE`, `REFURBISHED`, `REDUCTION`, `RENOVATED`, `NOT_SPECIFIED`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      The condition of the discounted product.
  
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "type": "PREOWNED",
        "quality": "PERFECT",
        "reason": "example"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _customsCommodityCode_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
      {.table-cell}|
      **Type**: string
  
  
      {% note warning "Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`." %}
  
  
       
  
  
      {% endnote %}
  
  
      The product code in the unified Commodity Nomenclature of Foreign Economic Activity (HS) — 10 or 14 digits without spaces.
  
      Be sure to indicate if there is one.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `8517610008`
      {.table-cell}
      ||
      ||
  
      _description_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Detailed product description: for example, its advantages and features.
  
      Do not provide installation and assembly instructions in the description. Do not use the words "discount", "sale", "cheap", "gift" (except gift categories), "free", "special offer", "special price", "novelty", "new", "analog", "order", "hit". Do not provide any contact information or links.
  
      You can use HTML tags to format the text:
  
      * \<h>, \<h1>, \<h2> and so on — for headlines;
      * \<br> and \<p> — for line breaks;
      * \<ol> — for a numbered list;
      * \<ul> — for a bulleted list.
      * \<li> — to create list items (must be inside \<ol> or \<ul>);
      * \<div> — It is supported, but it does not affect the text display.
  
      Optimal length — 400-600 characters.
  
      [Recommendations and rules](https://yandex.ru/support/marketplace/assortment/fields/description.html)
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _downloadable_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: boolean
  
      A sign of a digital product. Specify `true` if the product is delivered by e-mail.
  
      [How to work with digital goods](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/digital.md)
  
      {.table-cell}
      ||
      ||
  
      _guaranteePeriod_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: integer
  
      Duration in the specified units.
      {.table-cell}
      ||
      ||
  
      _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Time measurement unit:
  
      * `HOUR` — hour.
      * `DAY` — day.
      * `WEEK` — a week.
      * `MONTH` — month.
      * `YEAR` — year.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
      {.table-cell}
      ||
      ||
  
      _comment_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Comment.
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _lifeTime_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: integer
  
      Duration in the specified units.
      {.table-cell}
      ||
      ||
  
      _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Time measurement unit:
  
      * `HOUR` — hour.
      * `DAY` — day.
      * `WEEK` — a week.
      * `MONTH` — month.
      * `YEAR` — year.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
      {.table-cell}
      ||
      ||
  
      _comment_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Comment.
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _manuals_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _url_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `2000`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _title_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the instruction that will be displayed on the product card.
  
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of instructions for using the product.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "url": "example",
          "title": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _manufacturerCountries_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      The country where the product was produced.
  
      Write down the names of the countries as they are written in [the list](https://yastatic.net/s3/doc-binary/src/support/market/ru/countries.xlsx).
  
  
      _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
      [
        "Россия"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _marketCategoryId_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: integer
  
      The ID of the category on the Market to which you attribute your product.
  
  
      {% note warning "Всегда указывайте, когда передаете `parameterValues`" %}
  
  
      If, when changing the characteristics, you pass `parameterValues` and do not specify `marketCategoryId`, the characteristics will be updated, but you will receive a warning in the response (parameter `warnings`).
  
      If you do not pass both of them, information from outdated parameters will be used. `params` and `category`, and `marketCategoryId` it will be detected automatically.
  
  
      {% endnote %}
  
  
      When changing the category, make sure that the product characteristics and their values in the parameter `parameterValues` you are submitting for a new category.
  
      You can get a list of Market categories using a request.  [POST v2/categories/tree](https://yandex.com/dev/market/partner-api/doc/en/reference/categories/getCategoriesTree.md).
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
      _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
      {.table-cell}
      ||
      ||
  
      _name_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Make up the name according to the scheme: type + brand or manufacturer + model + features, if any (for example, color, size or weight) and quantity in the package.
  
      Do not include emotional characteristics ("hit", "super", etc.) in the name of the terms of sale (for example, "discount", "free shipping", etc.). Don't write words in capital letters — except for well-established brand names and models.
  
      Optimal length — 50-60 characters.
  
      [Recommendations and rules](https://yandex.ru/support/marketplace/assortment/fields/title.html)
  
  
      _Example:_{.json-schema-reset .json-schema-example} `Ударная дрель Makita HP1630, 710 Вт`
      {.table-cell}
      ||
      ||
  
      _params_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _name_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The name of the characteristic.
  
      It must match the name of the feature on the Market. You can find it from the category's Excel template or through a query. [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getCategoryContentParameters.md).
  
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `200`
  
      _Example:_{.json-schema-reset .json-schema-example} `Wi-Fi`
      {.table-cell}
      ||
      ||
  
      _value_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Meaning.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `есть`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
  
      {% note warning "При передаче характеристик используйте `parameterValues`." %}
  
  
       
  
  
      {% endnote %}
  
  
      Characteristics that only products of a specific category have. — for example, the diameter of the bicycle wheels or the material of the shoe sole.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "name": "Wi-Fi",
          "value": "есть"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _pictures_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      Links to product images. The image on the first link is considered the main one, the others are additional.
  
      **Link Requirements**
  
      * There can be up to 30 links.
      * Specify the entire link, including the http or https protocol.
      * Maximum length — 512 characters.
      * Russian letters in URL may.
      * You can use direct links to images and to Yandex.Disk. Links on Yandex.Disk must be copied using the function **Share**. Relative links and links to other cloud storage — They don't work.
  
      ✅ `https://example-shop.ru/images/sku12345.jpg`
  
      ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
      ❌ `/images/sku12345.jpg`
  
      ❌ `https://www.dropbox.com/s/818f/tovar.jpg`
  
      Links to the image must be permanent. You cannot use dynamic links that change from upload to upload.
  
      If you need to replace the image, upload the new image via a new link, and delete the link to the old one. If you simply replace the image using the old link, it will not update.
  
      [Image Requirements](https://yandex.ru/support/marketplace/assortment/fields/images.html)
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        "example"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _shelfLife_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: integer
  
      Duration in the specified units.
      {.table-cell}
      ||
      ||
  
      _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Time measurement unit:
  
      * `HOUR` — hour.
      * `DAY` — day.
      * `WEEK` — a week.
      * `MONTH` — month.
      * `YEAR` — year.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
      {.table-cell}
      ||
      ||
  
      _comment_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Comment.
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _tags_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      Product labels that the store uses. The tags are not visible to customers. You can group and filter different products in the catalog by tags. — for example, products of the same series, collection, or line.
  
      Maximum tag length — 20 characters. One product can have a maximum of 10 tags.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max items:_{.json-schema-reset .json-schema-assertion} `50`
  
      _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        "до 500 рублей"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _type_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Special type of product:
  
      * `DEFAULT` — products for which you previously provided a special type and want to remove it.
      * `MEDICINE` — medicines.
      * `BOOK` — paper and electronic books.
      * `AUDIOBOOK` — Audiobooks.
      * `ARTIST_TITLE` — music and video production.
      * `ON_DEMAND` — custom-made products.
      * `ALCOHOL` — alcohol.
  
  
      {% note info "Если ваш товар — книга" %}
  
  
      Specify the year of publication in the product specifications. [More information about the parameter](https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/updateOfferMappings.md#offerparamdto)
  
  
      {% endnote %}
  
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `DEFAULT`, `MEDICINE`, `BOOK`, `AUDIOBOOK`, `ARTIST_TITLE`, `ON_DEMAND`, `ALCOHOL`
      {.table-cell}
      ||
      ||
  
      _vendor_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the brand or manufacturer. It should be written the way the brand itself writes it.
  
      _Example:_{.json-schema-reset .json-schema-example} `LEVENHUK`
      {.table-cell}
      ||
      ||
  
      _vendorCode_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The article of the product from the manufacturer.
  
      _Example:_{.json-schema-reset .json-schema-example} `VNDR-0005A`
      {.table-cell}
      ||
      ||
  
      _videos_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string[] &#124; null
  
      Links (URL) on the product video.
  
      **Link Requirements**
  
      * Specify the entire link, including the http or https protocol.
      * Maximum length — 512 characters.
      * Russian letters in URL may.
      * You can use direct links to videos and to Yandex.Disk. Links on Yandex.Disk must be copied using the function **Share**. Relative links and links to other cloud storage — They don't work.
  
      ✅ `https://example-shop.ru/video/sku12345.avi`
  
      ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
      ❌ `/video/sku12345.avi`
  
      ❌ `https://www.dropbox.com/s/818f/super-tovar.avi`
  
      Links to videos must be permanent. You cannot use dynamic links that change from upload to upload.
  
      If you need to replace the video, upload the new video via a new link, and delete the link to the old one. If you simply replace the video using the old link, it will not update.
  
      [Video Requirements](https://yandex.ru/support/marketplace/assortment/fields/video.html)
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        "example"
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _weightDimensions_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _height_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      Package height in cm.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
      {.table-cell}
      ||
      ||
  
      _length_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      Package length in cm.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
      {.table-cell}
      ||
      ||
  
      _weight_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      The weight of the product in kg, including packaging (gross).
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
      {.table-cell}
      ||
      ||
  
      _width_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      Package width in cm.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      The dimensions of the package and the weight of the product.
  
      If the product takes up several boxes, fold them compactly before measuring the dimensions.
  
      ![Multi-seat cargo measurement scheme](../../_images/reference/boxes-measure.png)
  
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "length": 65.55,
        "width": 50.7,
        "height": 20,
        "weight": 1.001
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The main parameters of the product.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "offerId": "example",
        "name": "Ударная дрель Makita HP1630, 710 Вт",
        "marketCategoryId": 0,
        "category": "example",
        "pictures": [
          "example"
        ],
        "videos": [
          "example"
        ],
        "manuals": [
          {
            "url": "example",
            "title": "example"
          }
        ],
        "vendor": "LEVENHUK",
        "barcodes": [
          "46012300000000"
        ],
        "description": "example",
        "manufacturerCountries": [
          "Россия"
        ],
        "weightDimensions": {
          "length": 65.55,
          "width": 50.7,
          "height": 20,
          "weight": 1.001
        },
        "vendorCode": "VNDR-0005A",
        "tags": [
          "до 500 рублей"
        ],
        "shelfLife": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "lifeTime": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "guaranteePeriod": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "customsCommodityCode": "8517610008",
        "commodityCodes": [
          {
            "code": "example",
            "type": "CUSTOMS_COMMODITY_CODE"
          }
        ],
        "certificates": [
          "example"
        ],
        "boxCount": 1,
        "condition": {
          "type": "PREOWNED",
          "quality": "PERFECT",
          "reason": "example"
        },
        "type": "DEFAULT",
        "downloadable": true,
        "adult": true,
        "age": {
          "value": 0,
          "ageUnit": "YEAR"
        },
        "params": [
          {
            "name": "Wi-Fi",
            "value": "есть"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _additionalExpenses_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: object
  
      {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
      - **Type**: object
  
        #|
        ||
  
        _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: string
  
        Currency codes:
  
        * `RUR` — the Russian ruble.
        * `UAH` — the Ukrainian hryvnia.
        * `BYR` — the Belarusian ruble.
        * `KZT` — Kazakhstani tenge.
        * `UZS` — Uzbek sum.
  
  
        _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
        {.table-cell}
        ||
        ||
  
        _value_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: number
  
        The price of the product.
  
        _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
        _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
        {.table-cell}
        ||
        |#{.json-schema-properties}
  
        The price of the product.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "value": 0,
          "currencyId": "RUR"
        }
        ```
  
        {% endcut %}
  
      - **Type**: object
  
        #|
        ||
  
        _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: string&lt;date-time&gt;
  
        The time of the last update.
  
        _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
        {.table-cell}
        ||
        |#{.json-schema-properties}
  
        The time of the last update.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "updatedAt": "2025-01-01T00:00:00Z"
        }
        ```
  
        {% endcut %}
  
      {% endcut %}
  
      Price indicating the time of the last update.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "value": 0,
        "currencyId": "RUR",
        "updatedAt": "2025-01-01T00:00:00Z"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _archived_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: boolean
  
      The product has been archived.
  
      {.table-cell}
      ||
      ||
  
      _basicPrice_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: object
  
      {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
      - **Type**: object
  
        {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
        - **Type**: object
  
          #|
          ||
  
          _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
          {.table-cell}|
          **Type**: string
  
          Currency codes:
  
          * `RUR` — the Russian ruble.
          * `UAH` — the Ukrainian hryvnia.
          * `BYR` — the Belarusian ruble.
          * `KZT` — Kazakhstani tenge.
          * `UZS` — Uzbek sum.
  
  
          _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
          {.table-cell}
          ||
          ||
  
          _value_{.json-schema-reset .json-schema-property .json-schema-required}
          {.table-cell}|
          **Type**: number
  
          The price of the product.
  
          _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
          _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
          {.table-cell}
          ||
          |#{.json-schema-properties}
  
          The price of the product.
  
          {% cut "**Example**" %}{.json-schema-example}
  
          ```json translate=no
          {
            "value": 0,
            "currencyId": "RUR"
          }
          ```
  
          {% endcut %}
  
        - **Type**: object
  
          #|
          ||
  
          _discountBase_{.json-schema-reset .json-schema-property}
          {.table-cell}|
          **Type**: number
  
          The crossed-out price.
  
          The number must be an integer. You can specify a price with a discount from 5 to 99%.
  
          Pass this parameter every time the price is updated if you provide a discount on the product.
  
  
          _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
          _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
          {.table-cell}
          ||
          |#{.json-schema-properties}
  
          {% cut "**Example**" %}{.json-schema-example}
  
          ```json translate=no
          {
            "discountBase": 0
          }
          ```
  
          {% endcut %}
  
        {% endcut %}
  
        Price with discount indication.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "value": 0,
          "currencyId": "RUR",
          "discountBase": 0
        }
        ```
  
        {% endcut %}
  
      - **Type**: object
  
        #|
        ||
  
        _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: string&lt;date-time&gt;
  
        The time of the last update.
  
        _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
        {.table-cell}
        ||
        |#{.json-schema-properties}
  
        The time of the last update.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "updatedAt": "2025-01-01T00:00:00Z"
        }
        ```
  
        {% endcut %}
  
      {% endcut %}
  
      The price includes the currency, discount, and the time of the last update.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "value": 0,
        "currencyId": "RUR",
        "discountBase": 0,
        "updatedAt": "2025-01-01T00:00:00Z"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _campaigns_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _campaignId_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: integer
  
      The ID of the campaign (store) — The technical identifier that represents your store in the Yandex Market system when working through the API. It is uniquely linked to your store, but it is intended only for automated interaction.
  
      You can find it using a query [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/reference/campaigns/getCampaigns.md) or find it in the seller's office on the Market. Click on your account icon → **Settings** and in the menu on the left, select **APIs and modules**:
  
      * block **Campaign ID**;
      * tab **Query log** → drop-down list in the block **Show logs**.
  
      ⚠️ Do not confuse it with:
      - the store's identifier, which is displayed in the merchant's personal account.
      - advertising campaigns.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `1`
      {.table-cell}
      ||
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Product status:
  
      * `PUBLISHED` — Ready for sale.
      * `CHECKING` — Under review.
      * `DISABLED_BY_PARTNER` — Hidden by you.
      * `REJECTED_BY_MARKET` — Rejected.
      * `DISABLED_AUTOMATICALLY` — Fix the errors.
      * `CREATING_CARD` — A card is being created.
      * `NO_CARD` — I need a card.
      * `NO_STOCKS` — Not in stock.
      * `ARCHIVED` — In the archive.
      * `READY_FOR_PUBLICATION` — The store is in the process of activation.
  
      [What does each of the statuses mean?](https://yandex.ru/support/marketplace/assortment/add/statuses.html)
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `PUBLISHED`, `CHECKING`, `DISABLED_BY_PARTNER`, `DISABLED_AUTOMATICALLY`, `REJECTED_BY_MARKET`, `CREATING_CARD`, `NO_CARD`, `NO_STOCKS`, `ARCHIVED`, `READY_FOR_PUBLICATION`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      The list of stores where the product is placed.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "campaignId": 1,
          "status": "PUBLISHED"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _cardStatus_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Product card status:
  
      * `HAS_CARD_CAN_NOT_UPDATE` — The Market card.
      * `HAS_CARD_CAN_UPDATE` — You can add it.
      * `HAS_CARD_CAN_UPDATE_ERRORS` — The changes have not been accepted.
      * `HAS_CARD_CAN_UPDATE_PROCESSING` — Changes are under review.
      * `NO_CARD_NEED_CONTENT` — Create a card.
      * `NO_CARD_MARKET_WILL_CREATE` — Creates a Marketplace.
      * `NO_CARD_ERRORS` — It was not created due to an error.
      * `NO_CARD_PROCESSING` — We check the data.
      * `NO_CARD_ADD_TO_CAMPAIGN` — Place the product in the store.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `HAS_CARD_CAN_NOT_UPDATE`, `HAS_CARD_CAN_UPDATE`, `HAS_CARD_CAN_UPDATE_ERRORS`, `HAS_CARD_CAN_UPDATE_PROCESSING`, `NO_CARD_NEED_CONTENT`, `NO_CARD_MARKET_WILL_CREATE`, `NO_CARD_ERRORS`, `NO_CARD_PROCESSING`, `NO_CARD_ADD_TO_CAMPAIGN`
      {.table-cell}
      ||
      ||
  
      _groupId_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The identifier of the product group.
  
      Products that are grouped together will have the same identifier.
  
      [How to combine products on a card](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/assortment-add-goods.md#combine-variants)
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _mediaFiles_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object" %}
  
      #|
      ||
  
      _firstVideoAsCover_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
      {.table-cell}|
      **Type**: boolean
  
      Use the first video in the card as a video background.
  
      Pass it on `true` for the first video to be used as a video background, or `false` so that the video background is not displayed in the product profile.
  
      {.table-cell}
      ||
      ||
  
      _manuals_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _title_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the media file.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _uploadState_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Media file download status:
  
      * `UPLOADING` — It's loading.
      * `UPLOADED` — uploaded successfully.
      * `FAILED` — an error occurred during the download. Please try again later.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED`
      {.table-cell}
      ||
      ||
  
      _url_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `2000`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Product usage guidelines.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "url": "example",
          "title": "example",
          "uploadState": "UPLOADING"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _pictures_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _title_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the media file.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _uploadState_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Media file download status:
  
      * `UPLOADING` — It's loading.
      * `UPLOADED` — uploaded successfully.
      * `FAILED` — an error occurred during the download. Please try again later.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED`
      {.table-cell}
      ||
      ||
  
      _url_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `2000`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Product images.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "url": "example",
          "title": "example",
          "uploadState": "UPLOADING"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _videos_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _title_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      The name of the media file.
  
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _uploadState_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Media file download status:
  
      * `UPLOADING` — It's loading.
      * `UPLOADED` — uploaded successfully.
      * `FAILED` — an error occurred during the download. Please try again later.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED`
      {.table-cell}
      ||
      ||
  
      _url_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
      _Max length:_{.json-schema-reset .json-schema-assertion} `2000`
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Video files of the product.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "url": "example",
          "title": "example",
          "uploadState": "UPLOADING"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Information about the product's media files.
  
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "firstVideoAsCover": true,
        "videos": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ],
        "pictures": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ],
        "manuals": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ]
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _purchasePrice_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: object
  
      {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
      - **Type**: object
  
        #|
        ||
  
        _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: string
  
        Currency codes:
  
        * `RUR` — the Russian ruble.
        * `UAH` — the Ukrainian hryvnia.
        * `BYR` — the Belarusian ruble.
        * `KZT` — Kazakhstani tenge.
        * `UZS` — Uzbek sum.
  
  
        _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
        {.table-cell}
        ||
        ||
  
        _value_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: number
  
        The price of the product.
  
        _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
        _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
        {.table-cell}
        ||
        |#{.json-schema-properties}
  
        The price of the product.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "value": 0,
          "currencyId": "RUR"
        }
        ```
  
        {% endcut %}
  
      - **Type**: object
  
        #|
        ||
  
        _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required}
        {.table-cell}|
        **Type**: string&lt;date-time&gt;
  
        The time of the last update.
  
        _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
        {.table-cell}
        ||
        |#{.json-schema-properties}
  
        The time of the last update.
  
        {% cut "**Example**" %}{.json-schema-example}
  
        ```json translate=no
        {
          "updatedAt": "2025-01-01T00:00:00Z"
        }
        ```
  
        {% endcut %}
  
      {% endcut %}
  
      Price indicating the time of the last update.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "value": 0,
        "currencyId": "RUR",
        "updatedAt": "2025-01-01T00:00:00Z"
      }
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      ||
  
      _sellingPrograms_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _sellingProgram_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Working model:
  
      * `FBY` — FBY.
      * `FBS` — FBS.
      * `DBS` — DBS.
      * `EXPRESS` — Express.
      * `LAAS` — LaaS.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `FBY`, `FBS`, `DBS`, `EXPRESS`, `LAAS`
      {.table-cell}
      ||
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Information about availability or unavailability.
  
      * `FINE` — available.
      * `REJECT` — unavailable.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `FINE`, `REJECT`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      Information about which placement models are available for the product.
  
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "sellingProgram": "FBY",
          "status": "FINE"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "basicPrice": {
          "value": 0,
          "currencyId": "RUR",
          "discountBase": 0,
          "updatedAt": "2025-01-01T00:00:00Z"
        },
        "purchasePrice": {
          "value": 0,
          "currencyId": "RUR",
          "updatedAt": "2025-01-01T00:00:00Z"
        },
        "additionalExpenses": {
          "value": 0,
          "currencyId": "RUR",
          "updatedAt": "2025-01-01T00:00:00Z"
        },
        "cardStatus": "HAS_CARD_CAN_NOT_UPDATE",
        "campaigns": [
          {
            "campaignId": 1,
            "status": "PUBLISHED"
          }
        ],
        "sellingPrograms": [
          {
            "sellingProgram": "FBY",
            "status": "FINE"
          }
        ],
        "mediaFiles": {
          "firstVideoAsCover": true,
          "videos": [
            {
              "url": "example",
              "title": "example",
              "uploadState": "UPLOADING"
            }
          ],
          "pictures": [
            {
              "url": "example",
              "title": "example",
              "uploadState": "UPLOADING"
            }
          ],
          "manuals": [
            {
              "url": "example",
              "title": "example",
              "uploadState": "UPLOADING"
            }
          ]
        },
        "archived": true,
        "groupId": "example"
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    Product parameters.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "offerId": "example",
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "marketCategoryId": 0,
      "category": "example",
      "pictures": [
        "example"
      ],
      "videos": [
        "example"
      ],
      "manuals": [
        {
          "url": "example",
          "title": "example"
        }
      ],
      "vendor": "LEVENHUK",
      "barcodes": [
        "46012300000000"
      ],
      "description": "example",
      "manufacturerCountries": [
        "Россия"
      ],
      "weightDimensions": {
        "length": 65.55,
        "width": 50.7,
        "height": 20,
        "weight": 1.001
      },
      "vendorCode": "VNDR-0005A",
      "tags": [
        "до 500 рублей"
      ],
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "guaranteePeriod": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "customsCommodityCode": "8517610008",
      "commodityCodes": [
        {
          "code": "example",
          "type": "CUSTOMS_COMMODITY_CODE"
        }
      ],
      "certificates": [
        "example"
      ],
      "boxCount": 1,
      "condition": {
        "type": "PREOWNED",
        "quality": "PERFECT",
        "reason": "example"
      },
      "type": "DEFAULT",
      "downloadable": true,
      "adult": true,
      "age": {
        "value": 0,
        "ageUnit": "YEAR"
      },
      "params": [
        {
          "name": "Wi-Fi",
          "value": "есть"
        }
      ],
      "basicPrice": {
        "value": 0,
        "currencyId": "RUR",
        "discountBase": 0,
        "updatedAt": "2025-01-01T00:00:00Z"
      },
      "purchasePrice": {
        "value": 0,
        "currencyId": "RUR",
        "updatedAt": "2025-01-01T00:00:00Z"
      },
      "additionalExpenses": {
        "value": 0,
        "currencyId": "RUR",
        "updatedAt": "2025-01-01T00:00:00Z"
      },
      "cardStatus": "HAS_CARD_CAN_NOT_UPDATE",
      "campaigns": [
        {
          "campaignId": 1,
          "status": "PUBLISHED"
        }
      ],
      "sellingPrograms": [
        {
          "sellingProgram": "FBY",
          "status": "FINE"
        }
      ],
      "mediaFiles": {
        "firstVideoAsCover": true,
        "videos": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ],
        "pictures": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ],
        "manuals": [
          {
            "url": "example",
            "title": "example",
            "uploadState": "UPLOADING"
          }
        ]
      },
      "archived": true,
      "groupId": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _showcaseUrls_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _showcaseType_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Showcase Type:
  
    * `B2B` — [Yandex Market for Business](https://business.market.yandex.ru/) (products for legal entities and sole proprietors). Read more about the service in [Help](https://yandex.ru/support/market-for-enterprise/ru/).
    * `B2C` — [the main showcase of the Market](https://market.yandex.ru/) (goods for individuals).
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `B2B`, `B2C`
    {.table-cell}
    ||
    ||
  
    _showcaseUrl_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Product link.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Links to the same product on different storefronts of the Market.
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "showcaseType": "B2B",
        "showcaseUrl": "example"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Information about the products.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "offer": {
          "offerId": "example",
          "name": "Ударная дрель Makita HP1630, 710 Вт",
          "marketCategoryId": 0,
          "category": "example",
          "pictures": [
            "example"
          ],
          "videos": [
            "example"
          ],
          "manuals": [
            {}
          ],
          "vendor": "LEVENHUK",
          "barcodes": [
            "46012300000000"
          ],
          "description": "example",
          "manufacturerCountries": [
            "Россия"
          ],
          "weightDimensions": {
            "length": 65.55,
            "width": 50.7,
            "height": 20,
            "weight": 1.001
          },
          "vendorCode": "VNDR-0005A",
          "tags": [
            "до 500 рублей"
          ],
          "shelfLife": {
            "timePeriod": 0,
            "timeUnit": "HOUR",
            "comment": "example"
          },
          "lifeTime": {
            "timePeriod": 0,
            "timeUnit": "HOUR",
            "comment": "example"
          },
          "guaranteePeriod": {
            "timePeriod": 0,
            "timeUnit": "HOUR",
            "comment": "example"
          },
          "customsCommodityCode": "8517610008",
          "commodityCodes": [
            {}
          ],
          "certificates": [
            "example"
          ],
          "boxCount": 1,
          "condition": {
            "type": "PREOWNED",
            "quality": "PERFECT",
            "reason": "example"
          },
          "type": "DEFAULT",
          "downloadable": true,
          "adult": true,
          "age": {
            "value": 0,
            "ageUnit": "YEAR"
          },
          "params": [
            {}
          ],
          "basicPrice": {},
          "purchasePrice": {},
          "additionalExpenses": {},
          "cardStatus": "HAS_CARD_CAN_NOT_UPDATE",
          "campaigns": [
            {}
          ],
          "sellingPrograms": [
            {}
          ],
          "mediaFiles": {
            "firstVideoAsCover": true,
            "videos": [
              null
            ],
            "pictures": [
              null
            ],
            "manuals": [
              null
            ]
          },
          "archived": true,
          "groupId": "example"
        },
        "mapping": {
          "marketSku": 1,
          "marketSkuName": "example",
          "marketModelName": "example",
          "marketCategoryId": 0,
          "marketCategoryName": "example"
        },
        "showcaseUrls": [
          {
            "showcaseType": "B2B",
            "showcaseUrl": "example"
          }
        ]
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _paging_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _nextPageToken_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    ID of the next results page.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The ID of the next page.
  
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "nextPageToken": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Information about the products.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "paging": {
        "nextPageToken": "example"
      },
      "offerMappings": [
        {
          "offer": {
            "offerId": "example",
            "name": "Ударная дрель Makita HP1630, 710 Вт",
            "marketCategoryId": 0,
            "category": "example",
            "pictures": [
              null
            ],
            "videos": [
              null
            ],
            "manuals": [
              null
            ],
            "vendor": "LEVENHUK",
            "barcodes": [
              null
            ],
            "description": "example",
            "manufacturerCountries": [
              null
            ],
            "weightDimensions": {},
            "vendorCode": "VNDR-0005A",
            "tags": [
              null
            ],
            "shelfLife": {},
            "lifeTime": {},
            "guaranteePeriod": {},
            "customsCommodityCode": "8517610008",
            "commodityCodes": [
              null
            ],
            "certificates": [
              null
            ],
            "boxCount": 1,
            "condition": {},
            "type": "DEFAULT",
            "downloadable": true,
            "adult": true,
            "age": {},
            "params": [
              null
            ],
            "basicPrice": {},
            "purchasePrice": {},
            "additionalExpenses": {},
            "cardStatus": "HAS_CARD_CAN_NOT_UPDATE",
            "campaigns": [
              null
            ],
            "sellingPrograms": [
              null
            ],
            "mediaFiles": {},
            "archived": true,
            "groupId": "example"
          },
          "mapping": {
            "marketSku": 1,
            "marketSkuName": "example",
            "marketModelName": "example",
            "marketCategoryId": 0,
            "marketCategoryName": "example"
          },
          "showcaseUrls": [
            {
              "showcaseType": "B2B",
              "showcaseUrl": "example"
            }
          ]
        }
      ]
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "result": {
        "paging": {
          "nextPageToken": "example"
        },
        "offerMappings": [
          {
            "offer": {},
            "mapping": {},
            "showcaseUrls": [
              {}
            ]
          }
        ]
      }
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  The request contains incorrect data. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The authorization data is not specified in the request. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The authorization data is incorrect or access to the resource is prohibited. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The requested resource was not found. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The resource access limit has been exceeded. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  Internal error of the Market. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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: "Cabinet ID.\n\n\n:::no-translate\n{% if audience == \"partner\" %}\n:::\n\n\nTo find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](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:
    - name: pageToken
      description: >
        ID of the results page.
  
  
        If the parameter is omitted, the first page is returned.
  
  
        Pass the value of the output parameter `nextPageToken`,
        received during the last request.
      in: query
      required: false
      x-transform: token
      x-aliases:
        - pageToken
        - page_token
      schema:
        type: string
    - name: limit
      description: |
        The number of values per page. <br><br> If the parameter value exceeds the maximum allowed value, it will be reduced to the maximum.
      in: query
      required: false
      x-transform: truncateLimit
      schema:
        type: integer
        format: int32
        minimum: 1
        default: 50
        maximum: 100
    - description: >
        The language in which the values in the parameters are accepted and
        returned `name` and `description`.
  
  
        Default value: `RU`.
      name: language
      in: query
      required: false
      schema:
        description: |
          Language:
  
          * `RU` — Russian.
          * `UZ` — uzbek.
        type: string
        enum:
          - RU
          - UZ
  headers: []
  body: |-
    {
      "offerIds": [
        "example"
      ],
      "cardStatuses": [
        "HAS_CARD_CAN_NOT_UPDATE"
      ],
      "categoryIds": [
        0
      ],
      "vendorNames": [
        "example"
      ],
      "tags": [
        "example"
      ],
      "archived": true
    }
  schema:
    type: object
    properties:
      offerIds:
        description: "The IDs of the products that information is needed about.\n\n\n:::no-translate\n{% note warning \"Такой список возвращается только целиком\" %}\n:::\n\n\nIf you are requesting information on specific SKU, do not fill in:\n* `pageToken`;\n* `limit`;\n* `cardStatuses`;\n* `categoryIds`;\n* `vendorNames`;\n* `tags`;\n* `archived`.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n\_\n"
        type: array
        nullable: true
        minItems: 1
        maxItems: 100
        uniqueItems: true
        items:
          description: "Your SKU —\_the product ID in your system.\n\nUsage rules SKU:\n\n* For each product SKU there must be one.\n\n* Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.\n\nSKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n\n:::no-translate\n{% note warning %}\n:::\n\n\nSpaces at the beginning and end of the value are automatically deleted. For example, `\"  SKU123  \"` and `\"SKU123\"` they will be treated as identical values.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n[What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
          type: string
          pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
          x-transform: trim
          minLength: 1
          maxLength: 255
      cardStatuses:
        description: >
          Filter by card status.
  
  
          [What is a product
          card?](https://yandex.ru/support/marketplace/assortment/content/index.html)
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          description: >
            Product card status:
  
  
            * `HAS_CARD_CAN_NOT_UPDATE` — The Market
            card.
  
            * `HAS_CARD_CAN_UPDATE` — You can add
            it.
  
            * `HAS_CARD_CAN_UPDATE_ERRORS` — The
            changes have not been accepted.
  
            * `HAS_CARD_CAN_UPDATE_PROCESSING` —
            Changes are under review.
  
            * `NO_CARD_NEED_CONTENT` — Create a
            card.
  
            * `NO_CARD_MARKET_WILL_CREATE` — Creates
            a Marketplace.
  
            * `NO_CARD_ERRORS` — It was not created
            due to an error.
  
            * `NO_CARD_PROCESSING` — We check the
            data.
  
            * `NO_CARD_ADD_TO_CAMPAIGN` — Place the
            product in the store.
          type: string
          enum:
            - HAS_CARD_CAN_NOT_UPDATE
            - HAS_CARD_CAN_UPDATE
            - HAS_CARD_CAN_UPDATE_ERRORS
            - HAS_CARD_CAN_UPDATE_PROCESSING
            - NO_CARD_NEED_CONTENT
            - NO_CARD_MARKET_WILL_CREATE
            - NO_CARD_ERRORS
            - NO_CARD_PROCESSING
            - NO_CARD_ADD_TO_CAMPAIGN
      categoryIds:
        description: Filter by category on the Market.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          type: integer
          format: int32
          minimum: 0
          exclusiveMinimum: true
      vendorNames:
        description: Filter by brand.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          type: string
      tags:
        description: Filter by tags.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          type: string
      archived:
        description: >
          Filter by location in the archive.
  
  
          Pass it on `true` to receive the items in the archive. If
          the filter is not filled or passed `false`, the response
          returns items that are not in the archive.
        type: boolean
  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}/offer-mappings
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>
<!-- endsource: en/api/business-offer-mappings/getOfferMappings.md -->

[*gtin]:
<b>What is GTIN?</b><br>GTIN — This is a unique number assigned to a product in a single international database. [GS1](https://ru.wikipedia.org/wiki/GS1). This number generates an EAN, UPC, or ISBN barcode.<br><br><b>How to make sure that the product is in the database</b><br>You can check the code on [verification page](https://gepir.gs1.org/index.php/search-by-gtin) on the GS1 association's website. If the product is not found, request the GTIN code from your supplier.<br><br><b>How to get a GTIN for your products</b><br>To receive GTIN codes, the manufacturer needs to join the GS1 association and register the products.

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