Skip to main content
POST
/
v1
/
auth
/
register
/
personal-details
Update Personal Details
curl --request POST \
  --url https://api.example.com/v1/auth/register/personal-details \
  --header 'Content-Type: application/json' \
  --data '
{
  "onboardingId": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "dateOfBirth": "<string>",
  "countryOfNationality": "<string>",
  "ssn": "<string>"
}
'
{
  "onboardingId": "<string>",
  "user": {}
}

​
Overview

Submit user’s personal details including name, date of birth, and nationality. This information is used for KYC (Know Your Customer) verification. For US residents, SSN (Social Security Number) is required and will be securely stored for compliance purposes.

​
Request

​
Body

​
onboardingId
string
required
Onboarding ID from previous stepExample: US_100a99cf-f4d3-4fa1-c123-2e9833440ebb
​
firstName
string
required
User’s first nameExample: John
​
lastName
string
required
User’s last nameExample: Doe
​
dateOfBirth
string
required
Date of birthFormat: YYYY-MM-DDExample: 1990-01-01
​
countryOfNationality
string
required
Country of nationalityFormat: ISO 3166-1 alpha-2 codeExample: GB
​
ssn
string
Social Security NumberRequired only if: countryOfResidence = USExample: 123456789

​
Response

​
onboardingId
string
Updated onboarding ID
​
user
object
Updated user object with personal details

​
Code Examples

const response = await fetch('https://dev.api.baanx.com/v1/auth/register/personal-details', {
  method: 'POST',
  headers: {
    'x-client-key': 'your-client-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    onboardingId: sessionStorage.getItem('onboardingId'),
    firstName: 'John',
    lastName: 'Doe',
    dateOfBirth: '1990-01-01',
    countryOfNationality: 'GB',
    // ssn: '123456789' // Only for US residents
  })
});

const { user } = await response.json();
console.log('Personal details updated');
SSN is highly sensitive. Ensure HTTPS is used and data is transmitted securely.

​
Next Steps

Update Address

Add physical address information