Obtain an access token using client credentials.

POST

/integration/auth/token

This endpoint authenticates the client using their credentials and returns a bearer token.
The token should be included in the Authorization header of subsequent requests.

Usage:

Call this endpoint with your username and secret

Store the returned access_token

Include the token in subsequent requests: Authorization: Bearer {access_token}

When the token expires (based on expires_in), obtain a new one

Example Request:

{
"username": "email@example.com",
"secret": "your-secret-key-here"
}

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Example

{
    "username": "email@example.com",
    "secret": "your-secret-key-here"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://my.test-1.account.finlego.com/api/merchant/integration/auth/token' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "email@example.com",
    "secret": "your-secret-key-here"
}'

Responses

🟢200

application/json

Successfully authenticated. Returns the access token.

Bodyapplication/json

Example

{
    "accessToken": "eyJjbGllbnRJZCI6IjExMTExMTExLTExMTEtMTExMS0xMTExLTExMTExMTExMTExMSIsImV4cCI6MTczODI3NDQwMCwiaWF0IjoxNzM4MjcwODAwfQ==",
    "tokenType": "Bearer",
    "expiresIn": 3600
}

🟠400

🟠401

🔴500

Modified at 2026-08-19 08:22:13

Returns the paged list of accounts

Returns the exchange rate between the sell and buy accounts