API Overview


Our API is a REST API which requires a communication through HTTPS to send and receive JSON documents. During your tests, we recommend to make calls to the API with curl or any other HTTP client of your choice.

Hello world

Let's start by calling the service /connectors which lists all available banks/providers.

curl https://{domain}.biapi.pro/2.0/connectors/

To log in to a bank/provider webpage, you'll need to know for a given connector, the fields your user should fill in the form. Let's call a specific connector and ask for an additional resource fields.

curl https://{domain}.biapi.pro/2.0/connectors/59?expand=fields

The response here concerns only 1 connector (since we specified an id) and the resource fields is added to the response thanks to the query parameter expand.

To get more interesting things done, you'll need to send authenticated requests.


The way to authenticate is by passing the authorization: Bearer <token> header in your request. At the setup several manage tokens have been generated with the different scopes (categorization, config, invoicing and user). You can use one of these tokens for now, when creating your user we'll see how to generate a user's token.

curl https://{domain}.biapi.pro/2.0/config \
  -H 'authorization: Bearer <token>'

This endpoint will list all the parameters you can change to adapt our API to your needs.

We've covered the very first calls. Before diving deeper, let's see some general information about APIs.




Requests format

Data format: application/x-www-form-urlencoded or application/json (suggested)

Additional headers: authorization: User's token (private)

Responses format

Data format: application/json (http://www.json.org) Charset: UTF-8


Each call on an endpoint will return resources. The main resources are:

Last updated