GetbeelDocs
API referenceBank reconciliation

List bank statements, newest first

GET
/bank-statements

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

limit?integer

Page size, 1–100

Range1 <= value <= 100
Default20
cursor?string

next_cursor of the previous page

Length1 <= length <= 200
status?string
Value in"pending""processing""parsed""matching""review""completed""failed"

Header Parameters

Getbeel-Company?string

Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.

Formatuuid

Response Body

OK

application/json
  1. response
object*string
data*array<>
has_more*boolean
next_cursor*string|null
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/bank-statements'
Example Response
{  "object": "list",  "data": [    {      "object": "bank_statement",      "id": "stmt_1761800000000_ab12cd3",      "file_name": "string",      "mime_type": "text/csv",      "source": "upload",      "file_size": -9007199254740991,      "status": "pending",      "error_message": "string",      "bank_name": "string",      "account_number_last4": "string",      "currency": "EUR",      "period_start": "2026-10-29",      "period_end": "2026-10-29",      "transactions": {        "total": -9007199254740991,        "debits": -9007199254740991,        "matched": -9007199254740991,        "unmatched": -9007199254740991      },      "balances": {        "opening": "122.00",        "closing": "122.00"      },      "created_at": "2019-08-24T14:15:22Z",      "processed_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}