# On-Us Transfers

Use these endpoints to create and view On-Us (Book) Transfers between Jiko accounts.

## Create On-Us Transfer

 - [POST /api/v1/transfers/on-us/](https://docs.jiko.io/products/partner-api/reference/on-us-transfers/create-on-us-transfer.md): Initiates an On-Us Transfer between two Pockets.

On-Us Transfers can be made in four directions (defined by type):

1. PARTNER_CUSTOMER_FUNDING: From a Partner’s Pocket to a Customer’s Pocket
2. PARTNER_CUSTOMER_DEFUNDING: From a Customer’s Pocket to a Partner’s Pocket
3. INTERNAL_REALLOCATION: Between two Pockets belonging to the same Customer
4. PEER_TO_PEER: From a Customer’s Pockets to Customer’s On-Us Counterparty

On-Us Transfer amounts can be specified two ways (defined by amount.type):

1. REQUESTED_AMOUNT: Transfer a specified dollar amount
2. FULL_WITHDRAWAL: Transfer the Pocket's total available balance (net of fees). amount.type cannot be FULL_WITHDRAWAL when type is PARTNER_CUSTOMER_FUNDING.

On-Us Transfers can be processed asynchronously or synchronously. We strongly recommend processing On-Us Transfers asynchronously (setting async_mode to true). Asynchronous transfers will be created in a PENDING state and status updates will be delivered via Webhooks.

## Get On-Us Transfer

 - [GET /api/v1/transfers/on-us/{transfer_id}/](https://docs.jiko.io/products/partner-api/reference/on-us-transfers/get-on-us-transfer.md): Gets a single on-us transfer by ID.