Dive into our API reference

The Banking Circle API is designed to provide your company and your customers with easy and secure access to bank accounts, effective and secure management of money transfers and payments, and other services.

Start by being authorized to get your certificates, username, passwords etc. from Banking Circle Sales team here.

Making requests

As per RESTful design patterns, you can use the following HTTP verbs:

GET = Retrieve a resource

POST = Create a new resource

PUT = Modify an existing resource

DELETE = Remove a resource

Accounts

The API enables you to read and perform operations on Banking Circle accounts, where your company’s funds are placed. The “Balances” endpoint allows you to read how much funding is left on the account. The “Bookings” endpoint details spending and money influx. You can also use an account to distribute and collect funds – e.g. to pay suppliers or to collect payments from customers.

To use the Account API, you send a GET accounts request with a valid token to check if you have permission to access all the accounts you need. Contact Sales if you are missing account access. After finding out what accounts are associated with which account IDs, you can request account details, balances, and booking per account.

Authorization

The Authorization Service has a single endpoint that requires the use of a pre-registered certificate. When you are authenticated, you will get a JSON Web Token (JWT) that is your authorization key to access every other endpoint at Banking Circle. For machine-to machine users, we use a standard signed OAuth2 token.

The access token is valid for 5 minutes and must be in the header for the remaining calls to the API. Please note that we do not currently support refresh tokens.

Payments

The Payment API allows you to manage payments as Single Payments or as Payment Bulks. For example, if your workflow or automation process is designed to initiate payments every 10 minutes and you would like them executed as soon as possible, you would choose Single Payments.

In other cases, you can choose to send payments in bulk, where a collection of payments is processed at the same time.

You can also use the Payment id to request further details for example, if a payment has an FX rate attached. The API uses Straight-Through-Processing, where valid payments go directly to the core system for processing. Once a payment has been initiated, it can only be cancelled if the value date is not today.

Foreign Exchange

FX transactions can be executed either on our Real-time FX trading platform or programmatically via our FX API.

We offer a number of simple APIs to enter into a foreign exchange transaction with Banking Circle from your own application. Your FX orders can be executed in market order fashion at the current market price at the time of the order, or using a request for quote workflow where you'll receive the quote ahead of trading. In both cases we will respond with an immediate confirmation or rejection response with the FX transaction details including the exchange rate used, bought and sold amounts, and other relevant details.

Additionally, it is possible to use the request for quote workflow for multicurrency payments.

All FX transactions - whether executed via our FX API or on our Real-time FX trading platform - are available via our query endpoints, including any fees, settlement accounts, value dates, and exchange rates used in the transaction.

Please consult our guide to foreign exchange for more detail on our FX endpoints:

Guide to Banking Circle FX APIs

Fee

The Fee interface enables you to access real-time overview of the entries your company has made against your fee account such as the fees you need to pay, due date etc.

Reports

You can use the Report API to request any of the following reports, no matter which channel you have used for payment instruction:

  • Reconciliation - details of all account movements in the requested date range for reconciliation purposes
  • Rejection - information on all rejected payments with rejection date on the requested date
  • Account Balance – the latest available balances for all accounts
  • Account Activity – all activity for a specific account in the requested date range