# ReturnContract

PATH: /aurora.core.apiengine.contractsv1.ContractService/ReturnContract

Endpoint: POST /aurora.core.apiengine.contractsv1.ContractService/ReturnContract
Version: v1.23.0
Security: Bearer

## Request fields (application/json):

  - `contract_id` (string, required)
    Contract identifier (persistent contract identifier inside Aurora system)

  - `quantity` (string, required)
    Amount of shares to return

  - `request_id` (string)
    An optional identifier provided by the user to help associate the order request any internal record keeping.
If the same value is observed recently then the request will be rejected.

## Response 200 fields (application/json):

  - `contract_id` (string, required)
    Contract identifier (persistent identifier inside Aurora system)

  - `contract_return` (object, required)
    Fields: id, contract_id, quantity, status

  - `contract_return.contract_id` (string, required)
    Contract identifier (persistent identifier inside Aurora system)

  - `contract_return.id` (string, required)
    Return identifier (persistent identifier inside Aurora system for the return)

  - `contract_return.quantity` (string, required)
    Amount of shares being returned

  - `contract_return.status` (string, required)
    Enum: "RETURN_PENDING", "RETURN_COMPLETED", "RETURN_REJECTED", "PENDING_CANCEL", "CANCELED", "DROPPED", "RETURN_PENDING_LENDERS_APPROVAL", "RETURN_REJECTED_BY_LENDER"