# Create Transfer Request

This endpoint creates a new transfer request. This is the first step in a dual-control workflow for making transfers.
The request body requires a `CreateTransferRequest` object, which specifies the transfer details and the reviewers.

Endpoint: POST /api/v1/transfer-requests/
Version: Version: 0d14821f
Security: CodeBearer

## Security:

  - `CodeBearer` (unknown)
    oauth2 scopes: transfers.write

## Request fields (application/json):

  - `transfer` (any, required)

  - `transfer.id` (string, required)

  - `transfer.type` (string, required)

  - `transfer.origin_pocket_id` (string, required)

  - `transfer.amount` (object, required)

  - `transfer.amount.type` (string, required)

  - `transfer.amount.amount_usdc` (integer, required)

  - `transfer.details` (any, required)

  - `transfer.details.type` (string, required)

  - `transfer.details.destination_counterparty_id` (string, required)

  - `transfer.details.destination_pocket_id` (string, required)

  - `transfer.details.transfer_type` (any)
    Type of internal reallocation transfer. BANK_TRANSFER (default): sells the CUSIP from the origin pocket and buys new CUSIP for the destination pocket. Settlement is T+1. SECURITY_TRANSFER: no bank transaction occurs; CUSIPs are moved directly between pockets. This is instant but only allowed for JikoNet pockets.

  - `transfer.description` (any)

  - `transfer.end_to_end_identification` (any)

  - `transfer.counterparty_id` (string, required)

  - `reviewers` (any)

  - `notify_member_ids` (any)

## Request examples:

  - `Wire transfer request` (unknown)

  - `On-us peer-to-peer transfer request` (unknown)

  - `On-us internal reallocation transfer request` (unknown)

  - `USDC transfer request` (unknown)

## Response 202:

  - `202` (unknown)
    Successful Response

## Response 422:

  - `422` (unknown)
    Validation Error

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)