curl --request PUT \
--url https://api-staging.stablestack.xyz/api/business-customers/{customerId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_type": "business",
"business_name": "Example Enterprises",
"business_type": "LIMITED_LIABILITY_COMPANY",
"business_website": "https://example.com",
"email": "contact@example.com",
"phone": "+14155552671",
"account_purpose": "OPERATING_A_COMPANY",
"source_of_funds": "SALES_OF_GOODS_AND_SERVICES",
"expected_monthly_income": 5000000,
"industry": "541512",
"registered_address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"trading_name": "Example Trading Co",
"nature_of_business": "Online retail and e-commerce platform specializing in consumer electronics",
"contact_person_email": "ceo@example.com",
"contact_person_phone": "+2347918945669",
"estimated_annual_revenue_usd": "HUNDRED_THOUSAND_TO_MILLION",
"operates_in_prohibited_countries": false,
"is_dao": false,
"registration_number": "REG123456789",
"registration_date": "2020-01-15",
"tax_identification_number": "TIN123456789",
"phone_country_code": "+234",
"conducts_money_services": false,
"account_purpose_explanation": "To facilitate international payments for our e-commerce business and manage supplier relationships",
"expected_monthly_payments_usd": 10000,
"business_owners": [
{
"first_name": "Jane",
"last_name": "Smith",
"email": "jane.smith@example.com",
"phone_number": "+2348918945670",
"date_of_birth": "1985-03-20",
"relationship_establishment_date": "2020-01-15",
"ownership_percentage": 25.5,
"is_control_person": false,
"is_signer": false,
"is_beneficial_owner": false,
"title": "Chief Executive Officer",
"address": {
"street1": "789 Owner Ave",
"street2": "Apt 123",
"city": "TX",
"state": "LA",
"postal_code": "214578",
"country": "US"
},
"id_number": "ID123456789",
"nationality": "NG",
"front_image": "https://example.com/id-front.jpg",
"back_image": "https://example.com/id-back.jpg",
"supporting_documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}
],
"documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}'
{
"status": "success",
"data": {
"id": "e927caad-9576-40d8-b87d-ace687afa82a",
"customer_type": "business",
"email": "contact@example.com",
"phone": "+2347918945668",
"created_at": "2025-05-09T16:33:21.902Z",
"updated_at": "2025-05-09T16:33:21.902Z",
"status": "active",
"address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"financial_info": {
"account_purpose": "business operations",
"expected_monthly_income": "5000000.00",
"source_of_funds": "business revenue"
},
"business_info": {
"business_name": "Example Enterprises",
"business_type": "Retail",
"business_website": "https://example.com"
}
}
}
API reference for updating business customer information
curl --request PUT \
--url https://api-staging.stablestack.xyz/api/business-customers/{customerId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_type": "business",
"business_name": "Example Enterprises",
"business_type": "LIMITED_LIABILITY_COMPANY",
"business_website": "https://example.com",
"email": "contact@example.com",
"phone": "+14155552671",
"account_purpose": "OPERATING_A_COMPANY",
"source_of_funds": "SALES_OF_GOODS_AND_SERVICES",
"expected_monthly_income": 5000000,
"industry": "541512",
"registered_address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"trading_name": "Example Trading Co",
"nature_of_business": "Online retail and e-commerce platform specializing in consumer electronics",
"contact_person_email": "ceo@example.com",
"contact_person_phone": "+2347918945669",
"estimated_annual_revenue_usd": "HUNDRED_THOUSAND_TO_MILLION",
"operates_in_prohibited_countries": false,
"is_dao": false,
"registration_number": "REG123456789",
"registration_date": "2020-01-15",
"tax_identification_number": "TIN123456789",
"phone_country_code": "+234",
"conducts_money_services": false,
"account_purpose_explanation": "To facilitate international payments for our e-commerce business and manage supplier relationships",
"expected_monthly_payments_usd": 10000,
"business_owners": [
{
"first_name": "Jane",
"last_name": "Smith",
"email": "jane.smith@example.com",
"phone_number": "+2348918945670",
"date_of_birth": "1985-03-20",
"relationship_establishment_date": "2020-01-15",
"ownership_percentage": 25.5,
"is_control_person": false,
"is_signer": false,
"is_beneficial_owner": false,
"title": "Chief Executive Officer",
"address": {
"street1": "789 Owner Ave",
"street2": "Apt 123",
"city": "TX",
"state": "LA",
"postal_code": "214578",
"country": "US"
},
"id_number": "ID123456789",
"nationality": "NG",
"front_image": "https://example.com/id-front.jpg",
"back_image": "https://example.com/id-back.jpg",
"supporting_documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}
],
"documents": [
{
"doc_type": "valid_ids",
"sub_type": "front",
"doc_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
"doc_country": "NG"
}
]
}'
{
"status": "success",
"data": {
"id": "e927caad-9576-40d8-b87d-ace687afa82a",
"customer_type": "business",
"email": "contact@example.com",
"phone": "+2347918945668",
"created_at": "2025-05-09T16:33:21.902Z",
"updated_at": "2025-05-09T16:33:21.902Z",
"status": "active",
"address": {
"street1": "123 Main St",
"street2": "Suite 456",
"city": "Lagos",
"state": "DE",
"postal_code": "214578",
"country": "NG"
},
"financial_info": {
"account_purpose": "business operations",
"expected_monthly_income": "5000000.00",
"source_of_funds": "business revenue"
},
"business_info": {
"business_name": "Example Enterprises",
"business_type": "Retail",
"business_website": "https://example.com"
}
}
}
customerId
(path, required): The ID of the business customer to update{
"customer_type": "business",
"business_name": "Updated Enterprises",
"business_type": "Wholesale",
"business_website": "https://updated.example.com",
"email": "updated@example.com",
"phone": "+2347918945668",
"account_purpose": "business expansion",
"source_of_funds": "business revenue",
"expected_monthly_income": 7000000,
"address": {
"line_1": "456 Business Ave",
"line_2": "Suite 789",
"city": "Lagos",
"state": "Lagos",
"postal_code": "100001",
"country": "Nigeria"
}
}
OK
The response is of type object
.