> For the complete documentation index, see [llms.txt](https://docs.alignlabs.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alignlabs.dev/align-api/customers/update-customer.md).

# Update Customer

## PUT /v0/customers/{customer\_id}

> Update customer data

```json
{"openapi":"3.0.0","info":{"title":"Customers API","version":"0"},"servers":[{"url":"https://api.alignlabs.dev","description":"Production server"},{"url":"https://api-sandbox.alignlabs.dev","description":"Sandbox server"}],"paths":{"/v0/customers/{customer_id}":{"put":{"summary":"Update customer data","parameters":[{"name":"customer_id","in":"path","description":"The unique identifier of the customer","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Api-Key","in":"header","description":"Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","oneOf":[{"title":"Individual Customer","properties":{"account_purpose":{"type":"string","enum":["charitable_donations","ecommerce_retail_payments","investment_purposes","other","payments_to_friends_or_family_abroad","payroll","personal_or_living_expenses","protect_wealth","purchase_goods_and_services","receive_payments_for_goods_and_services","third_party_money_transmission","treasury_management"],"description":"The purpose of the account"},"account_purpose_other":{"type":"string","maxLength":1024,"description":"Description when account_purpose is other"},"acting_as_intermediary":{"type":"boolean","description":"Whether the customer is acting as an intermediary"},"expected_monthly_volume_usd":{"type":"string","maxLength":50,"description":"Expected monthly volume in USD"},"source_of_funds_description":{"type":"string","maxLength":2000,"description":"Description of the source of funds"},"external_kyc_provider_data":{"type":"object","properties":{"sumsub_share_kyc_token":{"type":"string","maxLength":512,"description":"SumSub share KYC token"}}},"documents":{"type":"array","maxItems":20,"items":{"type":"object","required":["file_id"],"properties":{"file_id":{"type":"string","maxLength":256,"description":"The ID of the uploaded file"},"purpose":{"type":"string","enum":["id_document","proof_of_address","proof_of_source_of_funds","other"],"description":"The purpose/type of the document"},"doc_side":{"type":"string","enum":["front","back"],"description":"The side of the document"},"description":{"type":"string","maxLength":1024,"description":"Optional description of the document"}}}},"first_name":{"type":"string","maxLength":128,"description":"First name of the individual"},"middle_name":{"type":"string","maxLength":128,"description":"Middle name of the individual"},"last_name":{"type":"string","maxLength":128,"description":"Last name of the individual"},"nationality":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Nationality of the individual (ISO 3166-1 alpha-2 country code)"},"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","maxLength":10,"description":"Birth date of the individual (YYYY-MM-DD format)"},"birth_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Birth country of the individual (ISO 3166-1 alpha-2 country code)"},"most_recent_occupation":{"type":"string","maxLength":256,"description":"Most recent occupation of the individual"},"employment_status":{"type":"string","enum":["employed","homemaker","retired","self_employed","student","unemployed"],"description":"Employment status of the individual"},"residential_address":{"type":"object","required":["street_line_1","city","country","postal_code"],"properties":{"street_line_1":{"type":"string","maxLength":256,"description":"Street address line 1"},"street_line_2":{"type":"string","maxLength":256,"description":"Street address line 2"},"city":{"type":"string","maxLength":128,"description":"City"},"country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country (ISO 3166-1 alpha-2 country code)"},"postal_code":{"type":"string","maxLength":20,"description":"Postal code"},"state":{"type":"string","maxLength":128,"description":"State or province"}}},"identifying_information":{"type":"object","properties":{"id_document":{"type":"object","required":["number","type","issuing_country"],"properties":{"number":{"type":"string","maxLength":64,"description":"Identification document number"},"type":{"type":"string","enum":["passport","driver_license","residence_permit","government_id","state_or_provincial_id"],"description":"Type of identification document"},"issuing_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country that issued the identification document (ISO 3166-1 alpha-2 country code)"}}},"tax_number":{"type":"object","required":["number","issuing_country"],"properties":{"number":{"type":"string","maxLength":64,"description":"Tax identification number"},"type":{"type":"string","maxLength":64,"description":"Type of tax number (e.g., ssn, tin,)"},"issuing_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country that issued the tax number (ISO 3166-1 alpha-2 country code)"}}}}}}},{"title":"Business Customer","properties":{"account_purpose":{"type":"string","enum":["charitable_donations","ecommerce_retail_payments","investment_purposes","other","payments_to_friends_or_family_abroad","payroll","personal_or_living_expenses","protect_wealth","purchase_goods_and_services","receive_payments_for_goods_and_services","third_party_money_transmission","treasury_management"],"description":"The purpose of the account"},"account_purpose_other":{"type":"string","maxLength":1024,"description":"Description when account_purpose is other"},"acting_as_intermediary":{"type":"boolean","description":"Whether the customer is acting as an intermediary"},"expected_monthly_volume_usd":{"type":"string","maxLength":50,"description":"Expected monthly volume in USD"},"source_of_funds_description":{"type":"string","maxLength":2000,"description":"Description of the source of funds"},"external_kyc_provider_data":{"type":"object","properties":{"sumsub_share_kyc_token":{"type":"string","maxLength":512,"description":"SumSub share KYC token"}}},"documents":{"type":"array","maxItems":20,"items":{"type":"object","required":["file_id"],"properties":{"file_id":{"type":"string","maxLength":256,"description":"The ID of the uploaded file"},"purpose":{"type":"string","enum":["proof_of_address","proof_of_source_of_funds","business_formation","directors_registry","shareholder_registry","proof_of_nature_of_business","financial_statements","memorandum_articles_of_incorporation","other"],"description":"The purpose/type of the document"},"doc_side":{"type":"string","enum":["front","back"],"description":"The side of the document"},"description":{"type":"string","maxLength":1024,"description":"Optional description of the document"}}}},"business_legal_name":{"type":"string","maxLength":256,"description":"Legal name of the business"},"registration_number":{"type":"string","maxLength":1024,"description":"Business registration number"},"tax_number":{"type":"string","maxLength":1024,"description":"Business tax identification number"},"primary_website":{"type":"string","maxLength":512,"description":"Primary website of the business"},"formation_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","maxLength":10,"description":"Formation date of the business (YYYY-MM-DD format)"},"business_description":{"type":"string","maxLength":2000,"description":"Description of the business"},"business_address":{"type":"object","required":["street_line_1","city","country","postal_code"],"properties":{"street_line_1":{"type":"string","maxLength":256,"description":"Street address line 1"},"street_line_2":{"type":"string","maxLength":256,"description":"Street address line 2"},"city":{"type":"string","maxLength":128,"description":"City"},"country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country (ISO 3166-1 alpha-2 country code)"},"postal_code":{"type":"string","maxLength":20,"description":"Postal code"},"state":{"type":"string","maxLength":128,"description":"State or province"}}},"associated_persons":{"type":"array","maxItems":20,"items":{"type":"object","required":["first_name","last_name"],"properties":{"first_name":{"type":"string","maxLength":128,"description":"First name of the associated person"},"middle_name":{"type":"string","maxLength":128,"description":"Middle name of the associated person"},"last_name":{"type":"string","maxLength":128,"description":"Last name of the associated person"},"nationality":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Nationality of the associated person (ISO 3166-1 alpha-2 country code)"},"birth_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Birth country of the associated person (ISO 3166-1 alpha-2 country code)"},"has_ownership":{"type":"boolean","description":"Whether the person has ownership"},"has_control":{"type":"boolean","description":"Whether the person has control"},"ownership_percentage":{"type":"string","maxLength":10,"description":"Ownership percentage"},"identifying_information":{"type":"object","properties":{"id_document":{"type":"object","required":["number","type","issuing_country"],"properties":{"number":{"type":"string","maxLength":64,"description":"Identification document number"},"type":{"type":"string","enum":["passport","driver_license","residence_permit","government_id","state_or_provincial_id"],"description":"Type of identification document"},"issuing_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country that issued the identification document (ISO 3166-1 alpha-2 country code)"}}},"tax_number":{"type":"object","required":["number","issuing_country"],"properties":{"number":{"type":"string","maxLength":64,"description":"Tax identification number"},"issuing_country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country that issued the tax number (ISO 3166-1 alpha-2 country code)"}}}}},"documents":{"type":"array","maxItems":10,"items":{"type":"object","required":["file_id","purpose"],"properties":{"file_id":{"type":"string","maxLength":256,"description":"The ID of the uploaded file"},"purpose":{"type":"string","enum":["proof_of_address","id_document"],"description":"The purpose/type of the document"},"doc_side":{"type":"string","enum":["front","back"],"description":"The side of the document"},"description":{"type":"string","maxLength":1024,"description":"Optional description of the document"}}}},"residential_address":{"type":"object","required":["street_line_1","city","country","postal_code"],"properties":{"street_line_1":{"type":"string","maxLength":256,"description":"Street address line 1"},"street_line_2":{"type":"string","maxLength":256,"description":"Street address line 2"},"city":{"type":"string","maxLength":128,"description":"City"},"country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Country (ISO 3166-1 alpha-2 country code)"},"postal_code":{"type":"string","maxLength":20,"description":"Postal code"},"state":{"type":"string","maxLength":128,"description":"State or province"}}}}}}}}]}}}},"responses":{"200":{"description":"Successful update of customer data"}}}}}}
```