Skip to content
get

Get user locale

Endpoint

gethttps://<REGION>.cloud.appwrite.io/v1/locale

Description

Get the current user location based on IP. Returns an object with user country code, country name, continent name, continent code, ip address and suggested currency. You can use the locale header to get the data in a supported language.

(IP Geolocation by DB-IP)

Required scopes

locale.read

Authentication

Initialize the Appwrite client with setProject() and authenticate with either a server API key (setKey()) or a signed-in user (setSession() or setJWT()). For direct REST calls, send X-Appwrite-Project with either X-Appwrite-Key or session/JWT headers.
Status
Content type
200
application/json

Locale

Name
Type
Description
string

User IP address.

string

Country code in ISO 3166-1 two-character format

string

Country name. This field support localization.

string

Continent code. A two character continent code "AF" for Africa, "AN" for Antarctica, "AS" for Asia, "EU" for Europe, "NA" for North America, "OC" for Oceania, and "SA" for South America.

string

Continent name. This field support localization.

boolean

True if country is part of the European Union.

string

Currency code in ISO 4217-1 three-character format

Python
from appwrite.client import Client
from appwrite.services.locale import Locale


client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_session('') # The user session to authenticate with


locale = Locale(client)


result = locale.get()