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

# Get account

`GET /v2/accounts/{account_id}`

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](https://docs.dlocal.com/reference/status-description-v2-platforms#approved).
    - `status_code` number — Account status code. <br><br> [See details](https://docs.dlocal.com/reference/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](https://docs.dlocal.com/docs/onboarding-process-platforms#obtain-a-platform-account).
    - `tax_category` string — Type of tax category: company or individual. [See more information](https://docs.dlocal.com/docs/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](https://docs.dlocal.com/docs/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](https://docs.dlocal.com/docs/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](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.
      - `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](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’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](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.
    - `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](https://docs.dlocal.com/docs/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](https://docs.dlocal.com/reference/status-description-v2-platforms#approved).
    - `status_code` number — Account status code. <br><br> [See details](https://docs.dlocal.com/reference/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](https://docs.dlocal.com/docs/onboarding-process-platforms#obtain-a-platform-account).
    - `tax_category` string — Type of tax category: company or individual. [See more information](https://docs.dlocal.com/docs/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](https://docs.dlocal.com/docs/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](https://docs.dlocal.com/docs/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](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.
    - `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](https://docs.dlocal.com/docs/payment-method).<br><br>Must not be sent with `payment_method_type`.

## Other responses

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