Create

Transfer funds within Lithic

post/v1/transfer

Transfer funds between two financial accounts or between a financial account and card

Body Parameters

amountnumber

Amount to be transferred in the currency’s smallest unit (e.g., cents for USD). This should always be a positive value.

fromstring

Globally unique identifier for the financial account or card that will send the funds. Accepted type dependent on the program's use case.

formatuuid

tostring

Globally unique identifier for the financial account or card that will receive the funds. Accepted type dependent on the program's use case.

formatuuid

tokenstring

optional

Customer-provided token that will serve as an idempotency token. This token will become the transaction token.

formatuuid

memostring

optional

Optional descriptor for the transfer.

Returns

tokenstringcategoryenumcreatedstringcurrencystringdescriptorstringeventsarray of objectfrom_balancearray of Balancepending_amountnumberresultenumsettled_amountnumberstatusenumto_balancearray of BalanceupdatedstringTransfer

Request example Request

curl https://api.lithic.com/v1/transfer \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "amount": 0,
      "from": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "to": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
    }'

200 Example

{
  "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "category": "TRANSFER",
  "created": "2019-12-27T18:11:19.117Z",
  "currency": "currency",
  "descriptor": "descriptor",
  "events": [
    {
      "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "amount": 0,
      "created": "2019-12-27T18:11:19.117Z",
      "result": "APPROVED",
      "type": "ACH_ORIGINATION_CANCELLED"
    }
  ],
  "from_balance": [
    {
      "available_amount": 0,
      "created": "2019-12-27T18:11:19.117Z",
      "currency": "currency",
      "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "financial_account_type": "ISSUING",
      "last_transaction_event_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "last_transaction_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "pending_amount": 0,
      "total_amount": 0,
      "updated": "2019-12-27T18:11:19.117Z"
    }
  ],
  "pending_amount": 0,
  "result": "APPROVED",
  "settled_amount": 0,
  "status": "DECLINED",
  "to_balance": [
    {
      "available_amount": 0,
      "created": "2019-12-27T18:11:19.117Z",
      "currency": "currency",
      "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "financial_account_type": "ISSUING",
      "last_transaction_event_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "last_transaction_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "pending_amount": 0,
      "total_amount": 0,
      "updated": "2019-12-27T18:11:19.117Z"
    }
  ],
  "updated": "2019-12-27T18:11:19.117Z"
}