Skip to main content
GET
Reference example
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: per call (1 credit per lookup). Current prices are on aisa.one/api. 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.)

Request contract

  • Method and path: GET /apis/v1/cnpja/office/{taxId}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/cnpja/office/{taxId}
  • taxId: path; required
  • geocoding: query; optional
  • links: query; optional
  • maxAge: query; optional
  • maxStale: query; optional
  • registrations: query; optional
  • simples: query; optional
  • simplesHistory: query; optional
  • strategy: query; optional
  • suframa: query; optional
  • Runtime facts: 7902aca01742f50a011ae8ad568f2a7a312ad5685b1751738ffd879a4d9b4a2f
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0288 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0288
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_header

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

taxId
string
required

The 14-digit Brazilian CNPJ number of the office to look up (digits only, no punctuation). Punctuated input fails routing. Example: 06990590000123.

Example:

"06990590000123"

Query Parameters

geocoding
boolean
Maximum string length: 256
maxAge
integer
Required range: 0 <= x <= 9223372036854776000
maxStale
integer
Required range: 0 <= x <= 9223372036854776000
registrations
string
Maximum string length: 256
simples
boolean
simplesHistory
boolean
strategy
string
Maximum string length: 32
suframa
boolean

Response

The registered office profile for the given CNPJ.

address
object

Registered address of the office.

alias
string | null

Trade name (nome fantasia) of the office, when registered. Returns null for offices without a registered trade name.

company
object

The parent legal entity.

emails
object[]

Registered email addresses.

founded
string

Registration/opening date of the office (YYYY-MM-DD).

head
boolean

Whether this office is the company headquarters (matriz).

mainActivity
object

Primary economic activity (CNAE) of the office.

phones
object[]

Registered phone numbers.

sideActivities
object[]

Secondary economic activities (CNAE).

status
object

Registration status of the office (e.g. Ativa / Baixada).

statusDate
string

Date of the current registration status (YYYY-MM-DD).

taxId
string

The 14-digit CNPJ of this office.

updated
string

Timestamp of the last update of this record at the revenue service (ISO 8601).