# Quote Same-Entity Security Transfer

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.

Endpoint: POST /api/v1/transfers/on-us/quotes/
Version: Version: 943bc408
Security: HTTPBearer

## Header parameters:

  - `x-jiko-idempotency` (string, required)

  - `x-jiko-signature` (string, required)

## Request fields (application/json):

  - `type` (string, required)

  - `transfer_type` (string, required)

  - `from_account` (object, required)

  - `from_account.id` (string, required)

  - `from_account.type` (string, required)

  - `to_account` (object, required)

  - `amount` (object, required)
    Creates a transfer for a specific, requested amount.

  - `amount.amount_usdc` (integer, required)

  - `amount.type` (string, required)

## Response 200 fields (application/json):

  - `is_allowed` (boolean, required)
    Whether the proposed transfer would be permitted at evaluation time.

  - `rejection_reason` (any)
    Partner-facing rejection reason when is_allowed is false; null otherwise.

  - `rejection_detail` (any)
    Human-readable explanation of the rejection; null when is_allowed is true.

  - `settlement_type` (string, required)
    Settlement type the transfer would receive, e.g. "T+0" or "T+1".

  - `eligible_transfer_amount` (object, required)
    Maximum amount the customer is eligible to transfer given their short-maturity holdings. Zero when the request was rejected before holdings could be evaluated.

  - `eligible_transfer_amount.value` (integer, required)
    USD values are always in cents.

  - `eligible_transfer_amount.currency` (string, required)

  - `eligible_transfer_amount.formatted` (string)

  - `object_type` (string, required)

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


