Update a customer
Update customer profile details. Non-verified customers can update all fields. Verified customers can only update fields that are currently null — if you need to correct a mistake on a verified customer (wrong document, misspelled name, incorrect details), you must request a manual correction from the Blaaiz operations team by emailing support@blaaiz.com. See the Customer data corrections guide for the full process. The customer’s country must match the country on the identity document submitted for KYC. Accepted identity documents: Driver’s License, Passport, or Resident Permit for individual customers, Certificate of Incorporation for business customers. ID cards (National Identity Cards) are not accepted. All uploaded documents must be clear, legible, and authentic — unclear images will be rejected. Fraudulent or falsified documents will result in the customer being permanently blacklisted from the platform. Required scope: customer:write.
Documentation Index
Fetch the complete documentation index at: https://docs.business.blaaiz.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
Path Parameters
Customer ID
Body
kyb_scope is read-only here. It cannot be modified through this endpoint — sending it returns 422. To upgrade a MINIMAL customer to FULL, use POST /customer/{id}/upgrade-kyb-scope. There is no downgrade path.
ISO alpha-2 country code of the registered address. For type=individual, must match the country on the identity document. For type=business, must equal incorporation_country (cross-field check at validation time). When changing the jurisdiction, send both country and incorporation_country together — sending only one leaves the other at its persisted value, which produces a divergence and 422.
Personal identity document type. Individual customers only. For business customers id_type is prohibited on update — businesses identify via registration_number + incorporation_country. Sending id_type on a business returns 422. ID cards (National Identity Cards) are not accepted. As with all verified-customer fields, an existing non-null value cannot be changed via this endpoint.
drivers_license, passport, resident_permit Personal identity document number. Individual customers only. For business customers id_number is prohibited on update — businesses identify via registration_number. Sending id_number on a business returns 422. Subject to the same verified-field-locking as other identity fields.
Tax identification number (varies by country). Where applicable, use the Get Identification Type endpoint to determine the correct label or field to collect for the customer's country and type.
Business operating address — street. Subject to verified-field-locking like other identity fields.
Business operating city.
Business operating state.
Business operating zip / postal code. Validated against operating_country. If you update only operating_zip_code, the persisted operating_country is used as the anchor.
Business operating address country, as ISO alpha-2. Anchors postal-code validation for operating_zip_code. Can differ from country and incorporation_country when the business operates from elsewhere.
Business KYB field.
Business KYB field. Legal entity type.
corporation, government_entity, llc, non_profit, other, partnership, sole_proprietorship Business KYB field. Unique per business: two of your customers cannot share the same (registration_number, incorporation_country) pair.
Business KYB field — legal jurisdiction of incorporation, as ISO alpha-2. Distinct from country (registered-address country) and operating_country (operating-address country); for businesses, country must equal incorporation_country.
Business KYB field.
Business KYB field.
Business KYB field.
Business KYB field.
Business KYB field.
business_revenue, business_loans, investment_income, third_party_funds, other Business KYB field. Estimated annual revenue band, in USD.
0_99999, 100000_499999, 500000_999999, 1000000_4999999, 5000000_24999999, 25000000_99999999, 100000000_249999999, 250000000_plus Business KYB field.
Business KYB field.
receive_payments_for_goods_and_services, send_payments_for_goods_and_services, send_receive_funds_related_parties, other Business KYB field. Manage beneficial owners with this array — include the owner's id to update an existing owner, omit id to create a new one. To delete an owner, use DELETE /api/external/customer/{customer}/owner/{owner}. Locked owners (status APPROVED or PROCESSING) cannot be edited and will return 400. The status and admin_comments fields are admin-managed; if you send them they are silently ignored. Rejected entirely if type=individual.
5