curl --request GET \
--url 'https://gateway.amana.io/kyc/{entity}/{formId}'
import requests
url = "https://gateway.amana.io/kyc/{entity}/{formId}"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{entity}/{formId}', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"entity": "<string>",
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"form_instance_id": "<string>",
"section": 123.45,
"answers": {},
"one_time_questions": [],
"kyc_completed": true,
"account_type": "amana",
"trading_accounts": [
{
"id": "<string>",
"external_id": "<string>",
"external_user": "<string>",
"type": "<string>",
"currency": "<string>",
"group": "<string>",
"kyc_id": "<string>",
"last_active": "2026-01-01T00:00:00Z"
}
],
"created_at": "<string>",
"updated_at": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Onboarding & KYC
Get saved KYC answers
Get the answers the user has already saved for a KYC form.
GET
/
kyc
/
{entity}
/
{formId}
curl --request GET \
--url 'https://gateway.amana.io/kyc/{entity}/{formId}'
import requests
url = "https://gateway.amana.io/kyc/{entity}/{formId}"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{entity}/{formId}', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"entity": "<string>",
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"form_instance_id": "<string>",
"section": 123.45,
"answers": {},
"one_time_questions": [],
"kyc_completed": true,
"account_type": "amana",
"trading_accounts": [
{
"id": "<string>",
"external_id": "<string>",
"external_user": "<string>",
"type": "<string>",
"currency": "<string>",
"group": "<string>",
"kyc_id": "<string>",
"last_active": "2026-01-01T00:00:00Z"
}
],
"created_at": "<string>",
"updated_at": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Path parameters
string
required
ID of the KYC form.
string
required
Response
200 Success.
string
string
string
string
string
number
object
string[]
boolean
enum<string>
default:"amana"
Available options:
amana, mt5_hedged, mt5_netting, mt4, copy_trading, snb, c2c_investing, c2c_tradingobject[]
Show properties
Show properties
string
string
string
string
string
string
string
string<date-time>
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$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. |
| 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/{entity}/{formId}'
import requests
url = "https://gateway.amana.io/kyc/{entity}/{formId}"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{entity}/{formId}', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"entity": "<string>",
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"form_instance_id": "<string>",
"section": 123.45,
"answers": {},
"one_time_questions": [],
"kyc_completed": true,
"account_type": "amana",
"trading_accounts": [
{
"id": "<string>",
"external_id": "<string>",
"external_user": "<string>",
"type": "<string>",
"currency": "<string>",
"group": "<string>",
"kyc_id": "<string>",
"last_active": "2026-01-01T00:00:00Z"
}
],
"created_at": "<string>",
"updated_at": "<string>"
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
