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>"
}
'import requests
url = "https://api.example.com/v1/auth/register/personal-details"
payload = {
"onboardingId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"dateOfBirth": "<string>",
"countryOfNationality": "<string>",
"ssn": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
onboardingId: '<string>',
firstName: '<string>',
lastName: '<string>',
dateOfBirth: '<string>',
countryOfNationality: '<string>',
ssn: '<string>'
})
};
fetch('https://api.example.com/v1/auth/register/personal-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/auth/register/personal-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'onboardingId' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'dateOfBirth' => '<string>',
'countryOfNationality' => '<string>',
'ssn' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/auth/register/personal-details"
payload := strings.NewReader("{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/auth/register/personal-details")
.header("Content-Type", "application/json")
.body("{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/auth/register/personal-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"onboardingId": "<string>",
"user": {}
}Authentication
Update Personal Details
Submit personal information for KYC verification during registration
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>"
}
'import requests
url = "https://api.example.com/v1/auth/register/personal-details"
payload = {
"onboardingId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"dateOfBirth": "<string>",
"countryOfNationality": "<string>",
"ssn": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
onboardingId: '<string>',
firstName: '<string>',
lastName: '<string>',
dateOfBirth: '<string>',
countryOfNationality: '<string>',
ssn: '<string>'
})
};
fetch('https://api.example.com/v1/auth/register/personal-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/auth/register/personal-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'onboardingId' => '<string>',
'firstName' => '<string>',
'lastName' => '<string>',
'dateOfBirth' => '<string>',
'countryOfNationality' => '<string>',
'ssn' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/auth/register/personal-details"
payload := strings.NewReader("{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/auth/register/personal-details")
.header("Content-Type", "application/json")
.body("{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/auth/register/personal-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"onboardingId\": \"<string>\",\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"dateOfBirth\": \"<string>\",\n \"countryOfNationality\": \"<string>\",\n \"ssn\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"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
string
required
Onboarding ID from previous stepExample:
US_100a99cf-f4d3-4fa1-c123-2e9833440ebbstring
required
User’s first nameExample:
Johnstring
required
User’s last nameExample:
Doestring
required
Date of birthFormat: YYYY-MM-DDExample:
1990-01-01string
required
Country of nationalityFormat: ISO 3166-1 alpha-2 codeExample:
GBstring
Social Security NumberRequired only if:
countryOfResidence = USExample: 123456789Response
string
Updated onboarding ID
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
Was this page helpful?
⌘I