Consulta sociedades (participação em empresas)
curl --request POST \
--url https://api.jusfy.dev/calculators/api/consultas/sociedades \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"document": "12345678909"
}
'import requests
url = "https://api.jusfy.dev/calculators/api/consultas/sociedades"
payload = { "document": "12345678909" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({document: '12345678909'})
};
fetch('https://api.jusfy.dev/calculators/api/consultas/sociedades', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jusfy.dev/calculators/api/consultas/sociedades",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document' => '12345678909'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"statusCode": 200,
"message": "Consulta concluída com sucesso",
"timestamp": "2026-07-28T18:00:00.000Z",
"path": "/api/consultas/sociedades",
"result": [
{
"RelatedEntityTaxIdNumber": "11222333000181",
"RelatedEntityTaxIdType": "CNPJ",
"RelatedEntityTaxIdCountry": "Brazil",
"RelatedEntityName": "MINERACAO SERRA AZUL LTDA",
"RelationshipName": "SOCIO-ADMINISTRADOR",
"RelationshipType": "OWNERSHIP",
"RelationshipSubtype": "ADMINISTRATIVE OWNER",
"RelationshipLevel": "DIRECT",
"RelationshipStartDate": "2005-08-26T00:00:00Z",
"RelationshipEndDate": "9999-12-31T23:59:59.9999999",
"IsCurrentlyActive": true,
"IsFromHeadQuartersData": false,
"CreationDate": "2017-01-01T00:00:00Z",
"LastUpdateDate": "2026-07-11T00:00:00Z",
"AdditionalDetails": {}
},
{
"RelatedEntityTaxIdNumber": "44555666000199",
"RelatedEntityTaxIdType": "CNPJ",
"RelatedEntityTaxIdCountry": "Brazil",
"RelatedEntityName": "MARIA DE SOUZA 52998224725",
"RelationshipName": "OWNER",
"RelationshipType": "OWNERSHIP",
"RelationshipSubtype": "OWNER",
"RelationshipLevel": "DIRECT",
"RelationshipStartDate": "2021-08-11T00:00:00Z",
"RelationshipEndDate": "2025-12-13T00:00:00Z",
"IsCurrentlyActive": false,
"IsFromHeadQuartersData": false,
"CreationDate": "2021-08-11T00:00:00Z",
"LastUpdateDate": "2025-12-13T00:00:00Z",
"AdditionalDetails": {}
}
]
}Consultas
Consulta sociedades (participação em empresas)
Retorna as empresas em que o titular do CPF é sócio a partir do CPF — CNPJ, razão social, papel na sociedade e período do vínculo.
POST
/
api
/
consultas
/
sociedades
Consulta sociedades (participação em empresas)
curl --request POST \
--url https://api.jusfy.dev/calculators/api/consultas/sociedades \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"document": "12345678909"
}
'import requests
url = "https://api.jusfy.dev/calculators/api/consultas/sociedades"
payload = { "document": "12345678909" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({document: '12345678909'})
};
fetch('https://api.jusfy.dev/calculators/api/consultas/sociedades', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.jusfy.dev/calculators/api/consultas/sociedades",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document' => '12345678909'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"statusCode": 200,
"message": "Consulta concluída com sucesso",
"timestamp": "2026-07-28T18:00:00.000Z",
"path": "/api/consultas/sociedades",
"result": [
{
"RelatedEntityTaxIdNumber": "11222333000181",
"RelatedEntityTaxIdType": "CNPJ",
"RelatedEntityTaxIdCountry": "Brazil",
"RelatedEntityName": "MINERACAO SERRA AZUL LTDA",
"RelationshipName": "SOCIO-ADMINISTRADOR",
"RelationshipType": "OWNERSHIP",
"RelationshipSubtype": "ADMINISTRATIVE OWNER",
"RelationshipLevel": "DIRECT",
"RelationshipStartDate": "2005-08-26T00:00:00Z",
"RelationshipEndDate": "9999-12-31T23:59:59.9999999",
"IsCurrentlyActive": true,
"IsFromHeadQuartersData": false,
"CreationDate": "2017-01-01T00:00:00Z",
"LastUpdateDate": "2026-07-11T00:00:00Z",
"AdditionalDetails": {}
},
{
"RelatedEntityTaxIdNumber": "44555666000199",
"RelatedEntityTaxIdType": "CNPJ",
"RelatedEntityTaxIdCountry": "Brazil",
"RelatedEntityName": "MARIA DE SOUZA 52998224725",
"RelationshipName": "OWNER",
"RelationshipType": "OWNERSHIP",
"RelationshipSubtype": "OWNER",
"RelationshipLevel": "DIRECT",
"RelationshipStartDate": "2021-08-11T00:00:00Z",
"RelationshipEndDate": "2025-12-13T00:00:00Z",
"IsCurrentlyActive": false,
"IsFromHeadQuartersData": false,
"CreationDate": "2021-08-11T00:00:00Z",
"LastUpdateDate": "2025-12-13T00:00:00Z",
"AdditionalDetails": {}
}
]
}Autorizações
Corpo
application/json
CPF do titular, com ou sem máscara. Separadores são aceitos e ignorados. O dígito verificador é validado antes da consulta.
Exemplo:
"12345678909"
Resposta
Sociedades do CPF informado. O resultado é um array, com um item por empresa, e traz apenas vínculos societários — RelationshipName é SOCIO, OWNER ou SOCIO-ADMINISTRADOR. Vínculo vigente é o que tem IsCurrentlyActive: true — não usar RelationshipEndDate para isso, que no vínculo ativo vem com a sentinela 9999-12-31T23:59:59.9999999. Em MEI, RelatedEntityName é o nome e o CPF do próprio titular. Os campos usam os nomes do provedor e são repassados sem transformação.
The response is of type object.