THIS SITE IS UNDER CONSTRUCTION

Update Client Tax Information

Core Prod

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

PUT

/client/tax-information

Last modified:2025-07-15 08:08:07

This API endpoint allows you to update a client’s tax and financial assessment details. It accepts modified information such as employment status, tax residence, tax identification number, and account opening reason, and returns the updated records along with metadata about the update operation.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api-core.deriv.com/v1/client/tax-information' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "financial_assessment": {
    "industry_of_employment": "medical",
    "occupation": "nurse"
  },
  "tax_identification_number": "XR2354F5",
  "tax_residence": "ae",
  "is_foreign_taxpayer": false,
  "employment_status": "employed"
}'

Response Example

{
    "data": [
        [
            {
                "id": 6219,
                "client_id": 1498,
                "type": "tax_assessment",
                "data": {
                    "employment_status": "employed",
                    "is_foreign_taxpayer": false,
                    "tax_residence_country": "ae",
                    "account_opening_reason": "Additional revenue",
                    "tax_identification_number": "test_XR2354F5"
                },
                "schema_version": 1,
                "created_time": "2025-07-10T05:21:20.203294",
                "updated_time": "2025-07-10T07:40:31.354157"
            },
            {
                "id": 6224,
                "client_id": 1498,
                "type": "financial_assessment",
                "data": {
                    "occupation": "testnurse",
                    "industry_of_employment": "test"
                },
                "schema_version": 1,
                "created_time": "2025-07-10T05:23:10.511296",
                "updated_time": "2025-07-10T07:40:31.354157"
            }
        ]
    ],
    "meta": {
        "endpoint": "/v1/client/tax-information",
        "method": "PUT",
        "timing": 792
    }
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

Modified at 2025-07-15 08:08:07

Create Client Tax Information

Get Client Tax Information