# Create order withdrawal

Sell fund units and withdraw the resulting amount

Endpoint: POST /v2/partner/client/{client_id}/order/withdrawal
Version: 2.0.0
Security: oAuth

## Query parameters:

  - `validate-only` (string)
    Only validate the order, do not create it.
    Example: "true"

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Request fields (application/json):

  - `orderType` (any, required)
    Enum: "redemption"

  - `account` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `clientRef` (string)
    Client applied ref
    Example: "my_order_123"

  - `executorRef` (string, required)
    Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client
    Example: "197001010003"

  - `instrument` (string, required)
    Fondo instrument ID
    Example: "US64110L1061USD"

  - `units` (number, required)
    Number of units. 7 decimals
    Example: 1000

  - `bankAccount` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `paymentAccount` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Response 204 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `status` (any)
    Order status

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)
    Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"

  - `orderType` (any, required)
    Enum: "subscription", "redemption"

  - `account` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `clientRef` (string)
    Client applied ref
    Example: "my_order_123"

  - `executorRef` (string)
    Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client
    Example: "197001010003"

  - `instrument` (string, required)
    Fondo instrument ID
    Example: "US64110L1061USD"

  - `units` (number, required)
    Number of units. 7 decimals. Required for redemption orders.
    Example: 1000

  - `amount` (number, required)
    For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.
    Example: 100

  - `createdDate` (string)
    date when created
    Example: "2018-12-13T23:59:00.001Z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `canceledDate` (string)
    Date when canceled
    Example: "2018-12-13T23:59:00.001Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error