Skip to content

ONE/Connect

ONE/Connect is BANKSapi's single-user multibanking product for individuals and small companies: you connect your own bank accounts in a hosted web application, covered by BANKSapi's PSD2 license, and access the data through the BANKS/Connect API. See the product page for details and pricing, and to get ONE/Connect.

ONE/Connect comes in two variants: Basic (account information) and Classic (additionally payments via SEPA transfers and direct debits). Creating a token works the same for both; only the endpoint differs.

1. Get your API key

Log in to your ONE/Connect application (Basic, Classic). Your personal API key is displayed on the dashboard. Copy it from there and treat it like a password: it grants access to your connected bank data.

2. Create a token

Exchange the API key for an OAuth2 bearer token using the token endpoint of your variant (Basic, Classic):

bash
curl -X POST 'https://banksapi.io/onebasic/bc-token' \
  -H 'X-API-KEY: <your-api-key>'
bash
curl -X POST 'https://banksapi.io/one/bc-token' \
  -H 'X-API-KEY: <your-api-key>'

The response contains the access_token, which is usually valid for two hours.

3. Call the BANKS/Connect API

Use the access token as a bearer token against the Customer API, for example to list your bank connections:

bash
curl 'https://banksapi.io/customer/v2/bankzugaenge' \
  -H 'Authorization: Bearer <access-token>'

Continue with Create Bank Access in the Quick Start guide to add bank connections and query accounts and transactions via the API.