> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlemma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Move money internally

> Transfer funds instantly between Lemma accounts.

Creates a transfer between two Lemma accounts. Book transfers settle instantly, are free, and are available 24/7.

<Info>
  Transfers over \$100,000 are held for manual review by the Lemma team as a
  security measure to protect your accounts in the event of a compromised API
  key. Need higher limits? [Contact us](mailto:contact@getlemma.com).
</Info>

## Request body

<ParamField body="source_account_id" type="string" required>
  The ID of the Lemma account to send money from.
</ParamField>

<ParamField body="destination_account_id" type="string" required>
  The ID of the Lemma account to send money to.
</ParamField>

<ParamField body="amount" type="integer" required>
  The amount to transfer in cents. Must be greater than zero.
</ParamField>

<ParamField body="description" type="string">
  A memo or description for the transfer. Appears on both the sender and
  recipient's transaction history.
</ParamField>

## Response

Returns the created book transfer object.

<ResponseField name="id" type="string">
  Unique identifier for the book transfer.
</ResponseField>

<ResponseField name="created_at" type="string">
  [ISO 8601](/api-reference/timestamps) timestamp of when the book transfer was
  created.
</ResponseField>

<ResponseField name="source_account_id" type="string">
  The Lemma account money moves from.
</ResponseField>

<ResponseField name="destination_account_id" type="string">
  The Lemma account money moves to.
</ResponseField>

<ResponseField name="amount" type="integer">
  The transfer amount in cents.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the book transfer.

  <Expandable title="possible values">
    * `complete` — settled. Most book transfers are complete the moment they're created.

    * `pending_approval` — held for manual review by our team for fraud prevention.

    * `canceled` — blocked after that manual review.
  </Expandable>
</ResponseField>

<ResponseField name="description" type="string">
  Description of the transfer.
</ResponseField>

<ResponseField name="source_transaction_id" type="string | null">
  The settled transaction on the source account, once the transfer posts.
</ResponseField>

<ResponseField name="destination_transaction_id" type="string | null">
  The settled transaction on the destination account, once the transfer posts.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "book_transfer_Hm3pWx9nKv4bQt7d",
    "created_at": "2026-03-15T14:30:00Z",
    "source_account_id": "account_Rv4nBt8xKw2pMh6s",
    "destination_account_id": "account_Hn9wFj3cTd7yXk5v",
    "amount": 500000,
    "status": "complete",
    "description": "Quarterly intercompany settlement",
    "source_transaction_id": "transaction_Wp5mRx3nKv8bTh2d",
    "destination_transaction_id": "transaction_Qk2nJx7mLv9bRt4c"
  }
  ```
</ResponseExample>