Get entity history
curl --request GET \
--url http://localhost:3000/v2/entities/{id}/history \
--header 'Authorization: Bearer <token>'import requests
url = "http://localhost:3000/v2/entities/{id}/history"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://localhost:3000/v2/entities/{id}/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/v2/entities/{id}/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:3000/v2/entities/{id}/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:3000/v2/entities/{id}/history")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/v2/entities/{id}/history")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"results": [
{
"sourceDataset": "quod",
"observedAt": "2026-05-08T12:30:00.000Z",
"object": "company",
"nameHistory": [
{
"changeDate": "2020-07-01T00:00:00Z",
"name": "BIGDATACORP S.A.",
"officialName": "BIGDATACORP S.A.",
"tradeName": "BIGDATACORP"
}
],
"taxRegimeHistory": [
{
"changeDate": "2022-02-01T00:00:00Z",
"taxRegime": "LUCRO REAL"
}
],
"taxIdStatusHistory": [
{
"changeDate": "2020-07-01T00:00:00Z",
"taxIdStatus": "ATIVA"
}
],
"cnaeHistory": [
{
"changeDate": "2023-04-01T00:00:00Z",
"code": "6201501",
"activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"docNumber": "",
"economicActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"economicActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"isMainEconomicActivity": true
}
],
"capitalHistory": [
{
"changeDate": "2024-11-01T00:00:00Z",
"capital": "8385000.00"
}
],
"currentName": "BIGDATACORP S.A.",
"age": 18,
"totalChanges": 12,
"nameTotalChanges": 2,
"taxRegimeTotalChanges": 3,
"taxIdStatusTotalChanges": 1,
"headquarterTotalChanges": 0,
"cnaeTotalChanges": 6,
"capitalTotalChanges": 3,
"lastDateChanged": "2023-04-01T00:00:00Z",
"lastNameChanged": "2022-02-01T00:00:00Z",
"lastLegalNatureChanged": "2020-07-01T00:00:00Z"
}
],
"has_more": true,
"metadata": {
"status": "NOT_QUERIED",
"provenance": {
"datasets": [
{
"datasetSlug": "<string>",
"requirement": "required",
"visible": true,
"onRefresh": true,
"sourcePriority": 123,
"status": "NOT_QUERIED",
"queryId": "<string>",
"observedAt": "<string>",
"recordedAt": "<string>",
"errorCode": "upstream_error"
}
]
},
"summary": "<string>"
},
"next_cursor": "<string>",
"type": "<string>"
}entities
Get entity history
GET
/
v2
/
entities
/
{id}
/
history
Get entity history
curl --request GET \
--url http://localhost:3000/v2/entities/{id}/history \
--header 'Authorization: Bearer <token>'import requests
url = "http://localhost:3000/v2/entities/{id}/history"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://localhost:3000/v2/entities/{id}/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/v2/entities/{id}/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:3000/v2/entities/{id}/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:3000/v2/entities/{id}/history")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/v2/entities/{id}/history")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"results": [
{
"sourceDataset": "quod",
"observedAt": "2026-05-08T12:30:00.000Z",
"object": "company",
"nameHistory": [
{
"changeDate": "2020-07-01T00:00:00Z",
"name": "BIGDATACORP S.A.",
"officialName": "BIGDATACORP S.A.",
"tradeName": "BIGDATACORP"
}
],
"taxRegimeHistory": [
{
"changeDate": "2022-02-01T00:00:00Z",
"taxRegime": "LUCRO REAL"
}
],
"taxIdStatusHistory": [
{
"changeDate": "2020-07-01T00:00:00Z",
"taxIdStatus": "ATIVA"
}
],
"cnaeHistory": [
{
"changeDate": "2023-04-01T00:00:00Z",
"code": "6201501",
"activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"docNumber": "",
"economicActivityDivision": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"economicActivityGroup": "ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO",
"isMainEconomicActivity": true
}
],
"capitalHistory": [
{
"changeDate": "2024-11-01T00:00:00Z",
"capital": "8385000.00"
}
],
"currentName": "BIGDATACORP S.A.",
"age": 18,
"totalChanges": 12,
"nameTotalChanges": 2,
"taxRegimeTotalChanges": 3,
"taxIdStatusTotalChanges": 1,
"headquarterTotalChanges": 0,
"cnaeTotalChanges": 6,
"capitalTotalChanges": 3,
"lastDateChanged": "2023-04-01T00:00:00Z",
"lastNameChanged": "2022-02-01T00:00:00Z",
"lastLegalNatureChanged": "2020-07-01T00:00:00Z"
}
],
"has_more": true,
"metadata": {
"status": "NOT_QUERIED",
"provenance": {
"datasets": [
{
"datasetSlug": "<string>",
"requirement": "required",
"visible": true,
"onRefresh": true,
"sourcePriority": 123,
"status": "NOT_QUERIED",
"queryId": "<string>",
"observedAt": "<string>",
"recordedAt": "<string>",
"errorCode": "upstream_error"
}
]
},
"summary": "<string>"
},
"next_cursor": "<string>",
"type": "<string>"
}Authorizations
OAuth2 Authorization Code flow
Path Parameters
CPF, CNPJ, or company id (cmp_*)
Query Parameters
Maximum number of domain snapshots to return
Data de referência (YYYY-MM-DD)
Comma-separated optional response fields. Supports "summary.short", "summary.long", and "summary.mdx". Without summary.* the metadata.summary field is omitted.
Response
200 - application/json
Object type identifier
Array of results for current page
- Option 1
- Option 2
Show child attributes
Show child attributes
Whether more results exist beyond this page
Show child attributes
Show child attributes
Opaque cursor for next page. null if no more results.
Type of results (Notion-compatible)
⌘I