---
title: "Get account"
method: GET
path: "/v2/accounts/{account_id}"
tags: ["Account management"]
---

# Get account

`GET /v2/accounts/{account_id}`

## Request

- Base URL: `https://marketplace-api.dlocal.com`
- URL: `https://marketplace-api.dlocal.com/v2/accounts/{account_id}`
- 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 can be used to retrieve an account.

## Path parameters

- `account_id` string, required

## Response `200`

OK

- union
  - ResponseGetAccountCompany
    - `account_id` string: User’s dLocal account ID.
    - `account_external_reference` string, byte: ID given by the merchant in their system.
    - `status` string: Account status. <br><br> [See details](ref:status-description-v2-platforms#approved).
    - `status_code` number: Account status code. <br><br> [See details](ref:status-description-v2-platforms#approved).
    - `status_detail` string: Account status detail.
    - `creation_date` string, date: Account creation’s 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).
    - `tax_category` string: Type of tax category: company or individual. [See more information](doc:kyc-requirement-platforms).
    - `account_name` string, byte: Name to identify the account within dLocal system. Could be a fantasy name.
    - `account_email` string, byte: Account's email address.
    - `account_country` string: Account's country code. ISO 3166-1 alpha-2 code.
    - `notification_url` string, byte: URL where dLocal will send notifications associated to account status changes, Payins and Payouts.
    - `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).
    - `company_information` CompanyInformationCompany
      - `tax_id` string, required: Company country tax number.
      - `document_type` string: Company’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: Company’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: Company document expedition date (yyyy-MM-dd).
      - `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).
      - `email` string: Company’s email.
      - `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.
      - `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` LegalRepresentative
        - `tax_id` string: Legal representative country tax number.
        - `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’s full name.
        - `nationality` string: Legal representative’s nationality. ISO 3166-1 alpha-2 code.
        - `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.
    - `settings` Settings
      - `pricing_level` string: Represents the pricing configurations set in dLocal. For default: `smbs_1`, `smbs_2`, `mid_market`.
      - `settlement_period` number: Days in which the balance is available to settle.
      - `installments_responsible` string: An option is provided for the merchant to select who is responsible for paying the installments fees. The mechant is the seller and customer is the payer. <br><br> Possible values: `MERCHANT` or `CUSTOMER`.
      - `settlements` object[]: Days in which the balance is available to settle for the country and payment method code or ID. <br><br>**Note**: Parameter combinations must be agreed with the Technical Account Manager previously and will be in accordance with the commercial agreement.
        - `config_delay_days` number, required: Settlement period for the country and payment method (type or ID) combination.
        - `country_code` string: Country associated with the settlement. ISO 3166-1 alpha-2 code.
        - `payment_method_type` 'CARD' | 'TICKET' | 'BANK_TRANSFER' | 'WALLET': Type of payment method.<br><br>Possible values: `CARD`, `TICKET`, `BANK_TRANSFER`, or `WALLET`.<br><br>Must not be sent with `payment_method_id`.
        - `payment_method_id` string: ID of the payment method. See all the information related to each [payment method by country](doc:payment-method).<br><br>Must not be sent with `payment_method_type`.
  - ResponseGetAccountIndividual
    - `account_id` string: User’s dLocal account ID.
    - `status` string: Account status. <br><br> [See details](ref:status-description-v2-platforms#approved).
    - `status_code` number: Account status code. <br><br> [See details](ref:status-description-v2-platforms#approved).
    - `status_detail` string: Account status detail.
    - `creation_date` string, date: Account creation’s 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).
    - `tax_category` string: Type of tax category: company or individual. [See more information](doc:kyc-requirement-platforms).
    - `account_name` string, byte: Name to identify the account within dLocal system. Could be a fantasy name.
    - `account_email` string, byte: Account's email address.
    - `account_country` string: Account's country code. ISO 3166-1 alpha-2 code.
    - `account_external_reference` string, byte: ID given by the merchant in their system.
    - `notification_url` string, byte: URL where dLocal will send notifications associated to account status changes, Payins and Payouts.
    - `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).
    - `company_information` CompanyInformationIndividual
      - `tax_id` string, required: Individual country tax number.
      - `document_type` string: Individual’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: Individual’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: Individual document expedition date (yyyy-MM-dd).
      - `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).
      - `email` string: Company’s email.
      - `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.
    - `settings` Settings
      - `pricing_level` string: Represents the pricing configurations set in dLocal. For default: `smbs_1`, `smbs_2`, `mid_market`.
      - `settlement_period` number: Days in which the balance is available to settle.
      - `installments_responsible` string: An option is provided for the merchant to select who is responsible for paying the installments fees. The mechant is the seller and customer is the payer. <br><br> Possible values: `MERCHANT` or `CUSTOMER`.
      - `settlements` object[]: Days in which the balance is available to settle for the country and payment method code or ID. <br><br>**Note**: Parameter combinations must be agreed with the Technical Account Manager previously and will be in accordance with the commercial agreement.
        - `config_delay_days` number, required: Settlement period for the country and payment method (type or ID) combination.
        - `country_code` string: Country associated with the settlement. ISO 3166-1 alpha-2 code.
        - `payment_method_type` 'CARD' | 'TICKET' | 'BANK_TRANSFER' | 'WALLET': Type of payment method.<br><br>Possible values: `CARD`, `TICKET`, `BANK_TRANSFER`, or `WALLET`.<br><br>Must not be sent with `payment_method_id`.
        - `payment_method_id` string: ID of the payment method. See all the information related to each [payment method by country](doc:payment-method).<br><br>Must not be sent with `payment_method_type`.

## Other responses

- `404`: 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)