curl --request GET \
--url 'https://gateway.amana.io/kyc/bank-account-details?iban=<iban>'
import requests
url = "https://gateway.amana.io/kyc/bank-account-details?iban=<iban>"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/bank-account-details?iban=<iban>', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"iban": "<string>",
"bankName": "<string>",
"bankCode": "<string>",
"beneficiaryName": "<string>",
"address": "<string>",
"bankAddress": "<string>",
"bankCountry": "<string>",
"swiftCode": "<string>",
"currency": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Onboarding & KYC
Look up bank details by IBAN
Get bank details, such as bank name and SWIFT code, for an IBAN.
GET
/
kyc
/
bank-account-details
curl --request GET \
--url 'https://gateway.amana.io/kyc/bank-account-details?iban=<iban>'
import requests
url = "https://gateway.amana.io/kyc/bank-account-details?iban=<iban>"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/bank-account-details?iban=<iban>', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"iban": "<string>",
"bankName": "<string>",
"bankCode": "<string>",
"beneficiaryName": "<string>",
"address": "<string>",
"bankAddress": "<string>",
"bankCountry": "<string>",
"swiftCode": "<string>",
"currency": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Query parameters
string
required
Minimum length:
1Response
200 Success.
string
string
string
string
string
string
string
string
string
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field | Check the request against the schema. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 404 | The requested item doesn’t exist | Check the ID or path parameter. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request GET \
--url 'https://gateway.amana.io/kyc/bank-account-details?iban=<iban>'
import requests
url = "https://gateway.amana.io/kyc/bank-account-details?iban=<iban>"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/bank-account-details?iban=<iban>', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"iban": "<string>",
"bankName": "<string>",
"bankCode": "<string>",
"beneficiaryName": "<string>",
"address": "<string>",
"bankAddress": "<string>",
"bankCountry": "<string>",
"swiftCode": "<string>",
"currency": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
Last modified on October 8, 2026
