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

# List balance transactions

> GET /v1/balance/transactions lists money moving in and out of the Cleo Pay balance, newest first, with cursor pagination.

```
GET /v1/balance/transactions
```

**Scope:** `balance:read`

<ParamField query="limit" type="integer" default="25">1 to 100.</ParamField>
<ParamField query="startingAfter" type="string">The `nextCursor` of the previous page.</ParamField>

```bash theme={null}
curl "https://api.stg.cleo-pay.com/v1/balance/transactions?limit=50" \
  --header "Authorization: Bearer $CLEO_API_KEY"
```

## Response

```json theme={null}
{
  "items": [
    {
      "id": "trxn_1Q2w3E4r5T6y",
      "amountCents": -125000,
      "currency": "usd",
      "status": "posted",
      "type": "outbound_payment",
      "description": "Payment to Acme Supplies LLC",
      "isPendingDeposit": false,
      "isPayoutReturn": false,
      "payoutReturnReason": null,
      "payableId": "b1e2c3d4-5f6a-4b8c-9d0e-1f2a3b4c5d6e",
      "paymentId": "e4f5a6b7-c8d9-4e0f-9a1b-2c3d4e5f6a7b",
      "counterpartyName": "Acme Supplies LLC",
      "createdAt": "2026-10-17T13:00:05.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```

<ResponseField name="amountCents" type="integer">Signed. Positive adds to the balance; negative takes from it.</ResponseField>
<ResponseField name="status" type="string">`open`, `posted` or `void`.</ResponseField>

<ResponseField name="type" type="string">
  What moved the money, for example `inbound_transfer` (a deposit or a payment's pull), `outbound_payment` (a payout to a vendor), `outbound_transfer` (a withdrawal) or `received_credit`. Accept other values.
</ResponseField>

<ResponseField name="isPendingDeposit" type="boolean">A deposit Cleo is still waiting on. It is not in the balance yet.</ResponseField>
<ResponseField name="isPayoutReturn" type="boolean">Money coming back after a bank returned a payout or withdrawal.</ResponseField>
<ResponseField name="payoutReturnReason" type="string | null">Why the bank returned it.</ResponseField>

<ResponseField name="payableId" type="string | null" />

<ResponseField name="paymentId" type="string | null">The payment, when the transaction belongs to one.</ResponseField>
<ResponseField name="counterpartyName" type="string | null">Who the money went to or came from, when known.</ResponseField>

Keep calling with `startingAfter` set to `nextCursor` until `hasMore` is `false`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.