# 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","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"}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.alignlabs.dev/align-api/customers/update-customer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.