curl --request GET \
--url 'https://gateway.amana.io/geo-location/'
import requests
url = "https://gateway.amana.io/geo-location/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/geo-location/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"ip": "<string>",
"city": "<string>",
"region": "<string>",
"countryCode": "<string>",
"countryName": "<string>",
"latitude": 123.45,
"longitude": 123.45,
"timezone": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Onboarding & KYC
Detect location
Get the approximate location of the caller’s IP address, such as country and timezone. Use it to pre-fill sign-up details.
GET
/
geo-location
/
curl --request GET \
--url 'https://gateway.amana.io/geo-location/'
import requests
url = "https://gateway.amana.io/geo-location/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/geo-location/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"ip": "<string>",
"city": "<string>",
"region": "<string>",
"countryCode": "<string>",
"countryName": "<string>",
"latitude": 123.45,
"longitude": 123.45,
"timezone": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Response
200 Success.
string
string
string
string
string
number
number
string
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 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/geo-location/'
import requests
url = "https://gateway.amana.io/geo-location/"
headers = {}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/geo-location/', {
method: 'GET',
headers: {},
});
console.log(await response.json());
{
"ip": "<string>",
"city": "<string>",
"region": "<string>",
"countryCode": "<string>",
"countryName": "<string>",
"latitude": 123.45,
"longitude": 123.45,
"timezone": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
