# Brazil Brazil eKYB validates the legitimacy of Brazilian businesses by checking their tax ID, business name, address, and UBOs against the Brazilian government CNPJ database. Directors are not currently supported for Brazil. ## Source | Country | Source | Description | | ------- | ---------------------------------- | ------------------------------------------------------------------------------------ | | Brazil | Brazilian government CNPJ database | Verifies submitted business details against records maintained in the CNPJ registry. | ## Direct API approach For general integration notes and shared response semantics, see the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference). ### Request parameters | Parameter | Required | Description | | -------------- | --------- | ------------------------------------------------------------------------------------------------------ | | `plugins` | Mandatory | Array. Must be `["ekyb"]`. | | `businessName` | Mandatory | String. Name of the business. | | `country` | Mandatory | String. Two-letter Alpha-2 country code. Must be `BR`. | | `taxId` | Mandatory | String. CNPJ (14 digits, usually written as `12.345.678/9012-34`). | | `street` | Optional | String. Street name of the business. | | `houseNo` | Optional | String. Building or house number. | | `addressLine2` | Optional | String. Second line of the business address. | | `city` | Optional | String. City in the business address. | | `state` | Optional | String. State in the business address. | | `postalCode` | Optional | String. 8-digit Brazilian postal code. | | `uboNames` | Optional | Array. Full legal names of Unique Beneficial Owners to check against records associated with the CNPJ. | ### Sample request ```json { "plugins": ["ekyb"], "businessName": "RENATA DISTR. DE SUPLEMENTOS LTDA", "street": "Rua Curupaiti", "houseNo": "225", "city": "Rio de Janeiro", "state": "RJ", "postalCode": "20735320", "country": "BR", "taxId": "41111051548164", "uboNames": ["MICHEL RODRIGUES", "ERIC SANTOS", "MICHELLE MUNHOZ"] } ``` ### Sample response ```json { "kyb": [ { "key": "name", "sub_label": "Verified" }, { "key": "tin", "sub_label": "Verified" }, { "key": "address_verification", "sub_label": "Verified" }, { "key": "cityMatch", "sub_label": "Verified" }, { "key": "postalCodeMatch", "sub_label": "Verified" }, { "key": "registrationStatus", "sub_label": "Active" }, { "key": "entityType", "entityType": { "entityType": "Sociedade Empresária Limitada" } }, { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "MICHEL RODRIGUES", "nameId_match": "2" }, { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "ERIC SANTOS", "nameId_match": "1" }, { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "MICHELLE MUNHOZ", "nameId_match": "-1" } ], "kybSource": { "uboNames": [ { "id": "1", "uboName": "ERIC SANTOS" }, { "id": "2", "uboName": "MICHEL RODRIGUES" } ] } } ``` The `nameId_match` value on each `ubo_name_match` entry correlates to the `id` in the `kybSource.uboNames` array. A `nameId_match` of `-1` indicates no match to any UBO in the source of truth. ### Response fields | Key | Status | Description | | ---------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `name` | `Verified`, `Approximate Match`, `Unverified` | Submitted business name against the business name associated with the CNPJ. | | `tin` | `Verified`, `Unverified` | Submitted CNPJ against the government CNPJ database. | | `address_verification` | `Verified`, `Approximate Match`, `Unverified` | Submitted address against the address associated with the CNPJ. | | `cityMatch` | `Verified`, `Approximate Match`, `Unverified` | Submitted city against the city associated with the CNPJ. | | `postalCodeMatch` | `Verified`, `Unverified` | Submitted postal code against the postal code associated with the CNPJ. | | `registrationStatus` | `Active`, `Suspended`, `Null`, `Unfit`, `Written off`, `Unknown` | Registration status of the business in the CNPJ database. See [Registration status values](#registration-status-values) for definitions. | | `entityType` | Legal entity type of the business | The legal entity type of the company, if available. If not available, displays `Unknown`. | | `ubo_name_match` | `Verified`, `Approximate Match`, `Unverified` | Submitted UBO against UBOs associated with the CNPJ. Distinguished by the `uboName_input` field on each entry. | | `kybSource.uboNames` | Array of UBO records | Full list of UBOs stored in the CNPJ database for the business. | ### Registration status values | Status | Description | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Active | The CNPJ is active. | | Suspended | The company did not comply with tax obligations, presented data issues to the Federal Revenue Service, or is under investigation for possible fraud. | | Null | The CNPJ is invalid, typically due to registration problems in other instances such as a duplicate State Registration. | | Unfit | Tax irregularity or omission of company tax information caused the Federal Revenue Service to reclassify the CNPJ as Unfit until regularization is made. | | Written off | The Federal Revenue Service considers the company written off or cancelled. This can occur due to closure of the company's activities, serious tax irregularities, failure to submit mandatory declarations, or voluntary request for dismissal by the company itself. | | Unknown | Registration status is not available. | ### Address `unabletoverify` note Address-based fields on Brazil eKYB may return `unabletoverify` for `taxIdStateMatch`, `taxIdAddressMatch`, `taxIdCityMatch`, and `taxIdPostalCodeMatch`. This is because addresses are validated through the driver's license (CNH) Brazilian government source of truth. If the individual associated with the business does not have a CNH on file, address components cannot be validated. ### Reason codes The following reason codes may appear on Brazil eKYB responses: | Reason Code | Description | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | ASDL | Unable to verify address because CPF consulted does not have a CNH in the official government database. | | TSRF | Tax ID Status (situação CPF) is not regular. It is suspended or canceled due to pending regularization, being null, or the holder being deceased. | | TSR | Tax ID Status (situação CPF) is regular. | | TSRP | Tax ID Status is pending regularization. | | TNPIN | Tax ID check was not performed due to invalid nationality. | | TLGPD | Tax ID check was not performed due to LGPD: minor's data. | | ASCV | State and country validated. | ### Error responses See the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference) for standard error responses. ## Single Session Dashboard results View eKYB results on the Business tab in [single Session view](https://developer.incode.com/docs/single-session-view).