List bank imports

GET https://app.speybooks.com/api/v1/bank-imports/

Returns a paginated list of bank imports for the authenticated organisation, ordered by most recent first. Default pagination: page 1, 20 per page (max 100). Includes bank name and account details joined from the bank accounts table.

Query parameters

page integer optional

Page number. Default 1.

perPage integer optional

Imports per page. Default 20, maximum 100.

Response

200 Paginated list of imports with bank name, filename, date range, row counts, and status.

Show response fields

imports array<object>

Show child attributes

accountId string

bankName string

createdRows integer

filename string

id string

skippedRows integer

status string

totalRows integer

Request GET /v1/bank-imports/ curl

curl https://api.speybooks.com/v1/bank-imports?page=1&perPage=10 \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "imports": [
      {
        "id": "bim_12",
        "accountId": "acc_1200",
        "bankName": "Starling Bank",
        "filename": "starling-feb-2026.csv",
        "status": "completed",
        "totalRows": 45,
        "createdRows": 42,
        "skippedRows": 3
      }
    ]
  },
  "meta": {
    "page": 1,
    "perPage": 10,
    "total": 8,
    "pages": 1
  }
}