PUT
/
business-customers
/
{customerId}
Update business customer
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"
    }
  }
}
Updates the information of an existing business customer.

Request Parameters:

  • customerId (path, required): The ID of the business customer to update

Request Body:

{
  "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"
  }
}

Headers

x-api-key
string
required

Path Parameters

customerId
string
required

Body

application/json

Response

200 - application/json

OK

The response is of type object.