Skip to main content

​
Get company

GET /api/company/{cnpj}/ Returns registry information for a Brazilian company identified by its CNPJ. Companies in this dataset are suppliers where congresspeople made CEAP expenses and filed reimbursement claims.
The cnpj path parameter must be provided as 14 digits with no formatting — no dots, slashes, or dashes.
​
cnpj
string
required
The 14-digit CNPJ of the company. Must be digits only (e.g. 11111111000191, not 11.111.111/0001-91).
Returns 404 if no company with the given CNPJ exists in the database.

​
Response

​
cnpj
string
required
CNPJ of the company in formatted notation (e.g. 11.111.111/0001-91).
​
name
string
Official registered name of the company.
​
trade_name
string
Trade name (fantasy name) used by the company, if any.
​
opening
string
Date the company was registered. Format: YYYY-MM-DD.
​
legal_entity
string
Legal entity type (e.g. limited liability, sole proprietor).
​
type
string
Company type code.
​
status
string
Current registration status code.
​
situation
string
Current regulatory situation (e.g. active, suspended, cancelled).
​
situation_reason
string
Reason for the current regulatory situation.
​
situation_date
string
Date the current regulatory situation took effect. Format: YYYY-MM-DD.
​
special_situation
string
Special situation designation, if applicable.
​
special_situation_date
string
Date the special situation took effect. Format: YYYY-MM-DD.
​
responsible_federative_entity
string
Federative entity responsible for the company’s registration.
​
address
string
Street address.
​
number
string
Building or unit number.
​
additional_address_details
string
Additional address details (complement).
​
neighborhood
string
Neighborhood.
​
zip_code
string
Postal code (CEP).
​
city
string
City name.
​
state
string
State abbreviation (e.g. SP, RJ).
​
email
string
Contact email address.
​
phone
string
Contact phone number.
​
latitude
number
Geographic latitude of the company’s address.
​
longitude
number
Geographic longitude of the company’s address.
​
main_activity
object[]
Primary CNAE activity codes and descriptions for this company.
​
secondary_activity
object[]
Secondary CNAE activity codes and descriptions, if any.
​
last_updated
string
Timestamp of the last update to this company record. Format: ISO 8601.

​
Example

curl "https://jarbas.serenata.ai/api/company/11111111000191/"
Example response
{
  "cnpj": "11.111.111/0001-91",
  "name": "EMPRESA EXEMPLO LTDA",
  "trade_name": "EXEMPLO",
  "opening": "2005-03-22",
  "legal_entity": "Sociedade Empresária Limitada",
  "type": "2",
  "status": "2",
  "situation": "ATIVA",
  "situation_reason": null,
  "situation_date": "2005-03-22",
  "special_situation": null,
  "special_situation_date": null,
  "responsible_federative_entity": null,
  "address": "RUA DAS FLORES",
  "number": "100",
  "additional_address_details": "SALA 1",
  "neighborhood": "CENTRO",
  "zip_code": "70040-010",
  "city": "BRASILIA",
  "state": "DF",
  "email": "[email protected]",
  "phone": "6133334444",
  "latitude": -15.7942,
  "longitude": -47.8825,
  "main_activity": [
    {
      "code": "47.11-3-02",
      "description": "Comércio varejista de mercadorias em geral"
    }
  ],
  "secondary_activity": [],
  "last_updated": "2017-08-15T10:30:00Z"
}
404 response
{
  "detail": "Not found."
}

Build docs developers (and LLMs) love

Get started for freeTalk to us