> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CNPJ Office Lookup

> Look up the registered profile of a Brazilian company office (establishment) by its 14-digit CNPJ tax ID. Returns the office's legal/company name, trade name (`alias`), registration status, founding date, full address, shareholder/member structure, and primary/secondary economic activities (CNAE).

Billed $0.00528 per call (1 credit per lookup). A "company not found" result returns HTTP 404 with a valid JSON body and is still billed 1 credit; only 429, 5xx, and network errors are not billed.



## OpenAPI

````yaml openapi/zh/cnpja.json GET /apis/v1/cnpja/office/{taxId}
openapi: 3.1.0
info:
  description: ''
  title: CNPJá (Brazilian company registry / CNPJ)
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/cnpja/office/{taxId}
  x-aisa-document:
    facts_hash: 568ccf978ba01d1adb0cc82125cc488a63fa248224bddd6aa159af6184df6c90
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:2df2dd00a7d19d928dd9176a77ba9726cbde6e08351af0396161d5b013307a92
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: cnpja
  x-aisa-catalogs:
    cnpja:
      title: CNPJá (Brazilian company registry / CNPJ)
      description: ''
      x-aisa-document:
        facts_hash: 568ccf978ba01d1adb0cc82125cc488a63fa248224bddd6aa159af6184df6c90
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/cnpja/office/{taxId}:
    get:
      tags:
        - cnpja
      summary: CNPJ Office Lookup
      description: >-
        Look up the registered profile of a Brazilian company office
        (establishment) by its 14-digit CNPJ tax ID. Returns the office's
        legal/company name, trade name (`alias`), registration status, founding
        date, full address, shareholder/member structure, and primary/secondary
        economic activities (CNAE).


        Billed $0.00528 per call (1 credit per lookup). A "company not found"
        result returns HTTP 404 with a valid JSON body and is still billed 1
        credit; only 429, 5xx, and network errors are not billed.
      operationId: get_cnpja_office_lookup
      parameters:
        - name: taxId
          in: path
          required: true
          description: >-
            The 14-digit Brazilian CNPJ number of the office to look up (digits
            only, no punctuation). Punctuated input fails routing. Example:
            `06990590000123`.
          schema:
            type: string
            example: '06990590000123'
        - in: query
          name: geocoding
          required: false
          schema:
            type: boolean
        - in: query
          name: links
          required: false
          schema:
            maxLength: 256
            type: string
        - in: query
          name: maxAge
          required: false
          schema:
            type: integer
        - in: query
          name: maxStale
          required: false
          schema:
            type: integer
        - in: query
          name: registrations
          required: false
          schema:
            maxLength: 256
            type: string
        - in: query
          name: simples
          required: false
          schema:
            type: boolean
        - in: query
          name: simplesHistory
          required: false
          schema:
            type: boolean
        - in: query
          name: strategy
          required: false
          schema:
            maxLength: 32
            type: string
        - in: query
          name: suframa
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: The registered office profile for the given CNPJ.
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: string
                    description: >-
                      Timestamp of the last update of this record at the revenue
                      service (ISO 8601).
                  taxId:
                    type: string
                    description: The 14-digit CNPJ of this office.
                  alias:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Trade name (nome fantasia) of the office, when registered.
                      Returns `null` for offices without a registered trade
                      name.
                  founded:
                    type: string
                    description: Registration/opening date of the office (YYYY-MM-DD).
                  head:
                    type: boolean
                    description: Whether this office is the company headquarters (matriz).
                  statusDate:
                    type: string
                    description: Date of the current registration status (YYYY-MM-DD).
                  status:
                    type: object
                    description: Registration status of the office (e.g. Ativa / Baixada).
                    properties:
                      id:
                        type: integer
                      text:
                        type: string
                  company:
                    type: object
                    description: The parent legal entity.
                    properties:
                      id:
                        type: string
                        description: >-
                          Company identifier (8 digits, may include leading
                          zeros).
                      name:
                        type: string
                        description: Legal name (razão social) of the company.
                      equity:
                        type: number
                        description: Registered share capital.
                      nature:
                        type: object
                        description: Legal nature (natureza jurídica) of the company.
                        properties:
                          id:
                            type: integer
                          text:
                            type: string
                      size:
                        type: object
                        description: Company size classification (porte).
                        properties:
                          id:
                            type: integer
                          acronym:
                            type: string
                          text:
                            type: string
                      members:
                        type: array
                        description: >-
                          Shareholder / partner structure (quadro societário).
                          Each entry describes a member and, when applicable,
                          their legal representative (agent).
                        items:
                          type: object
                          properties:
                            since:
                              type: string
                              description: Date the member joined (YYYY-MM-DD).
                            role:
                              type: object
                              properties:
                                id:
                                  type: integer
                                text:
                                  type: string
                            person:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                type:
                                  type: string
                                  description: LEGAL or NATURAL.
                                taxId:
                                  type: string
                                  description: Partially masked for natural persons.
                                age:
                                  type:
                                    - string
                                    - 'null'
                                  description: Age band for natural persons.
                                country:
                                  type: object
                                  properties:
                                    id:
                                      type: integer
                                    name:
                                      type: string
                            agent:
                              type:
                                - object
                                - 'null'
                              description: >-
                                Legal representative of the member, when the
                                member is a foreign or legal entity.
                              properties:
                                role:
                                  type: object
                                  properties:
                                    id:
                                      type: integer
                                    text:
                                      type: string
                                person:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    name:
                                      type: string
                                    type:
                                      type: string
                                    taxId:
                                      type: string
                                    age:
                                      type:
                                        - string
                                        - 'null'
                                    country:
                                      type: object
                                      properties:
                                        id:
                                          type: integer
                                        name:
                                          type: string
                  address:
                    type: object
                    description: Registered address of the office.
                    properties:
                      municipality:
                        type: integer
                        description: IBGE municipality code.
                      street:
                        type: string
                      number:
                        type: string
                      details:
                        type:
                          - string
                          - 'null'
                        description: Address complement (complemento).
                      district:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      zip:
                        type: string
                      country:
                        type: object
                        properties:
                          id:
                            type: integer
                          name:
                            type: string
                  phones:
                    type: array
                    description: Registered phone numbers.
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          description: e.g. LANDLINE / MOBILE.
                        area:
                          type: string
                          description: Area code (DDD).
                        number:
                          type: string
                  emails:
                    type: array
                    description: Registered email addresses.
                    items:
                      type: object
                      properties:
                        ownership:
                          type: string
                          description: e.g. CORPORATE / PERSONAL.
                        domain:
                          type: string
                        address:
                          type: string
                  mainActivity:
                    type: object
                    description: Primary economic activity (CNAE) of the office.
                    properties:
                      id:
                        type: integer
                      text:
                        type: string
                  sideActivities:
                    type: array
                    description: Secondary economic activities (CNAE).
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                        text:
                          type: string
              example:
                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
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.