--- title: "Transfer funds within Lithic" method: POST path: "/v1/transfer" tags: ["Book Transfer"] deprecated: true --- # Transfer funds within Lithic `POST /v1/transfer` > **Deprecated.** Transfer funds between two financial accounts or between a financial account and card ## Request body - object - `amount` integer, required — Amount to be transferred in the currency’s smallest unit (e.g., cents for USD). This should always be a positive value. - `from` string, uuid, required — Globally unique identifier for the financial account or card that will send the funds. Accepted type dependent on the program's use case. - `memo` string — Optional descriptor for the transfer. - `to` string, uuid, required — Globally unique identifier for the financial account or card that will receive the funds. Accepted type dependent on the program's use case. - `token` string, uuid — Customer-provided token that will serve as an idempotency token. This token will become the transaction token. ## Response `200` OK - Transfer - `category` 'TRANSFER' — Status types: * `TRANSFER` - Internal transfer of funds between financial accounts in your program. - `created` string, date-time — Date and time when the transfer occurred. UTC time zone. - `currency` string — 3-character alphabetic ISO 4217 code for the settling currency of the transaction. - `descriptor` string — A string that provides a description of the transfer; may be useful to display to users. - `events` FinancialEvent[] — A list of all financial events that have modified this trasnfer. - `amount` integer — Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents). - `created` string, date-time — Date and time when the financial event occurred. UTC time zone. - `result` 'APPROVED' | 'DECLINED' — APPROVED financial events were successful while DECLINED financial events were declined by user, Lithic, or the network. - `token` string, uuid — Globally unique identifier. - `type` 'ACH_ORIGINATION_CANCELLED' | 'ACH_ORIGINATION_INITIATED' | 'ACH_ORIGINATION_PROCESSED' | 'ACH_ORIGINATION_RELEASED' | 'ACH_ORIGINATION_REJECTED' | 'ACH_ORIGINATION_REVIEWED' | 'ACH_ORIGINATION_SETTLED' | 'ACH_RECEIPT_PROCESSED' | 'ACH_RECEIPT_RELEASED' | 'ACH_RECEIPT_SETTLED' | 'ACH_RETURN_INITIATED' | 'ACH_RETURN_PROCESSED' | 'ACH_RETURN_REJECTED' | 'ACH_RETURN_SETTLED' | 'AUTHORIZATION' | 'AUTHORIZATION_ADVICE' | 'AUTHORIZATION_EXPIRY' | 'AUTHORIZATION_REVERSAL' | 'BALANCE_INQUIRY' | 'BILLING_ERROR' | 'BILLING_ERROR_REVERSAL' | 'CARD_TO_CARD' | 'CASH_BACK' | 'CASH_BACK_REVERSAL' | 'CLEARING' | 'COLLECTION' | 'CORRECTION_CREDIT' | 'CORRECTION_DEBIT' | 'CREDIT_AUTHORIZATION' | 'CREDIT_AUTHORIZATION_ADVICE' | 'CURRENCY_CONVERSION' | 'CURRENCY_CONVERSION_REVERSAL' | 'DISPUTE_WON' | 'EXTERNAL_ACH_CANCELED' | 'EXTERNAL_ACH_INITIATED' | 'EXTERNAL_ACH_RELEASED' | 'EXTERNAL_ACH_REVERSED' | 'EXTERNAL_ACH_SETTLED' | 'EXTERNAL_CHECK_CANCELED' | 'EXTERNAL_CHECK_INITIATED' | 'EXTERNAL_CHECK_RELEASED' | 'EXTERNAL_CHECK_REVERSED' | 'EXTERNAL_CHECK_SETTLED' | 'EXTERNAL_FEDNOW_CANCELED' | 'EXTERNAL_FEDNOW_INITIATED' | 'EXTERNAL_FEDNOW_RELEASED' | 'EXTERNAL_FEDNOW_REVERSED' | 'EXTERNAL_FEDNOW_SETTLED' | 'EXTERNAL_RTP_CANCELED' | 'EXTERNAL_RTP_INITIATED' | 'EXTERNAL_RTP_RELEASED' | 'EXTERNAL_RTP_REVERSED' | 'EXTERNAL_RTP_SETTLED' | 'EXTERNAL_TRANSFER_CANCELED' | 'EXTERNAL_TRANSFER_INITIATED' | 'EXTERNAL_TRANSFER_RELEASED' | 'EXTERNAL_TRANSFER_REVERSED' | 'EXTERNAL_TRANSFER_SETTLED' | 'EXTERNAL_WIRE_CANCELED' | 'EXTERNAL_WIRE_INITIATED' | 'EXTERNAL_WIRE_RELEASED' | 'EXTERNAL_WIRE_REVERSED' | 'EXTERNAL_WIRE_SETTLED' | 'FINANCIAL_AUTHORIZATION' | 'FINANCIAL_CREDIT_AUTHORIZATION' | 'INTEREST' | 'INTEREST_REVERSAL' | 'INTERNAL_ADJUSTMENT' | 'LATE_PAYMENT' | 'LATE_PAYMENT_REVERSAL' | 'LOSS_WRITE_OFF' | 'PROVISIONAL_CREDIT' | 'PROVISIONAL_CREDIT_REVERSAL' | 'SERVICE' | 'RETURN' | 'RETURN_REVERSAL' | 'TRANSFER' | 'TRANSFER_INSUFFICIENT_FUNDS' | 'RETURNED_PAYMENT' | 'RETURNED_PAYMENT_REVERSAL' | 'LITHIC_NETWORK_PAYMENT' | 'LITHIC_PROGRAM_TRANSFER' | 'BANK_PROGRAM_TRANSFER' | 'ANNUAL' | 'ANNUAL_REVERSAL' | 'QUARTERLY' | 'QUARTERLY_REVERSAL' | 'MONTHLY' | 'MONTHLY_REVERSAL' | 'ACCOUNT_TO_ACCOUNT' | 'STABLECOIN_RECEIVED' | 'STABLECOIN_REVIEWED' | 'STABLECOIN_SETTLED' - `from_balance` Balance[] — The updated balance of the sending financial account. - `available_amount` integer, required — Funds available for spend in the currency's smallest unit (e.g., cents for USD) - `created` string, date-time, required — Date and time for when the balance was first created. - `currency` string, required — 3-character alphabetic ISO 4217 code for the local currency of the balance. - `financial_account_token` string, uuid, required — Globally unique identifier for the financial account that holds this balance. - `financial_account_type` 'CARD' | 'ISSUING' | 'OPERATING' | 'PROGRAM_RECEIVABLES' | 'RESERVE' | 'SECURITY', required — Type of financial account. - `last_transaction_event_token` string, uuid, nullable, required — Globally unique identifier for the last financial transaction event that impacted this balance. - `last_transaction_token` string, uuid, nullable, required — Globally unique identifier for the last financial transaction that impacted this balance. - `pending_amount` integer, required — Funds not available for spend due to card authorizations or pending ACH release. Shown in the currency's smallest unit (e.g., cents for USD). - `total_amount` integer, required — The sum of available and pending balance in the currency's smallest unit (e.g., cents for USD). - `updated` string, date-time, required — Date and time for when the balance was last updated. - `pending_amount` integer — Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees. The value of this field will go to zero over time once the financial transaction is settled. - `result` 'APPROVED' | 'DECLINED' — APPROVED transactions were successful while DECLINED transactions were declined by user, Lithic, or the network. - `settled_amount` integer — Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents). - `status` 'DECLINED' | 'EXPIRED' | 'PENDING' | 'SETTLED' | 'VOIDED' — Status types: * `DECLINED` - The transfer was declined. * `EXPIRED` - The transfer was held in pending for too long and expired. * `PENDING` - The transfer is pending release from a hold. * `SETTLED` - The transfer is completed. * `VOIDED` - The transfer was reversed before it settled. - `to_balance` Balance[] — The updated balance of the receiving financial account. - `available_amount` integer, required — Funds available for spend in the currency's smallest unit (e.g., cents for USD) - `created` string, date-time, required — Date and time for when the balance was first created. - `currency` string, required — 3-character alphabetic ISO 4217 code for the local currency of the balance. - `financial_account_token` string, uuid, required — Globally unique identifier for the financial account that holds this balance. - `financial_account_type` 'CARD' | 'ISSUING' | 'OPERATING' | 'PROGRAM_RECEIVABLES' | 'RESERVE' | 'SECURITY', required — Type of financial account. - `last_transaction_event_token` string, uuid, nullable, required — Globally unique identifier for the last financial transaction event that impacted this balance. - `last_transaction_token` string, uuid, nullable, required — Globally unique identifier for the last financial transaction that impacted this balance. - `pending_amount` integer, required — Funds not available for spend due to card authorizations or pending ACH release. Shown in the currency's smallest unit (e.g., cents for USD). - `total_amount` integer, required — The sum of available and pending balance in the currency's smallest unit (e.g., cents for USD). - `updated` string, date-time, required — Date and time for when the balance was last updated. - `token` string, uuid — Globally unique identifier for the transfer event. - `updated` string, date-time — Date and time when the financial transaction was last updated. UTC time zone. ## Other responses - `400` — A parameter in the query given in the request does not match the valid queries for the endpoint. - `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) | - `404` — The specified resource was not found. - `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys | --- [API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)