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(). No signed-in user or server API key is required.
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

Java
import io.appwrite.Client;
import io.appwrite.coroutines.CoroutineCallback;
import io.appwrite.services.Locale;


Client client = new Client(context)
    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
    .setProject("<YOUR_PROJECT_ID>"); // Your project ID


Locale locale = new Locale(client);


locale.get(new CoroutineCallback<>((result, error) -> {
    if (error != null) {
        error.printStackTrace();
        return;
    }


    Log.d("Appwrite", result.toString());
}));