CNPJ Office Lookup
curl --request GET \
--url https://api.aisa.one/apis/v1/cnpja/office/{taxId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/cnpja/office/{taxId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/cnpja/office/{taxId}', 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.aisa.one/apis/v1/cnpja/office/{taxId}",
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 := "https://api.aisa.one/apis/v1/cnpja/office/{taxId}"
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("https://api.aisa.one/apis/v1/cnpja/office/{taxId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/cnpja/office/{taxId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"updated": "2026-09-08T20:11:15.000Z",
"taxId": "06990590000123",
"company": {
"id": "06990590",
"name": "GOOGLE BRASIL INTERNET LTDA.",
"equity": 200000000,
"nature": {
"id": 2062,
"text": "Sociedade Empresária Limitada"
},
"size": {
"id": 5,
"acronym": "DEMAIS",
"text": "Demais"
},
"members": [
{
"since": "2004-09-01",
"role": {
"id": 37,
"text": "Sócio Pessoa Jurídica Domiciliado no Exterior"
},
"person": {
"id": "f172f1f6-46f5-5a10-9fb9-8d7c2dbdc2f9",
"name": "GOOGLE LLC",
"type": "LEGAL",
"taxId": "06947284000104",
"country": {
"id": 840,
"name": "Estados Unidos"
}
},
"agent": {
"role": {
"id": 17,
"text": "Procurador"
},
"person": {
"id": "1cf6c284-8400-5c85-89e3-b20e0093be5a",
"name": "Yun Ki Lee",
"type": "NATURAL",
"taxId": "***746608**",
"age": "51-60",
"country": {
"id": 76,
"name": "Brasil"
}
}
}
},
{
"since": "2014-08-26",
"role": {
"id": 5,
"text": "Administrador"
},
"person": {
"id": "dc20e638-a27c-547c-bb7d-5ee7cbd917b7",
"name": "Fabio Jose Silva Coelho",
"type": "NATURAL",
"taxId": "***133807**",
"age": "61-70",
"country": {
"id": 76,
"name": "Brasil"
}
}
}
]
},
"alias": null,
"founded": "2004-09-01",
"head": true,
"statusDate": "2004-09-01",
"status": {
"id": 2,
"text": "Ativa"
},
"address": {
"municipality": 3550308,
"street": "Avenida Brig Faria Lima",
"number": "3477",
"details": "Andar 17A20 Tsul 2 17A20",
"district": "Itaim Bibi",
"city": "São Paulo",
"state": "SP",
"zip": "04538133",
"country": {
"id": 76,
"name": "Brasil"
}
},
"phones": [
{
"type": "LANDLINE",
"area": "11",
"number": "23958400"
}
],
"emails": [
{
"ownership": "CORPORATE",
"domain": "google.com",
"address": "googlebrasil@google.com"
}
],
"mainActivity": {
"id": 6319400,
"text": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
},
"sideActivities": [
{
"id": 4751201,
"text": "Comércio varejista especializado de equipamentos e suprimentos de informática"
},
{
"id": 6201501,
"text": "Desenvolvimento de programas de computador sob encomenda"
},
{
"id": 6202300,
"text": "Desenvolvimento e licenciamento de programas de computador customizáveis"
},
{
"id": 6311900,
"text": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
},
{
"id": 6462000,
"text": "Holdings de instituições não financeiras"
},
{
"id": 7319004,
"text": "Consultoria em publicidade"
},
{
"id": 8299799,
"text": "Outras atividades de serviços prestados principalmente às empresas não especificadas anteriormente"
}
]
}{
"code": 400,
"message": "request validation failed",
"constraints": [
"taxId must be a string that obeys cnpj verification algorithm"
]
}{
"code": 404,
"message": "tax id not registered at revenue service"
}CNPJá API
CNPJ Office Lookup
Look up the registered profile of a Brazilian company office (establishment) by its 14-digit CNPJ tax ID.
GET
https://api.aisa.one/apis/v1
/
cnpja
/
office
/
{taxId}
CNPJ Office Lookup
curl --request GET \
--url https://api.aisa.one/apis/v1/cnpja/office/{taxId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/cnpja/office/{taxId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/cnpja/office/{taxId}', 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.aisa.one/apis/v1/cnpja/office/{taxId}",
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 := "https://api.aisa.one/apis/v1/cnpja/office/{taxId}"
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("https://api.aisa.one/apis/v1/cnpja/office/{taxId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/cnpja/office/{taxId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"updated": "2026-09-08T20:11:15.000Z",
"taxId": "06990590000123",
"company": {
"id": "06990590",
"name": "GOOGLE BRASIL INTERNET LTDA.",
"equity": 200000000,
"nature": {
"id": 2062,
"text": "Sociedade Empresária Limitada"
},
"size": {
"id": 5,
"acronym": "DEMAIS",
"text": "Demais"
},
"members": [
{
"since": "2004-09-01",
"role": {
"id": 37,
"text": "Sócio Pessoa Jurídica Domiciliado no Exterior"
},
"person": {
"id": "f172f1f6-46f5-5a10-9fb9-8d7c2dbdc2f9",
"name": "GOOGLE LLC",
"type": "LEGAL",
"taxId": "06947284000104",
"country": {
"id": 840,
"name": "Estados Unidos"
}
},
"agent": {
"role": {
"id": 17,
"text": "Procurador"
},
"person": {
"id": "1cf6c284-8400-5c85-89e3-b20e0093be5a",
"name": "Yun Ki Lee",
"type": "NATURAL",
"taxId": "***746608**",
"age": "51-60",
"country": {
"id": 76,
"name": "Brasil"
}
}
}
},
{
"since": "2014-08-26",
"role": {
"id": 5,
"text": "Administrador"
},
"person": {
"id": "dc20e638-a27c-547c-bb7d-5ee7cbd917b7",
"name": "Fabio Jose Silva Coelho",
"type": "NATURAL",
"taxId": "***133807**",
"age": "61-70",
"country": {
"id": 76,
"name": "Brasil"
}
}
}
]
},
"alias": null,
"founded": "2004-09-01",
"head": true,
"statusDate": "2004-09-01",
"status": {
"id": 2,
"text": "Ativa"
},
"address": {
"municipality": 3550308,
"street": "Avenida Brig Faria Lima",
"number": "3477",
"details": "Andar 17A20 Tsul 2 17A20",
"district": "Itaim Bibi",
"city": "São Paulo",
"state": "SP",
"zip": "04538133",
"country": {
"id": 76,
"name": "Brasil"
}
},
"phones": [
{
"type": "LANDLINE",
"area": "11",
"number": "23958400"
}
],
"emails": [
{
"ownership": "CORPORATE",
"domain": "google.com",
"address": "googlebrasil@google.com"
}
],
"mainActivity": {
"id": 6319400,
"text": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
},
"sideActivities": [
{
"id": 4751201,
"text": "Comércio varejista especializado de equipamentos e suprimentos de informática"
},
{
"id": 6201501,
"text": "Desenvolvimento de programas de computador sob encomenda"
},
{
"id": 6202300,
"text": "Desenvolvimento e licenciamento de programas de computador customizáveis"
},
{
"id": 6311900,
"text": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
},
{
"id": 6462000,
"text": "Holdings de instituições não financeiras"
},
{
"id": 7319004,
"text": "Consultoria em publicidade"
},
{
"id": 8299799,
"text": "Outras atividades de serviços prestados principalmente às empresas não especificadas anteriormente"
}
]
}{
"code": 400,
"message": "request validation failed",
"constraints": [
"taxId must be a string that obeys cnpj verification algorithm"
]
}{
"code": 404,
"message": "tax id not registered at revenue service"
}Resolve the full registered profile of a Brazilian company office (establishment) from its 14-digit CNPJ tax ID. The response includes the legal name (razão social) via
company.name, the trade name (alias, which may be null), registration status, founded date, the full registered address, the shareholder/partner structure (company.members), registered phones / emails, and the primary/secondary economic activities (mainActivity / sideActivities).
Pass the CNPJ as the taxId path parameter (digits only, no punctuation) and authenticate with your AIsa API key as a bearer token — the same key used across every AIsa /apis/* endpoint.
Example: GET /apis/v1/cnpja/office/06990590000123 returns the office registered under that CNPJ, including company.name, alias, status, address, company.members, and mainActivity.
Error responses: a malformed CNPJ that fails the check-digit (checksum) algorithm returns HTTP 400 (request validation failed) — a client-side input error. A well-formed CNPJ that is simply not registered returns HTTP 404 (tax id not registered at revenue service).
Billing: $0.00528 per call (1 credit per lookup). The “not registered” HTTP 404 result returns a valid JSON body and is still billed 1 credit; only 429, 5xx, and network errors are not billed. (A 400 validation error is a client-side rejection.)Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The 14-digit Brazilian CNPJ number of the office to look up (digits only, no punctuation). Punctuated input fails routing. Example: 06990590000123.
Example:
"06990590000123"
Response
The registered office profile for the given CNPJ.
Timestamp of the last update of this record at the revenue service (ISO 8601).
The 14-digit CNPJ of this office.
Trade name (nome fantasia) of the office, when registered. Returns null for offices without a registered trade name.
Registration/opening date of the office (YYYY-MM-DD).
Whether this office is the company headquarters (matriz).
Date of the current registration status (YYYY-MM-DD).
Registration status of the office (e.g. Ativa / Baixada).
Show child attributes
Show child attributes
The parent legal entity.
Show child attributes
Show child attributes
Registered address of the office.
Show child attributes
Show child attributes
Registered phone numbers.
Show child attributes
Show child attributes
Registered email addresses.
Show child attributes
Show child attributes
Primary economic activity (CNAE) of the office.
Show child attributes
Show child attributes
Secondary economic activities (CNAE).
Show child attributes
Show child attributes