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.

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

{
  "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

{
  "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 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 for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.