UBO - Brazil

Description

This service retrieves corporate ownership and management information for Brazilian legal entities registered with the Cadastro Nacional da Pessoa Jurídica (CNPJ), using data sourced from Brazil's Receita Federal. The response includes the company's Quadro de Sócios e Administradores (QSA), which identifies shareholders, partners, administrators, and, where applicable, their legal representatives associated with the queried CNPJ.

This dataset is useful for KYB, onboarding, counterparty screening, corporate linkage analysis, and ownership structure verification.

HTTP method GET

Endpoint

https://apidev.msla-id.com/experience-company-ubos-api-v1/api/idv-govcheck/v1/br-identity/ubo/company/{cnpj}

info

This endpoint requires Bearer Token authentication. Contact IT support to get credentials.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	Bearer JWT token

Path parameter

NAME	REQUIRED	TYPE	DESCRIPTION
cnpj	✅	string	Company Tax ID number (unformatted, digits only)

Request example

GET /br-identity/ubo/company/01956548000190

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error

Response 200 status code

{
  "traceId": "abc123",
  "timestamp": "2026-06-09 10:00:00",
  "data": {
    "cnpj": "01.956.548/0001-90",
    "partners": [
      {
        "basicCnpj": "01956548",
        "partnerIdentifier": "Pessoa Física",
        "partnerName": "SILVIA BEATRIZ BEGER UCHOA",
        "partnerCnpjCpf": "***351791**",
        "partnerQualification": "Sócio",
        "entryDate": "20210422",
        "country": "",
        "legalRepresentative": "000000",
        "representativeName": "",
        "representativeQualification": "",
        "ageRange": "71 a 80 anos"
      },
      {
        "basicCnpj": "01956548",
        "partnerIdentifier": "Pessoa Física",
        "partnerName": "ALINE DE GOES LIMA AMARAL",
        "partnerCnpjCpf": "***918974**",
        "partnerQualification": "49",
        "entryDate": "20210422",
        "country": "",
        "legalRepresentative": "000000",
        "representativeName": "",
        "representativeQualification": "",
        "ageRange": "41 a 50 anos"
      },
      {
        "basicCnpj": "01956548",
        "partnerIdentifier": "Pessoa Física",
        "partnerName": "NADIA TERESINHA PAIM CORSO",
        "partnerCnpjCpf": "***596140**",
        "partnerQualification": "Sócio-Administrador",
        "entryDate": "19970709",
        "country": "",
        "legalRepresentative": "000000",
        "representativeName": "",
        "representativeQualification": "",
        "ageRange": "61 a 70 anos"
      },
      {
        "basicCnpj": "01956548",
        "partnerIdentifier": "Pessoa Física",
        "partnerName": "LAURA CORSO LUNARDI",
        "partnerCnpjCpf": "***948144**",
        "partnerQualification": "Sócio-Gerente",
        "entryDate": "20210422",
        "country": "",
        "legalRepresentative": "000000",
        "representativeName": "",
        "representativeQualification": "",
        "ageRange": "41 a 50 anos"
      }
    ]
  }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-4005",
    "message": "Bad request - Invalid parameters provided",
    "data": null
}

Response 401 status code

{
    "timestamp": "2025-03-16T11:20:46.000Z",
    "status": 401,
    "error": "Unauthorized",
    "message": "Bearer token is missing or invalid",
    "path": "/api/idv-govcheck/v1/br-identity/ubo/company/{cnpj}"
}

Response 404 status code

{
    "traceId": "7f3a1b22c9de4051",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-4040",
    "message": "No information found for the provided CNPJ",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}