---
title: "Update account information and upload documents"
method: PATCH
path: "/v2/accounts/{account_id}/kyc"
tags: ["Onboard accounts"]
---

# Update account information and upload documents

`PATCH /v2/accounts/{account_id}/kyc`

This service is responsible for updating KYC information for an account and uploading its documents.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `body` object — Send the fields you need to update with the updated information.
    - `consents` object[]
      - `type` string — The type of consent collected. <br><br>Possible values: `DATA_COLLECTION`, `TERMS_AND_CONDITIONS`, `CONTRACTUAL_EFFECTS`, `DECLARATION_OF_FUNDS` or `PRIVACY_NOTICE`.
      - `name` string — Name of the person who filled data consent collection.
      - `accepted` boolean — If the terms and conditions is accepted or not.
    - `company_information` UpdateKYCInformation
      - `website` string, byte — Company’s website.
      - `registered_name` string, byte — Legal company name or owner’s legal name.
      - `date_of_incoporation` string, byte — Company’s date of registration (yyyy-MM-dd).
      - `annual_sales_in_usd` string, byte — Company’s expected annual sales.
      - `industry_code` string — Company’s industry code.<br><br>[See all the codes](https://docs.dlocal.com/docs/risk-data-documentation#industry-codes-list).
      - `phone` string — Business phone number.<br><br>Length: 20.
      - `is_so` boolean — ’Sujeto obligado’ refers to businesses supervised under the anti-money laundering or combating the Financing of Terrorism (AML/CFT) regulations, which require them to submit Suspicious Activity Report (SAR) and have other obligations under the AML/CFT regulation. Required in Argentina.
      - `is_pep` boolean — The definition of 'politically exposed person' (PEP) is an individual with a high profile political role, or who has been entrusted with a prominent public function.
      - `ip_address` string — Source IP address of the request. IPV4 or IPV6.
      - `legal_address` object
        - `country` string, byte — Company’s country of registration. ISO 3166-1 alpha-2 code.
        - `city` string, byte — Company’s address city of registration.
        - `zip_code` string, byte — Company’s address ZIP code of registration.
        - `address` string, byte — Company’s address of registration.
      - `legal_representative` UpdateLegalRepresentative
        - `document_type` string — Legal representative’s country document type. To see the document code list per country, go to the [Country Reference page](https://docs.dlocal.com/docs/country-requirements-payouts).
        - `document_number` string — Legal representative’s country document number. To see the document code list per country, go to the [Country Reference page](https://docs.dlocal.com/docs/country-requirements-payouts).
        - `document_expedition_date` string — Legal representative document expedition date (yyyy-MM-dd).
        - `name` string — Legal representative full name.
        - `nationality` string — Legal representative nationality.
        - `date_of_birth` string — Legal representative date of birth (yyyy-MM-dd).
        - `phone` string — Legal representative phone.
        - `email` string — Legal representative's email address.
        - `country` string — Legal representative’s country. ISO 3166-1 alpha-2 code.
        - `city` string, byte — Legal representative’s address city.
        - `zip_code` string — Legal representative’s address ZIP code.
        - `address` string — Legal representative address.
        - `is_pep` boolean — The definition of 'politically exposed person' (PEP) is an individual with a high profile political role, or who has been entrusted with a prominent public function.
        - `biometric_result` boolean — For KYC/KYB reliance with a third party, this field indicates whether the biometric data provided by the user was valid.
      - `ubos` Ubo[]
        - `tax_id` string — UBO's country tax number.
        - `document_type` string — UBO's country document type. To see the document code list per country, go to the [Country Reference page](https://docs.dlocal.com/docs/country-requirements-payouts).
        - `document_number` string — UBO's country document number. To see the document code list per country, go to the [Country Reference page](https://docs.dlocal.com/docs/country-requirements-payouts).
        - `document_expedition_date` string — UBO's document expedition date (yyyy-MM-dd).
        - `name` string — UBO's full name.
        - `nationality` string — UBO's nationality. ISO 3166-1 alpha-2 code.
        - `country` string — UBO's country. ISO 3166-1 alpha-2 code.
        - `city` string — UBO's address city.
        - `zip_code` string — UBO's address ZIP code.
        - `address` string — UBO's address.
        - `date_of_birth` string — UBO's date of birth (yyyy-MM-dd).
        - `phone` string — UBO's phone.
        - `email` string — UBO's email address.
        - `is_pep` boolean — The definition of 'politically exposed person' (PEP) is an individual with a high profile political role, or who has been entrusted with a prominent public function.
        - `ownership_percentage` number — UBO's ownership percentage.
  - `file` string[] — Upload and submit various documents required for KYC account validation. Each file name must include an extension, which can be either .jpeg, .png, or .pdf.<br><br>Please refer to the [list of acceptable files](https://docs.dlocal.com/reference/kyc-files-v2-platforms).

## Response `200`

OK

- ResponseUpdateAccount
  - `account_id` string — User’s dLocal account ID.
  - `account_external_reference` string, byte — ID given by the merchant in their system.
  - `account_email` string — Account's email address.
  - `status` string — Account status. [See details](https://docs.dlocal.com/docs/status-description-v2-platforms).
  - `status_code` number — Account status code. [See details](https://docs.dlocal.com/docs/status-description-v2-platforms).
  - `status_detail` string — Account status detail.
  - `creation_date` string, date — Bank account creation's timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
  - `last_updated` string, date-time — Account update timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
  - `platform_type` string, byte — Merchant Type, e.g. “MERCHANTNAME”. Each Marketplace will have one or more Merchant types, defined in the Platform account’s creation.</br></br>[See details](https://docs.dlocal.com/docs/onboarding-process-platforms#obtain-a-platform-account).
  - `account_country` string — Account's country code. ISO 3166-1 alpha-2 code.
  - `capabilities` object[]
    - `capability_name` string — Capability´s name. <br><br>Possible values: `PAYINS`, `PAYOUTS`, `SETTLEMENTS`, or `REFUNDS`.
    - `capability_status` string — Capability´s status. <br><br>Possible values: `ENABLED` or `DISABLED`.
    - `restrictions` object
      - `requested_by` string — Who requested the restriction. <br><br>Possible values: `BY_FRAUD`, `BY_LEGAL`, or `BY_ADMIN`.
      - `date` string, date — Date the restriction was applied (yyyy-MM-dd).
  - `consents` object[]
    - `type` string — The type of consent collected. <br><br>Possible values: `DATA_COLLECTION`, `TERMS_AND_CONDITIONS`, `CONTRACTUAL_EFFECTS`, `DECLARATION_OF_FUNDS` or `PRIVACY_NOTICE`.
    - `name` string — Name of the person who filled data consent collection.
    - `accepted` boolean — If the terms and conditions is accepted or not.
    - `updated_date` string, date-time — Terms and conditions updated date timestamp (YYYY-MM-DDTHH:mm:ss).

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/dlocal/apis/payins.md) · [All operations](https://skmtc.net/dlocal/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dlocal/payins/revisions/d87e090020f9/schema)