List balance transactions
Returns the movements in and out of the balance, newest first.
apiKeyAuthorizationBearer <token>API key in the Authorization: Bearer cf_live_... header. Create and revoke keys in the dashboard, under Desenvolvedores > Chaves de API (Developers > API keys).
type?stringOnly transactions of this type.
"top_up""letter""verification""refund""credit""adjustment"limit?integerHow many items to return per page, from 1 to 100. Default: 20.
1 <= value <= 10020cursor?stringThe next_cursor of the previous page. Leave it out to fetch the first page.
created_after?stringOnly items created at or after this moment. ISO 8601 date and time.
date-timecreated_before?stringOnly items created before this moment. ISO 8601 date and time.
date-timeA page of transactions.
application/json- response
A page of balance transactions, newest first.
object*stringObject type. Always list.
data*array<>The items on this page.
has_more*booleantrue when there are more items after this page.
next_cursor*|Send this value as cursor to fetch the next page. null when this is the last page.
curl "https://api.cartaflow.com.br/v1/balance/transactions" \ -H "Authorization: Bearer $CARTAFLOW_API_KEY"{ "object": "list", "data": [ { "id": "btx_4Lm8Qw2Zx9Kd", "object": "balance_transaction", "type": "letter", "amount": -1135, "currency": "BRL", "balance_after": 48865, "source_id": "ltr_8Kq2wX4mN7pR", "description": null, "created_at": "2026-10-13T14:20:00Z" }, { "id": "btx_1Gs5Vb7Nc3Pf", "object": "balance_transaction", "type": "top_up", "amount": 50000, "currency": "BRL", "balance_after": 50000, "source_id": null, "description": null, "created_at": "2026-10-12T11:02:00Z" } ], "has_more": true, "next_cursor": "eyJpZCI6ImJ0eF8xR3M1VmI3TmMzUGYifQ"}