Calling Leatherback Open Banking APIs

This section provides documentation for essential API calls that retrieve lists of accounts and details for individual accounts. By following these guidelines, you can effectively retrieve and utilize financial data to power your applications and services.

Exchange Authorization Code for API Access Token

Before calling any other APIs, you must exchange the authorization code received during the user authorization process for an access token. This access token is necessary for authenticating subsequent API requests.

API Endpoint: https://api-openbanking.leatherback.co/auth/token

Method: POST

Request Headers:

Content-Type: application/x-www-form-urlencoded

Request Body (form-encoded):

grant_type=authorization_code&code=<authorization_code>&client_id=<client_id>&password=<password>&scope=account

Sample Request

curl -X POST "https://api.leatherback.com/api/v1/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code=<authorization_code>&client_id=<client_id>&password=<password>&scope=account"

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IjVEODhEQjBDMDMyMzRENjQ5NEM1NDI0ODEzRkFBQTkxIiwiY3VzdG9tZXJJZCI6IjU1ODkzNDM2LTcyY2UtNGQzYi04N2VhLTA4ZGI1YWQwNzhiYiIsImNvbnNlbnRJZCI6IjczMDkyN2U4LTY3OWMtNDlhZC05NzljLTAzMjI0YjE1MTI2MyIsIm5iZiI6MTcxOTkxNzQ2MSwiZXhwIjoxNzE5OTE3NzYxLCJpYXQiOjE3MTk5MTc0NjF9.3dPIHz9hvP4MY1u65Xb8GkkdKR6Qv0tUJZa_2tzRrWk",
    "token_type": "Bearer",
    "expires_in": 39361,
    "id_token": "oa_stg_GBjFz9x8GwZPwPpqzsQpB4nqjkCbPFFv8sQq0U4ITw0KzRzwCu",
    "access_token_id": "a8SD5zU5Dx3cXRGHz65gdyDIVeMAbUBY3ihxkjp5ZjURb6vooz"
}

To retrieve a comprehensive list of accounts associated with a customer, you can use the following API call:

API Endpoint: https://api.leatherback.co/transactions/api/v1/account/get-customer-accounts

Method: GET

Path Parameters:

CustomerId: The unique identifier of the customer.

Authorization: Bearer {access_token}
Content-Type: application/json

To retrieve detailed information for a specific account, use the following API call:

API Endpoint: https://api.leatherback.co/transactions/api/v1/account/get-customer-account-detail

Method: GET

Path Parameters:

accountId: The unique identifier of the account.

Authorization: Bearer {access_token}
Content-Type: application/json (if required)

To retrieve available and ledger balance information for a specific account, use the following API call:

API Endpoint: https://api-openbanking.leatherback.co/accounts/{accountId}/balances

Method: GET

Path Parameters

accountId: The unique identifier of the account.

Authorization: Bearer {access_token}
Content-Type: application/json

To retrieve beneficiaries information for a specific account, use the following API call:

API Endpoint: https://api-openbanking.leatherback.co/accounts/{accountId}/beneficiaries

Method: GET

Path Parameters:

accountId: The unique identifier of the account.

Authorization: Bearer {access_token}
Content-Type: application/json

Previous

Next

Leatherback Open Banking Project

Calling Leatherback Open Banking APIs

Exchange Authorization Code for API Access Token

Related articles