API reference · v1

BANKTRUST API

Use the BANKTRUST API to send PDF bank statements and receive ledger-ready, reconciled transaction data with confidence and variance checks built in.

Base URL

https://banktrustapp.com

Version

Auth

X-API-Key header

Authentication

API access is authenticated with a secret key tied to your BANKTRUST account.

Send your key in the HTTP header X-API-Key: YOUR_API_KEY.
Keys are created and managed inside the app (or provided directly during early access).
Treat API keys like passwords — keep them out of frontend code and public repos.

Create statement from PDF

Upload a single PDF bank statement and receive a processed statement record plus all parsed transactions. This matches the same flow you see in the web UI.

Endpoint

POST /api/v1/statements
Content-Type: multipart/form-data

Headers

X-API-Key – your secret API key.
Content-Type – handled automatically by your HTTP client when using form-data.

Form fields

file – PDF bank statement file (multipart/form-data file field).
client_id – UUID of the client in your BANKTRUST account. The statement will be attached to this client.

Response

On success, returns 201 Created.
Body includes a statement object (summary, balances, confidence, variance) and a transactions array with parsed rows.
In early access, the parsing engine is still being tuned, but totals and variance are kept consistent with the web UI.

Example requestcurl

curl -X POST \
  'https://banktrustapp.com/api/v1/statements' \
  -H 'X-API-Key: bt_test_example_key_123' \
  -H 'Content-Type: multipart/form-data' \
  -F 'client_id=3f2c1b3a-4e8c-4a0a-9a8b-123456789abc' \
  -F 'file=@/path/to/bank-statement.pdf'

Example response201 Created

{
  "ok": true,
  "statement": {
    "id": "b3a7f9f8-1d2e-4a11-9f3d-5ce0b4e9a123",
    "client_id": "3f2c1b3a-4e8c-4a0a-9a8b-123456789abc",
    "currency": "EUR",
    "statement_start_date": "2025-01-02",
    "statement_end_date": "2025-01-12",
    "created_at": "2025-01-15T09:32:10.000Z",
    "confidence": 98.5,
    "variance": {
      "amount": 0,
      "percent": 0
    },
    "status": "processed"
  },
  "transactions": [
    {
      "date": "2025-01-02",
      "description": "Card purchase - Groceries",
      "amount": -75.50,
      "running_balance": 924.50,
      "reference": null,
      "anomalies": {
        "is_balance_gap": false,
        "is_outlier_amount": false,
        "is_parse_suspect": false
      }
    }
    // ...
  ]
}