---
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`

## Request

- Base URL: `https://marketplace-api.dlocal.com`
- URL: `https://marketplace-api.dlocal.com/v2/accounts/{account_id}/kyc`
- Auth: API key in header `X-Date` and API key in header `X-Login` and API key in header `X-Trans-Key` and API key in header `X-Version` and API key in header `User-Agent` and API key in header `Authorization`

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](doc: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](doc: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](doc: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](doc: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](doc: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](ref: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](doc:status-description-v2-platforms).
  - `status_code` number: Account status code. [See details](doc: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](doc: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.dev/dlocal/apis/platforms.md) - [All operations](https://skmtc.dev/dlocal/apis/platforms/llms.txt) - [OpenAPI document](https://skmtc.dev/dlocal/apis/platforms/revisions/4be9adbbfce5?raw)