curl --request PUT \
--url https://api-staging.stablestack.xyz/api/individual-customers/{customerId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_type": "individual",
"first_name": "John",
"middle_name": "Oluwaseun",
"last_name": "Ola",
"email": "olajohn3@gmail.com",
"phone": "+2348918945668",
"birth_date": "1990-01-15",
"account_purpose": "PERSONAL_OR_LIVING_EXPENSES",
"employment_status": "EMPLOYED",
"expected_monthly_income": 500000,
"most_recent_occupation": "151211",
"source_of_funds": "SALARY",
"registered_address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"phone_country_code": "+234",
"account_purpose_explanation": "To save money for future investments and handle personal international transactions",
"expected_monthly_payments_usd": 1000,
"acting_as_intermediary": false,
"tax_identification_number": "TIN987654321",
"documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}'
{
"status": "success",
"data": {
"id": "11a3c37f-06bb-4e7c-9813-0e47d47e9e2d",
"customer_type": "individual",
"email": "olajohn3@gmail.com",
"phone": "+2348918945668",
"created_at": "2025-05-09T16:33:57.844Z",
"updated_at": "2025-05-09T16:33:57.844Z",
"status": "active",
"address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"personal_info": {
"first_name": "john",
"middle_name": "Oluwaseun",
"last_name": "ola",
"birth_date": "1990-01-14T23:00:00.000Z"
},
"financial_info": {
"account_purpose": "personal savings",
"employment_status": "employed",
"expected_monthly_income": "500000.00",
"most_recent_occupation": "Software Engineer",
"source_of_funds": "salary"
}
}
}
API reference for updating individual customer information
curl --request PUT \
--url https://api-staging.stablestack.xyz/api/individual-customers/{customerId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_type": "individual",
"first_name": "John",
"middle_name": "Oluwaseun",
"last_name": "Ola",
"email": "olajohn3@gmail.com",
"phone": "+2348918945668",
"birth_date": "1990-01-15",
"account_purpose": "PERSONAL_OR_LIVING_EXPENSES",
"employment_status": "EMPLOYED",
"expected_monthly_income": 500000,
"most_recent_occupation": "151211",
"source_of_funds": "SALARY",
"registered_address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"phone_country_code": "+234",
"account_purpose_explanation": "To save money for future investments and handle personal international transactions",
"expected_monthly_payments_usd": 1000,
"acting_as_intermediary": false,
"tax_identification_number": "TIN987654321",
"documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}'
{
"status": "success",
"data": {
"id": "11a3c37f-06bb-4e7c-9813-0e47d47e9e2d",
"customer_type": "individual",
"email": "olajohn3@gmail.com",
"phone": "+2348918945668",
"created_at": "2025-05-09T16:33:57.844Z",
"updated_at": "2025-05-09T16:33:57.844Z",
"status": "active",
"address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"personal_info": {
"first_name": "john",
"middle_name": "Oluwaseun",
"last_name": "ola",
"birth_date": "1990-01-14T23:00:00.000Z"
},
"financial_info": {
"account_purpose": "personal savings",
"employment_status": "employed",
"expected_monthly_income": "500000.00",
"most_recent_occupation": "Software Engineer",
"source_of_funds": "salary"
}
}
}
customerId
(path, required): The ID of the individual customer to update{
"customer_type": "individual",
"first_name": "Updated",
"middle_name": "Oluwaseun",
"last_name": "Ola",
"email": "updated@gmail.com",
"phone": "+2348918945668",
"birth_date": "1990-01-15",
"account_purpose": "personal investment",
"employment_status": "self-employed",
"expected_monthly_income": 750000,
"most_recent_occupation": "Senior Software Engineer",
"source_of_funds": "business income",
"address": {
"line_1": "456 Main St",
"line_2": "Apt 101",
"city": "Lagos",
"state": "Lagos",
"postal_code": "100001",
"country": "Nigeria"
}
}
OK
The response is of type object
.