UBO - Brazil

Description

The Brazil UBO solution leverages the Receita Federal (CNPJ API) and state-level registries like JUCESP to provide complete ownership and corporate history data.

It returns detailed shareholder information, participation percentages, and administrative roles.

HTTP method POST

Endpoint

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

info

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

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Content-Type	✅	string	application/json
Authorization	✅	string	Bearer JWT token

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
CNPJ	✅	string	Company Tax ID number

Request example

Brazil UBO

{
  "CNPJ": "61155687000100"
}

Status code responses

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

Response 200 status code

{
    "NIRE": 99999999999,
    "CNPJ": "12.345.678/0001-90",
    "Company_name": "NOVA TECNOLOGIA BRASIL S.A.",
    "Registered_address": "Av. Ficticia 1234, 10º Andar, São Paulo - SP, 01234-567",
    "Date_of_incorporation": "01-02-2018",
    "Registered_capital": "R$ 50,000,000.00",
    "Shareholder_data": [
        {
            "Names": "MARCOS SILVA",
            "Address": "10A RUA PIQUINHU 240, Vila Re, Sao Paulo",
            "Role": "Partner / Administrator",
            "Participation": "40.00%",
            "CPF/CNPJ": "123.456.789-00 (CPF)"
        },
        {
            "Names": "ATLANTIS HOLDINGS LLC",
            "Address": "RUA CENTERVILLE ROAD, SUITE 400, Texas, 26048, Exterior",
            "Role": "Corporate Partner",
            "Participation": "59.00%",
            "CPF/CNPJ": "12.345.678/0001-11 (CNPJ)"
        },
        {
            "Names": "ANA RODRIGUES",
            "Address": "10A RUA DR. HOMEM DE MELO 1180, Apt.43, Perdizes, Sao Paulo",
            "Role": "Partner",
            "Participation": "1.00%",
            "CPF/CNPJ": "987.654.321-99 (CPF)"
        }
    ]
}

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/ubos"
}

Response 500 status code

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