# Get On-Us Transfer

Gets a single on-us transfer by ID.

Endpoint: GET /api/v1/transfers/on-us/{transfer_id}/
Version: Version: 37bc941f
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer

## Path parameters:

  - `transfer_id` (string, required)

## Header parameters:

  - `x-jiko-idempotency` (string, required)
    A new UUID that you generate for each request, reads included. It is part of the request signature and prevents replay of a request. A value that was already sent in the last hour is rejected with `409 jiko.errors.DuplicateRequestError`, even if the first request failed. When you retry a request, generate a new value and sign the request again.

  - `x-jiko-signature` (string, required)
    Base64-encoded HMAC-SHA256 hash of `x-jiko-idempotency + request pathname + body`, keyed with your shared secret. See [Authentication](/products/partner-api/guides/building/auth) for the full algorithm and a code sample.

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `id` (string, required)

  - `status` (string, required)
    Enum: "PENDING", "COMPLETED", "REJECTED"

  - `reason` (any, required)

  - `transfer` (any, required)

  - `transfer.transfer_id` (any)
    The ID for this transfer, auto-generated if not provided.

  - `transfer.description` (any)
    A description of the transfer, visible on statements.

  - `transfer.end_to_end_identification` (any)
    Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain.

  - `transfer.from_account` (object, required)

  - `transfer.from_account.id` (string, required)

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

  - `transfer.type` (string, required)

  - `transfer.transfer_type` (string, required)
    Enum: "BANK_TRANSFER", "SECURITY_TRANSFER"

  - `transfer.amount` (object, required)

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

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

  - `transfer.amount.formatted` (string)

  - `transfer.target` (string, required)
    The funds destination belonging to the customer at the Partner institution.

  - `transfer.source` (string, required)
    The source of customer funds at the Partner institution.

  - `transfer.to_account` (object, required)

  - `transfer.to_account.id` (string, required)

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

  - `fees` (array, required)

  - `fees.type` (string, required)

  - `object_type` (string, required)

## Response 401:

  - `401` (unknown)
    The access token is missing, invalid or expired.

## Response 401 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

  - `fields` (any)
    Present only on input validation errors. Each entry identifies one invalid field: `loc` is its location, `msg` is the problem, and `type` is the validation rule that failed.

## Response 403:

  - `403` (unknown)
    `x-jiko-signature` does not match the request, or the access token does not permit this action.

## Response 403 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

  - `fields` (any)
    Present only on input validation errors. Each entry identifies one invalid field: `loc` is its location, `msg` is the problem, and `type` is the validation rule that failed.

## Response 404:

  - `404` (unknown)
    A resource identified in the path does not exist.

## Response 404 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

  - `fields` (any)
    Present only on input validation errors. Each entry identifies one invalid field: `loc` is its location, `msg` is the problem, and `type` is the validation rule that failed.

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