Skip to main content

persons/{uid}/settings

This method returns settings or preferences of the logged user (“me”) or any other user. The latter requires appropriate access rights. The properties are:

  • The user interface language

  • The user interface “culture” or date/time format

  • The time zone

URL

CODE
(GET) /api/persons/{uid}/settings?includeOptions=
(GET) /api/persons/me/settings?includeOptions=

PARAMETERS

The URL parameters are:

uid

Either pass a user ID or the shortcut “me” for the logged user.

To find users, see persons/list

int or “me”, Mandatory

includeOptions

Optional. Default is false if not specified.

  • true: The results include all available options for the UI language, culture and time zones. This is useful if you would like to then update the settings with new values.

bool, Optional

RESULTS

The result are a JSON object with these properties:

uid

The user ID. This is the user specified in the URL parameter.

int

uname

The user name.

string

language

The user interface language. This node includes code and print name. Example:

CODE
"language": {
   "v": "en",
   "t": "English (en)"
}

object

culture

The date and time format. This node includes code and print name. Example:

CODE
"culture": {
    "v": "fr-FR",
    "t": "French (France) (fr-FR)"
}

object

timezone

The time zone with detailed information.

Please see Time zone properties

object

languages

All possible UI languages. This node is included if parameter includeOptions is true.

A JSON array of options.:

CODE
"languages": [
    { "v": "en", "t": "English" },
    { "v": "fr", "t": "French" },
    ...
]

object[]?

cultures

All possible date/time formats. This node is included if parameter includeOptions is true.

A JSON array of options.:

CODE
"cultures": [
        {
            "v": "ab",
            "t": "Abkhazian"
        },
        {
            "v": "ach",
            "t": "Acholi"
        },
        {
            "v": "adh-UG",
            "t": "Adhola (Uganda)"
        }
    ...
]

object[]?

timezones

All possible time zones. This node is included if parameter includeOptions is true.

A JSON array of time zones. See Time zone properties for each time zone’s properties.

object[]?

EXAMPLES

A typical example for a user and when “includeOptions” is not set to true.

CODE
{
	"uid": 562,
	"uname": "John Wick",
	"cid": 537,
	"language": {
		"v": "en",
		"t": "English (en)"
	},
	"culture": {
		"v": "fr-FR",
		"t": "French (France) (fr-FR)"
	},
	"timezone": {
		"id": "Romance Standard Time",
		"name": "(UTC+01:00) Brussels, Copenhagen, Madrid, Paris",
		"currentName": "Romance Daylight Time",
		"currentDate": "2022-05-11T17:28:12.4421194+00:00",
		"currentOffset": "02:00:00",
		"supportsDaylightSaving": true
	}
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.