# 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.

## Quote Same-Entity Security Transfer

 - [POST /api/v1/transfers/on-us/quotes/](https://docs.jiko.io/products/partner-api/reference/on-us-transfers/preview-on-us-transfer.md): Returns a dry-run quote for a same-entity on-us security transfer (an INTERNAL_REALLOCATION of type SECURITY_TRANSFER), running the same validation and ruleset evaluation as creating the transfer but booking no trades and persisting nothing. The quote reports whether the transfer would be allowed, its settlement type, and the eligible transfer amount. Only the security-transfer type is quotable; other on-us types are rejected. It is indicative only: a successful quote is not a guarantee that the transfer will book.

## 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.