# Pesquisa Avançada de empresas

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v5/cnpj/pesquisa:
    post:
      summary: Pesquisa Avançada de empresas
      deprecated: false
      description: ''
      tags:
        - API/v5
        - v5
      parameters:
        - name: tipo_resultado
          in: query
          description: >-
            Informa se a resposta da requisição é simples ou completa, a simples
            contem cnpj, razão social, nome fantasia e situação cadastral e a
            completa todos os campos disponiveis. O Padrão é simples
          required: false
          schema:
            type: string
            enum:
              - simples
              - completo
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CNPJPesquisaSolicitacao'
            examples: {}
      responses:
        '200':
          description: retorno com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                  cnpjs:
                    type: array
                    items:
                      $ref: '#/components/schemas/CNPJPesquisaResposta'
                x-apidog-orders:
                  - total
                  - cnpjs
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: OK
        '400':
          description: >-
            Solicitação inválida, verifique se o tipo de dado no campo está
            correto
          headers: {}
          x-apidog-name: Pedido inválido
        '401':
          description: Api key inválida
          headers: {}
          x-apidog-name: Não autorizado
        '403':
          description: Sem saldo para a operação
          headers: {}
          x-apidog-name: Proibido
      security: []
      x-apidog-folder: API/v5
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/907226/apis/api-16579062-run
components:
  schemas:
    CNPJPesquisaSolicitacao:
      type: object
      properties:
        cnpj:
          type: array
          items:
            type: string
          examples:
            - - '29806217000175'
              - '33000167000292'
        busca_textual:
          type: array
          items:
            type: object
            properties:
              texto:
                type: array
                items:
                  type: string
              tipo_busca:
                type: string
                enum:
                  - exata
                  - radical
              razao_social:
                type: boolean
              nome_fantasia:
                type: boolean
              nome_socio:
                type: boolean
            x-apidog-orders:
              - texto
              - tipo_busca
              - razao_social
              - nome_fantasia
              - nome_socio
            x-apidog-ignore-properties: []
        codigo_atividade_principal:
          type: array
          items:
            type: string
          examples:
            - - '7112000'
              - '9602501'
              - '6462000'
        incluir_atividade_secundaria:
          type: boolean
        codigo_atividade_secundaria:
          type: array
          items:
            type: string
          examples:
            - - '7112000'
              - '9602501'
              - '6462000'
        codigo_natureza_juridica:
          type: array
          items:
            type: string
          examples:
            - - '7112000'
              - '9602501'
              - '6462000'
        situacao_cadastral:
          $ref: '#/components/schemas/SituacaoCadastral'
        matriz_filial: &ref_1
          $ref: '#/components/schemas/MatrizFilial'
        cnpj_raiz:
          type: array
          items:
            type: string
          examples:
            - - '33000167'
              - '29806217'
        cep:
          type: array
          items:
            type: string
          examples:
            - - '07115000'
              - '01310930'
        endereco_numero:
          type: array
          items:
            type: string
          examples:
            - - '21'
              - 109B
        uf:
          type: array
          items:
            type: string
          examples:
            - - sp
              - rj
              - mg
        municipio:
          type: array
          items:
            type: string
          examples:
            - - sao paulo
              - guarulhos
              - belo horizonte
        bairro:
          type: array
          items:
            type: string
          examples:
            - - centro
              - vila mariana
        ddd:
          type: array
          items:
            type: string
          examples:
            - - '11'
              - '12'
              - '31'
        telefone:
          type: array
          items:
            type: string
          examples:
            - - '5135277255'
        data_abertura:
          type: object
          properties:
            inicio:
              type: string
              format: date
            fim:
              type: string
              format: date
            ultimos_dias:
              type: integer
          x-apidog-orders:
            - inicio
            - fim
            - ultimos_dias
          x-apidog-ignore-properties: []
        capital_social:
          type: object
          properties:
            minimo:
              type: integer
            maximo:
              type: integer
          x-apidog-orders:
            - minimo
            - maximo
          x-apidog-ignore-properties: []
        mei:
          type: object
          properties:
            optante:
              type: boolean
            excluir_optante:
              type: boolean
            data_exclusao:
              type: object
              properties:
                inicio:
                  type: string
                  format: date
                fim:
                  type: string
                  format: date
              x-apidog-orders:
                - inicio
                - fim
              x-apidog-ignore-properties: []
          x-apidog-orders:
            - optante
            - excluir_optante
            - data_exclusao
          x-apidog-ignore-properties: []
        simples:
          type: object
          properties:
            optante:
              type: boolean
            excluir_optante:
              type: boolean
            data_exclusao:
              type: object
              properties:
                inicio:
                  type: string
                  format: date
                fim:
                  type: string
                  format: date
              x-apidog-orders:
                - inicio
                - fim
              x-apidog-ignore-properties: []
          x-apidog-orders:
            - optante
            - excluir_optante
            - data_exclusao
          x-apidog-ignore-properties: []
        porte_empresa:
          type: object
          properties:
            codigos:
              type: array
              items:
                type: string
                enum:
                  - '01'
                  - '03'
                  - '05'
                x-apidog-enum:
                  - value: '01'
                    name: Micro Empresa
                    description: ''
                  - value: '03'
                    name: Empresa de Pequeno Porte
                    description: ''
                  - value: '05'
                    name: Demais
                    description: ''
          x-apidog-orders:
            - codigos
          x-apidog-ignore-properties: []
        mais_filtros:
          type: object
          properties:
            somente_matriz:
              type: boolean
            somente_filial:
              type: boolean
            com_email:
              type: boolean
            com_telefone:
              type: boolean
            somente_fixo:
              type: boolean
            somente_celular:
              type: boolean
            excluir_empresas_visualizadas:
              type: boolean
            excluir_email_contab:
              type: boolean
          x-apidog-orders:
            - somente_matriz
            - somente_filial
            - com_email
            - com_telefone
            - somente_fixo
            - somente_celular
            - excluir_empresas_visualizadas
            - excluir_email_contab
          x-apidog-ignore-properties: []
        excluir:
          type: object
          properties:
            cnpj:
              type: array
              items:
                type: string
              examples:
                - - '29806217000175'
                  - '33000167000292'
          x-apidog-orders:
            - cnpj
          x-apidog-ignore-properties: []
        limite:
          type: integer
          maximum: 1000
          minimum: 1
          examples:
            - 10
        pagina:
          type: integer
          minimum: 1
          examples:
            - 1
      x-apidog-orders:
        - cnpj
        - busca_textual
        - codigo_atividade_principal
        - incluir_atividade_secundaria
        - codigo_atividade_secundaria
        - codigo_natureza_juridica
        - situacao_cadastral
        - matriz_filial
        - cnpj_raiz
        - cep
        - endereco_numero
        - uf
        - municipio
        - bairro
        - ddd
        - telefone
        - data_abertura
        - capital_social
        - mei
        - simples
        - porte_empresa
        - mais_filtros
        - excluir
        - limite
        - pagina
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    MatrizFilial:
      type: string
      enum:
        - MATRIZ
        - FILIAL
      x-apidog-folder: ''
    SituacaoCadastral:
      type: array
      items:
        type: string
        enum:
          - ATIVA
          - BAIXADA
          - INAPTA
          - NULA
          - SUSPENSA
      x-apidog-folder: ''
    CNPJPesquisaResposta:
      type: object
      properties:
        cnpj:
          type: string
          examples:
            - '33000167004794'
        cnpj_raiz:
          type: string
          examples:
            - '33000167'
        filial_numero:
          type: integer
          format: int32
          examples:
            - 1
        razao_social:
          type: string
          examples:
            - PETROLEO BRASILEIRO S A PETROBRAS
        qualificacao_responsavel: &ref_0
          $ref: '#/components/schemas/CodigoDescricao'
        porte_empresa: *ref_0
        matriz_filial: *ref_1
        codigo_natureza_juridica:
          type: string
        descricao_natureza_juridica:
          type: string
        nome_fantasia:
          type: string
        situacao_cadastral:
          type: object
          properties:
            situacao_cadastral:
              type: string
            motivo:
              type: string
            data:
              type: string
              format: date
          x-apidog-orders:
            - situacao_cadastral
            - motivo
            - data
          x-apidog-ignore-properties: []
        endereco:
          type: object
          properties:
            cep:
              type: string
            tipo_logradouro:
              type: string
            logradouro:
              type: string
            numero:
              type: string
            complemento:
              type: string
            bairro:
              type: string
            uf:
              type: string
            municipio:
              type: string
            ibge:
              type: object
              properties:
                codigo_municipio:
                  type: integer
                codigo_uf:
                  type: integer
                latitude:
                  type: number
                longitude:
                  type: number
              x-apidog-orders:
                - codigo_municipio
                - codigo_uf
                - latitude
                - longitude
              x-apidog-ignore-properties: []
          x-apidog-orders:
            - cep
            - tipo_logradouro
            - logradouro
            - numero
            - complemento
            - bairro
            - uf
            - municipio
            - ibge
          x-apidog-ignore-properties: []
        data_abertura:
          type: string
          format: date
        data_inscricao:
          type: string
          format: date
        capital_social:
          type: integer
        situacao_especial:
          type: object
          properties:
            descricao:
              type: string
            data:
              type: string
              format: date
          x-apidog-orders:
            - descricao
            - data
          x-apidog-ignore-properties: []
        quadro_societario:
          type: array
          items:
            type: object
            properties:
              nome:
                type: string
              qualificacao_socio:
                type: string
              qualificacao_socio_codigo:
                type: integer
              identificador_socio:
                type: string
              documento:
                type: string
              data_entrada_sociedade:
                type: string
                format: date
              pais_socio:
                type: string
              cpf_representante_legal:
                type: string
              nome_representante_legal:
                type: string
              qualificacao_representante_legal:
                type: string
              faixa_etaria_codigo:
                type: integer
              faixa_etaria_descricao:
                type: string
            x-apidog-orders:
              - nome
              - qualificacao_socio
              - qualificacao_socio_codigo
              - identificador_socio
              - documento
              - data_entrada_sociedade
              - pais_socio
              - cpf_representante_legal
              - nome_representante_legal
              - qualificacao_representante_legal
              - faixa_etaria_codigo
              - faixa_etaria_descricao
            x-apidog-ignore-properties: []
      x-apidog-orders:
        - cnpj
        - cnpj_raiz
        - filial_numero
        - razao_social
        - qualificacao_responsavel
        - porte_empresa
        - matriz_filial
        - codigo_natureza_juridica
        - descricao_natureza_juridica
        - nome_fantasia
        - situacao_cadastral
        - endereco
        - data_abertura
        - data_inscricao
        - capital_social
        - situacao_especial
        - quadro_societario
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    CodigoDescricao:
      type: object
      properties:
        codigo:
          type: string
        descricao:
          type: string
      x-apidog-orders:
        - codigo
        - descricao
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    api_key:
      type: apikey
      name: api-key
      in: header
servers: []
security: []

```