Skip to main content
POST
/
cardaccounts
/
client-identity
Update client identity information for a card account
curl --request POST \
  --url https://access.utgl.io/v1/cardaccounts/client-identity \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "individual": {
    "dateOfBirth": "1985-07-20",
    "firstName": "John Anthony",
    "lastName": "CHAN",
    "email": "[email protected]",
    "annualIncome": "100000",
    "occupation": "accountant",
    "position": "senior management",
    "document": {
      "type": "passport",
      "front": "data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9",
      "number": "A12345678",
      "country": "HK",
      "back": "data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9",
      "expiryDate": "2025-12-31"
    },
    "firstNameLocal": "John Anthony",
    "lastNameLocal": "CHAN",
    "mobile": "+85255551234",
    "address": "123 Main Street, Anytown, USA",
    "gender": "MALE",
    "nationality": "HK",
    "supportingDocuments": [
      {
        "documentType": "WORK_VISA",
        "file": "data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9"
      }
    ]
  }
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174001",
  "cardAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "individual": {
    "firstName": "J*** A******",
    "lastName": "CHAN",
    "email": "j*****e@*****.com",
    "dateOfBirth": "1985-07-20",
    "annualIncome": "100000",
    "position": "senior management",
    "occupation": "accountant",
    "mobile": "85*******11",
    "document": {
      "type": "passport",
      "number": "******678",
      "country": "HK",
      "expiryDate": "2025-12-31"
    },
    "address": "address"
  }
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
cardAccountId
string<uuid>
required

Unique identifier for the card account.

Example:

"123e4567-e89b-12d3-a456-426614174000"

individual
object
required

Individual card holder identity information. This is required when account type is individual.

Response

200 - application/json

Client identity updated successfully

id
string<uuid>

Unique identifier for the update operation.

Example:

"123e4567-e89b-12d3-a456-426614174001"

cardAccountId
string<uuid>

Unique identifier for the card account.

Example:

"123e4567-e89b-12d3-a456-426614174000"

individual
object

Masked information about the cardholder.