Base URLs & environments
Overview
This article explains how to identify the correct regional and environment-specific base URLs for your API calls. It also describes how these identifiers are structured within the URL.
Base URLs
Base URLs define the root address used to make API requests.
Regional URLs
Base URL format (production only):
https://api.{region}.lending.akkuro.io
This format is specific to the production environment. The {region} segment in the URL specifies where the tenant is deployed. API access is restricted to the subdomain corresponding to that deployment region.
Akkuro Lending tenants are hosted in one of two regions: Europe or Switzerland.
| Code | Region | Example |
|---|---|---|
eu | Europe | https://api.eu.lending.akkuro.io |
ch | Switzerland | https://api.ch.lending.akkuro.io |
Non-production environments
Akkuro Lending provides a User Acceptance Testing (UAT) environment that enables safe development, testing, and validation without affecting live systems or data.
Use the following base URL format for the uat environment:
- UAT in Europe:
https://api.uat.eu.lending.akkuro.io - UAT in Switzerland:
https://api.uat.ch.lending.akkuro.io
- If the UAT environment is not specified in the base URL, it defaults to the production environment.
- Production and UAT environments are available in all supported regions.
- The environment naming conventions are consistent across the platform.
Endpoints
All API requests should start with the base URL, followed by the domain-specific endpoint path.
For example:
https://api.eu.lending.akkuro.io/counterparty-management/counterpartieshttps://api.eu.lending.akkuro.io/counterparty-management/addresseshttps://api.eu.lending.akkuro.io/financing-solutions/agreements