# Create withdrawal

Initiates a payout from account_id (under client_id). Provide withdrawal details (e.g., withdrawalType, target bankAccount) in the request body. The response returns the created transaction with identifiers, amounts, and settlement metadata for tracking.

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

## Path parameters:

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

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

## Request fields (application/json):

  - `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"

  - `amount` (number, required)
    Transaction amount

## Response 200 fields (application/json):

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

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

  - `transactionType` (string, required)
    Account type

  - `aborted` (boolean)
    Transaction has been aborted.

  - `abortedReason` (string)
    Error code or freetext explaining abort
    Example: "referenced_order_canceled"

  - `ref` (string)
    Transaction reference. External id. 255 chars.

  - `refType` (any)
    The type of reference. Text or object Id

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

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

  - `amount` (number, required)
    Transaction amount as a number
    Example: 1.2

  - `currency` (string, required)
    Three letter ISO currency code
    Enum: "SEK"

  - `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"

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

  - `freetext` (string)
    Free text of transaction
    Example: "Hello world"

  - `instrument` (string)
    Id of instrument if it is a transaction related to a specific instrument but not an order, ie retrocession
    Example: "SE0012193019SEK"

  - `startDate` (string)
    If a transaction is regarding a period of time

  - `endDate` (string)
    If a transaction is regarding a period of time

  - `createdDate` (string)
    Date when transaction was created
    Example: "2018-12-13t23:59:00.001z"

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

  - `settlementDate` (string)
    Date when transaction was settled, null if not settled
    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