---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/eda-vendor/doc/en/ref/Menu/partner.availability.get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/eda-vendor/doc/en/llms.txt

<div class="openapi">

# Get currently unavailable menu items

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

Items with schematic or logical inconsistencies (too long string, stock equal to -10.00) may be ignored. The current version of the response model is application/vnd.eats.menu.availability.v2+json

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-get);margin-bottom: 12px">

<div class="openapi__request">

GET {.openapi__method}
```text translate=no
/menu/{restaurantId}/availability
```

</div>

</div>

</div>

### Path parameters

#|
|| **Name** | **Description** ||
||

_restaurantId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

The ID of the restaurant in the partner's system

_Example:_{.json-schema-reset .json-schema-example} ``
{.table-cell}
||
|#{.json-schema-properties}

## Responses

<div class="openapi__response__code__200">

## 200 OK

Returns a list of currently unavailable menu items in the restaurant menu

<div class="openapi-entity">

### Body

{% cut "application/vnd.eats.menu.availability.v2+json" %}

```json translate=no
{
  "items": [
    {
      "itemId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
      "stock": 5
    }
  ],
  "modifiers": [
    {
      "modifierId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
      "stock": 5
    }
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_items_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [MenuAvailabilityItems](#entity-MenuAvailabilityItems)[]

List of menu items for which availability needs to be changed

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "itemId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
    "stock": 5
  }
]
```

{% endcut %}
{.table-cell}
||
||

_modifiers_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [MenuAvailabilityModifiers](#entity-MenuAvailabilityModifiers)[]

List of dish modifiers for which availability needs to be change

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "modifierId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
    "stock": 5
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### MenuAvailabilityItems {#entity-MenuAvailabilityItems}

#|
|| **Name** | **Description** ||
||

_itemId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Internal identifier of the dish in the partner's restaurant system. Can be any value convertible to a string. Recommendation - UUID4

_Example:_{.json-schema-reset .json-schema-example} `eff0cec0-058c-4d53-b524-1c04ac24fb51`
{.table-cell}
||
||

_stock_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Stock in the restaurant. When 0, the dish disappears from the menu. Optional field. If stock is not passed for itemId, the stock of the dish is considered as 0.

_Default:_{.json-schema-reset .json-schema-value} `0`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "itemId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
  "stock": 5
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### MenuAvailabilityModifiers {#entity-MenuAvailabilityModifiers}

#|
|| **Name** | **Description** ||
||

_modifierId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Internal identifier of the modifier in the partner's restaurant system. Can be any value convertible to a string. Recommendation - UUID4

_Example:_{.json-schema-reset .json-schema-example} `eff0cec0-058c-4d53-b524-1c04ac24fb51`
{.table-cell}
||
||

_stock_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Stock in the restaurant. When 0, the modifier disappears from the menu. Optional field. If stock is not passed for modifierId, the stock of the modifier is considered as 0.

_Default:_{.json-schema-reset .json-schema-value} `0`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "modifierId": "eff0cec0-058c-4d53-b524-1c04ac24fb51",
  "stock": 5
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

Authorization failed - the token expired or was not passed in the request. A retry will be made

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "reason": "Access token has been expired. You should request a new one"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_reason_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Reason for authorization failure

_Example:_{.json-schema-reset .json-schema-example} `Access token has been expired. You should request a new one`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__404">

## 404 Not Found

No restaurant found. **_An array with an object from the error list is expected in the response body_**

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
[
  {
    "code": 100,
    "description": "Description of error"
  }
]
```

{% endcut %}

**Type**: [ErrorItem](#entity-ErrorItem)[]

</div>

<div class="openapi-entity">

### ErrorItem {#entity-ErrorItem}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Error code agreed with Yandex
{.table-cell}
||
||

_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Error message

_Example:_{.json-schema-reset .json-schema-example} `Description of error`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "code": 100,
  "description": "Description of error"
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Internal server errors. **_An array with an object from the error list is expected in the response body_**

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
[
  {
    "code": 100,
    "description": "Description of error"
  }
]
```

{% endcut %}

**Type**: [ErrorItem](#entity-ErrorItem)[]

</div>

</div>

</div>

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