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 a server API key (setKey()), or authenticate as 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

JavaScript
const sdk = require('node-appwrite');


// Init SDK
const client = new sdk.Client();


const locale = new sdk.Locale(client);


client
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('5df5acd0d48c2') // Your project ID
    .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key
;


const promise = locale.get();


promise.then(function (response) {
    console.log(response);
}, function (error) {
    console.log(error);
});