THIS SITE IS UNDER CONSTRUCTION

Update Preferred Language

Core Prod

https://api-core.deriv.com/v1

PUT

/client/preferred-language

Last modified:2025-07-15 07:48:46

This endpoint updates a client's preferred language and returns the client’s basic profile details, such as name, date of birth, nationality, gender, and country of residence.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api-core.deriv.com/v1/client/preferred-language' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "preferred_language": "en"
}'

Response Example

{
    "data": [
        {
            "client_id": 1,
            "address_id": 1,
            "first_name": "john",
            "last_name": "doe",
            "date_of_birth": "2000-02-10",
            "birth_country": "in",
            "residence_country": "in",
            "citizen_country": "in",
            "gender": "male",
            "created_time": "2025-07-15T07:15:29.219867",
            "updated_time": "2025-07-15T07:41:33.607287",
            "staff_identifier": null,
            "reason": null,
            "preferred_language": "en"
        }
    ],
    "meta": {
        "endpoint": "/v1/client/preferred-language",
        "method": "PUT",
        "timing": 1303
    }
}

Request

Header Params

Authorization

string

required

Example:

Body Params application/json

preferred_language

string

required

Examples

Responses

🟢200OK

application/json

Body

data

array [object {14}]

required

List containing the updated client profile details.

client_id

integer

required

Unique ID of the client.

address_id

integer | null

optional

Associated address ID if available.

first_name

string

required

Client's first name.

last_name

string

required

Client's last name.

date_of_birth

string <date>

required

Date of birth in YYYY-MM-DD format.

birth_country

string

required

ISO code of the country where the client was born.

residence_country

string

required

ISO code of the client's country of residence.

citizen_country

string

required

ISO code of the client's citizenship.

gender

string

required

Gender of the client.

created_time

string <date-time>

required

Timestamp when the record was created.

updated_time

string <date-time>

required

Timestamp when the record was last updated.

staff_identifier

string | null

optional

Staff email or ID who performed the update.

reason

string | null

optional

Reason for the update, if applicable.

preferred_language

string

required

Language code selected by the client (e.g., 'en', 'ar').