# Request order cancellation

Request order cancellation to Keeta.

> It is expected to receive a  event after this action.


HOST: 

DIRECTION:

  


Endpoint: POST /v1/orders/{orderId}/requestCancellation
Version: v.1.0.6
Security: OAuth2, Sig

## Path parameters:

  - `orderId` (string, required)
    The unique identifier of the order. The order ID is generated by Keeta.

## Request fields (application/json):

  - `reason` (string, required)
    Open text field indicating the reason for the cancellation.

  - `code` (string, required)
    Enum: "INSUFFICIENT_DISHES", "SUSPENSION_OF_BUSINESS", "INSUFFICIENT_MANPOWER", "OTHERS"

  - `mode` (string, required)
    Indicates whether the cancellation request was made by an automatic or manual process in the Software Service
    Enum: "AUTO", "MANUAL"

  - `outOfStockItems` (array)
    Items that are not in the merchant's inventory.

  - `invalidItems` (array)
    Items that do not exist in the merchant's inventory.

## Response 400 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 401 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 403 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 404 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 422 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

  - `cancellationStatus` (string)
    Indicates the result of the cancellation request.
    Enum: "CANCELLED"

## Response 503 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500