openapi: 3.1.0
info:
  title: API de consultas Leads B2B Brasil (/api/v1)
  version: 1.0.0
  description: "Consultas, pacotes e consulta personalizada da plataforma Leads B2B Brasil. A chave é gerada na aba APIs da plataforma, com os campos que ela pode usar marcados no checklist; cada rota exige os campos dela. Cada chamada com resultado debita do saldo da conta dona da chave (aba Créditos). Se a pesquisa não retornar resultado, ela não é cobrada. Erro da fonte também não é cobrado; a resposta traz cobrado (true/false) e, sem resultado, sem_resultado: true. Os valores aparecem só dentro da plataforma. As mesmas consultas estão no servidor MCP em https://leadsb2bbrasil.com/api/mcp (Streamable HTTP, mesma chave e mesma cobrança)."
servers:
  - url: https://leadsb2bbrasil.com/api/v1
security:
  - Bearer: []
  - ChaveApi: []
paths:
  /cpf/leads:
    get:
      operationId: "get_cpf_leads"
      summary: "CPF Leads B2B Brasil"
      description: "Campos exigidos na chave (todos): cpf.cadastro, cpf.telefones, cpf.operadora, cpf.rg, cpf.titulo, cpf.parentes, cpf.vizinhos, cpf.cnh, cpf.veiculos, cpf.empresas, cpf.score, cpf.universitarios, cpf.google, cpf.email, cpf.mesma_mae, cpf.homonimos_uf."
      parameters:
        - name: "cpf"
          in: query
          required: false
          description: "CPF"
          schema: {type: string}
        - name: "tituloEleitor"
          in: query
          required: false
          description: "Título de eleitor"
          schema: {type: string}
        - name: "rg"
          in: query
          required: false
          description: "RG"
          schema: {type: string}
        - name: "pis"
          in: query
          required: false
          description: "PIS"
          schema: {type: string}
        - name: "nis"
          in: query
          required: false
          description: "NIS"
          schema: {type: string}
        - name: "nome"
          in: query
          required: false
          description: "Nome completo"
          schema: {type: string}
        - name: "uf"
          in: query
          required: false
          description: "UF (opcional)"
          schema: {type: string}
        - name: "mae"
          in: query
          required: false
          description: "Nome da mãe"
          schema: {type: string}
        - name: "telefone"
          in: query
          required: false
          description: "Telefone"
          schema: {type: string}
        - name: "email"
          in: query
          required: false
          description: "E-mail"
          schema: {type: string}
        - name: "cep"
          in: query
          required: false
          description: "CEP"
          schema: {type: string}
        - name: "numero"
          in: query
          required: false
          description: "Número (opcional)"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /cpf/pro:
    get:
      operationId: "get_cpf_pro"
      summary: "CPF Pro"
      description: "Campos exigidos na chave (todos): cpf.cadastro, cpf.telefones, cpf.operadora, cpf.email, cpf.rg, cpf.titulo, cpf.cnh, cpf.veiculos, cpf.empresas, cpf.sancoes, cpf.parentes."
      parameters:
        - name: "cpf"
          in: query
          required: false
          description: "CPF"
          schema: {type: string}
        - name: "tituloEleitor"
          in: query
          required: false
          description: "Título de eleitor"
          schema: {type: string}
        - name: "rg"
          in: query
          required: false
          description: "RG"
          schema: {type: string}
        - name: "pis"
          in: query
          required: false
          description: "PIS"
          schema: {type: string}
        - name: "nis"
          in: query
          required: false
          description: "NIS"
          schema: {type: string}
        - name: "nome"
          in: query
          required: false
          description: "Nome completo"
          schema: {type: string}
        - name: "uf"
          in: query
          required: false
          description: "UF (opcional)"
          schema: {type: string}
        - name: "mae"
          in: query
          required: false
          description: "Nome da mãe"
          schema: {type: string}
        - name: "telefone"
          in: query
          required: false
          description: "Telefone"
          schema: {type: string}
        - name: "email"
          in: query
          required: false
          description: "E-mail"
          schema: {type: string}
        - name: "cep"
          in: query
          required: false
          description: "CEP"
          schema: {type: string}
        - name: "numero"
          in: query
          required: false
          description: "Número (opcional)"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /cpf/regular:
    get:
      operationId: "get_cpf_regular"
      summary: "CPF Regular"
      description: "Campos exigidos na chave (todos): cpf.cadastro, cpf.telefones, cpf.titulo, cpf.empresas, cpf.veiculos, cpf.parentes."
      parameters:
        - name: "cpf"
          in: query
          required: false
          description: "CPF"
          schema: {type: string}
        - name: "tituloEleitor"
          in: query
          required: false
          description: "Título de eleitor"
          schema: {type: string}
        - name: "rg"
          in: query
          required: false
          description: "RG"
          schema: {type: string}
        - name: "pis"
          in: query
          required: false
          description: "PIS"
          schema: {type: string}
        - name: "nis"
          in: query
          required: false
          description: "NIS"
          schema: {type: string}
        - name: "nome"
          in: query
          required: false
          description: "Nome completo"
          schema: {type: string}
        - name: "uf"
          in: query
          required: false
          description: "UF (opcional)"
          schema: {type: string}
        - name: "mae"
          in: query
          required: false
          description: "Nome da mãe"
          schema: {type: string}
        - name: "telefone"
          in: query
          required: false
          description: "Telefone"
          schema: {type: string}
        - name: "email"
          in: query
          required: false
          description: "E-mail"
          schema: {type: string}
        - name: "cep"
          in: query
          required: false
          description: "CEP"
          schema: {type: string}
        - name: "numero"
          in: query
          required: false
          description: "Número (opcional)"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /cnpj/leads:
    get:
      operationId: "get_cnpj_leads"
      summary: "CNPJ Leads B2B Brasil"
      description: "Campos exigidos na chave (todos): cnpj.cadastro, cnpj.socios_cadastro, cnpj.operadora, cnpj.telefone_full, cnpj.email, cnpj.google, cnpj.filiais, cnpj.sancoes, cnpj.veiculos, cnpj.permutacao."
      parameters:
        - name: "cnpj"
          in: query
          required: false
          description: "CNPJ"
          schema: {type: string}
        - name: "cpf"
          in: query
          required: false
          description: "CPF de um sócio"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /cnpj/pro:
    get:
      operationId: "get_cnpj_pro"
      summary: "CNPJ Pro"
      description: "Campos exigidos na chave (todos): cnpj.cadastro, cnpj.socios_cadastro, cnpj.filiais, cnpj.sancoes, cnpj.veiculos."
      parameters:
        - name: "cnpj"
          in: query
          required: false
          description: "CNPJ"
          schema: {type: string}
        - name: "cpf"
          in: query
          required: false
          description: "CPF de um sócio"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /cnpj/regular:
    get:
      operationId: "get_cnpj_regular"
      summary: "CNPJ Regular"
      description: "Campos exigidos na chave (todos): cnpj.cadastro, cnpj.socios_cadastro, cnpj.sancoes."
      parameters:
        - name: "cnpj"
          in: query
          required: false
          description: "CNPJ"
          schema: {type: string}
        - name: "cpf"
          in: query
          required: false
          description: "CPF de um sócio"
          schema: {type: string}
        - name: "ref"
          in: query
          required: false
          description: "Referência do candidato escolhido (resposta com escolha)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/leads:
    get:
      operationId: "get_consulta_leads"
      summary: "Leads Comerciais"
      description: "Campos exigidos na chave (um deles): avulso.leads."
      parameters:
        - name: "q"
          in: query
          required: false
          description: "Segmento e cidade"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/permutacao:
    get:
      operationId: "get_consulta_permutacao"
      summary: "Permutação Corporativa"
      description: "Campos exigidos na chave (um deles): cnpj.permutacao."
      parameters:
        - name: "nome"
          in: query
          required: false
          description: "Nome da pessoa"
          schema: {type: string}
        - name: "dominio"
          in: query
          required: false
          description: "Domínio da empresa"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/telefone:
    get:
      operationId: "get_consulta_telefone"
      summary: "Telefone (titular e completo)"
      description: "Campos exigidos na chave (um deles): cpf.telefones, cnpj.telefone_full."
      parameters:
        - name: "telefone"
          in: query
          required: false
          description: "Telefone com DDD"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/email:
    get:
      operationId: "get_consulta_email"
      summary: "E-mail"
      description: "Campos exigidos na chave (um deles): cpf.email, cnpj.email."
      parameters:
        - name: "email"
          in: query
          required: false
          description: "E-mail"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/mae:
    get:
      operationId: "get_consulta_mae"
      summary: "Nome da Mãe"
      description: "Campos exigidos na chave (um deles): cpf.mesma_mae."
      parameters:
        - name: "mae"
          in: query
          required: false
          description: "Nome da mãe"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/nome:
    get:
      operationId: "get_consulta_nome"
      summary: "Homônimos (mesmo nome)"
      description: "Campos exigidos na chave (um deles): cpf.homonimos_uf."
      parameters:
        - name: "nome"
          in: query
          required: false
          description: "Nome"
          schema: {type: string}
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "cidade"
          in: query
          required: false
          description: "Cidade (opcional)"
          schema: {type: string}
        - name: "ano"
          in: query
          required: false
          description: "Ano de nascimento (opcional)"
          schema: {type: string}
        - name: "mae"
          in: query
          required: false
          description: "Nome da mãe (opcional)"
          schema: {type: string}
        - name: "dataNasc"
          in: query
          required: false
          description: "Data de nascimento (opcional)"
          schema: {type: string}
        - name: "cpf_inicio"
          in: query
          required: false
          description: "Primeiros 5+ dígitos do CPF (opcional)"
          schema: {type: string}
        - name: "cpf_meio"
          in: query
          required: false
          description: "6 dígitos do meio do CPF (opcional)"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/titulo:
    get:
      operationId: "get_consulta_titulo"
      summary: "Título de Eleitor"
      description: "Campos exigidos na chave (um deles): cpf.titulo."
      parameters:
        - name: "tituloEleitor"
          in: query
          required: false
          description: "Título de eleitor"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/rg:
    get:
      operationId: "get_consulta_rg"
      summary: "RG"
      description: "Campos exigidos na chave (um deles): cpf.rg."
      parameters:
        - name: "rg"
          in: query
          required: false
          description: "RG"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/pis:
    get:
      operationId: "get_consulta_pis"
      summary: "PIS e NIS"
      description: "Campos exigidos na chave (um deles): cpf.rg."
      parameters:
        - name: "pis"
          in: query
          required: false
          description: "PIS ou NIS"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/endereco:
    get:
      operationId: "get_consulta_endereco"
      summary: "Endereço"
      description: "Campos exigidos na chave (um deles): cpf.vizinhos."
      parameters:
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "logradouro"
          in: query
          required: false
          description: "Logradouro (5+ letras)"
          schema: {type: string}
        - name: "cidade"
          in: query
          required: false
          description: "Cidade"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/cep:
    get:
      operationId: "get_consulta_cep"
      summary: "CEP (moradores e região)"
      description: "Campos exigidos na chave (um deles): cpf.vizinhos."
      parameters:
        - name: "cep"
          in: query
          required: false
          description: "CEP"
          schema: {type: string}
        - name: "nome"
          in: query
          required: false
          description: "Sobrenome (opcional)"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/placa:
    get:
      operationId: "get_consulta_placa"
      summary: "Placa"
      description: "Campos exigidos na chave (um deles): cpf.veiculos, cnpj.veiculos."
      parameters:
        - name: "placa"
          in: query
          required: false
          description: "Placa"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/placamassa:
    get:
      operationId: "get_consulta_placamassa"
      summary: "Placas em lote"
      description: "Campos exigidos na chave (um deles): avulso.placamassa."
      parameters:
        - name: "placas"
          in: query
          required: false
          description: "Placas (até 50, separadas por vírgula ou linha)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/veiculos_cpf:
    get:
      operationId: "get_consulta_veiculos_cpf"
      summary: "Veículos por CPF"
      description: "Campos exigidos na chave (um deles): cpf.veiculos, cnpj.veiculos."
      parameters:
        - name: "cpf"
          in: query
          required: false
          description: "CPF"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/veiculos_busca:
    get:
      operationId: "get_consulta_veiculos_busca"
      summary: "Busca marca e modelo"
      description: "Campos exigidos na chave (um deles): avulso.veiculos_busca."
      parameters:
        - name: "marca"
          in: query
          required: false
          description: "Marca ou modelo"
          schema: {type: string}
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "ano_min"
          in: query
          required: false
          description: "Ano mínimo"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/google:
    get:
      operationId: "get_consulta_google"
      summary: "Google Account"
      description: "Campos exigidos na chave (um deles): cpf.google, cnpj.google."
      parameters:
        - name: "email"
          in: query
          required: false
          description: "E-mail Google"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/gerador:
    get:
      operationId: "get_consulta_gerador"
      summary: "Gerador de Leads"
      description: "Campos exigidos na chave (um deles): avulso.gerador."
      parameters:
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "sexo"
          in: query
          required: false
          description: "Sexo"
          schema: {type: string}
        - name: "idade_min"
          in: query
          required: false
          description: "Idade mínima"
          schema: {type: string}
        - name: "idade_max"
          in: query
          required: false
          description: "Idade máxima"
          schema: {type: string}
        - name: "renda_min"
          in: query
          required: false
          description: "Renda mínima (em reais)"
          schema: {type: string}
        - name: "renda_max"
          in: query
          required: false
          description: "Renda máxima (em reais)"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/renda:
    get:
      operationId: "get_consulta_renda"
      summary: "Renda"
      description: "Campos exigidos na chave (um deles): cpf.mesma_renda."
      parameters:
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "sexo"
          in: query
          required: false
          description: "Sexo"
          schema: {type: string}
        - name: "idade_min"
          in: query
          required: false
          description: "Idade mínima"
          schema: {type: string}
        - name: "idade_max"
          in: query
          required: false
          description: "Idade máxima"
          schema: {type: string}
        - name: "min"
          in: query
          required: false
          description: "Renda mínima (em reais)"
          schema: {type: string}
        - name: "max"
          in: query
          required: false
          description: "Renda máxima (em reais)"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/cbo:
    get:
      operationId: "get_consulta_cbo"
      summary: "Mesma ocupação (CBO e profissão)"
      description: "Campos exigidos na chave (um deles): cpf.mesmo_cbo."
      parameters:
        - name: "cbo"
          in: query
          required: false
          description: "Código CBO (4+ dígitos)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/profissionais:
    get:
      operationId: "get_consulta_profissionais"
      summary: "Profissionais"
      description: "Campos exigidos na chave (um deles): cpf.profissionais."
      parameters:
        - name: "nome"
          in: query
          required: false
          description: "Nome"
          schema: {type: string}
        - name: "email"
          in: query
          required: false
          description: "E-mail"
          schema: {type: string}
        - name: "profissao"
          in: query
          required: false
          description: "Profissão"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/estado:
    get:
      operationId: "get_consulta_estado"
      summary: "Estado"
      description: "Campos exigidos na chave (um deles): cpf.mesma_uf."
      parameters:
        - name: "uf"
          in: query
          required: false
          description: "UF"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/universitarios:
    get:
      operationId: "get_consulta_universitarios"
      summary: "Universitários"
      description: "Campos exigidos na chave (um deles): cpf.universitarios."
      parameters:
        - name: "nome"
          in: query
          required: false
          description: "Nome"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/operadora:
    get:
      operationId: "get_consulta_operadora"
      summary: "Operadora"
      description: "Campos exigidos na chave (um deles): cpf.operadora, cnpj.operadora."
      parameters:
        - name: "telefone"
          in: query
          required: false
          description: "Telefone com DDD"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/telefone_ddd:
    get:
      operationId: "get_consulta_telefone_ddd"
      summary: "Telefone por DDD"
      description: "Campos exigidos na chave (um deles): cpf.mesmo_ddd."
      parameters:
        - name: "ddd"
          in: query
          required: false
          description: "DDD"
          schema: {type: string}
        - name: "limit"
          in: query
          required: false
          description: "Quantidade máxima de resultados"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Opcional: códigos dos campos desta rota, separados por vírgula, para limitar a consulta e a cobrança a eles (só com cpf ou cnpj)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/bin:
    get:
      operationId: "get_consulta_bin"
      summary: "BIN"
      description: "Campos exigidos na chave (um deles): avulso.bin."
      parameters:
        - name: "bin"
          in: query
          required: false
          description: "BIN (6 a 8 dígitos)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/banco:
    get:
      operationId: "get_consulta_banco"
      summary: "Banco"
      description: "Campos exigidos na chave (um deles): avulso.banco."
      parameters:
        - name: "codigo"
          in: query
          required: false
          description: "Código do banco"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /consulta/random:
    get:
      operationId: "get_consulta_random"
      summary: "Aleatório"
      description: "Campos exigidos na chave (um deles): avulso.random."
      parameters:
        - name: "uf"
          in: query
          required: false
          description: "UF (opcional)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /personalizada:
    get:
      operationId: "get_personalizada"
      summary: "Consulta personalizada (Monte sua busca)"
      description: "Campos escolhidos por chamada, entre os habilitados na chave (sem campos, valem os campos da chave para o documento, sem o cadastro, que só entra se for pedido em campos ou for o único campo da chave). O cadastro só é cobrado quando pedido; sem ele, roda só como base interna, sem cobrança e sem dados cadastrais no resultado. Cobra só os campos que voltaram resultado."
      parameters:
        - name: "cpf"
          in: query
          required: false
          description: "CPF (ou use cnpj)"
          schema: {type: string}
        - name: "cnpj"
          in: query
          required: false
          description: "CNPJ (ou use cpf)"
          schema: {type: string}
        - name: "campos"
          in: query
          required: false
          description: "Códigos dos campos, separados por vírgula (opcional: sem ele, todos os campos da chave)"
          schema: {type: string}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
    post:
      operationId: "post_personalizada"
      summary: "Consulta personalizada (Monte sua busca)"
      description: "Campos escolhidos por chamada, entre os habilitados na chave (sem campos, valem os campos da chave para o documento, sem o cadastro, que só entra se for pedido em campos ou for o único campo da chave). O cadastro só é cobrado quando pedido; sem ele, roda só como base interna, sem cobrança e sem dados cadastrais no resultado. Cobra só os campos que voltaram resultado."
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required: [campos]
              properties:
                cpf: {type: string}
                cnpj: {type: string}
                campos: {type: array, items: {type: string}}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '404': {$ref: '#/components/responses/E404'}
        '422': {$ref: '#/components/responses/E422'}
        '429': {$ref: '#/components/responses/E429'}
        '502': {$ref: '#/components/responses/E502'}
        '503': {$ref: '#/components/responses/E503'}
  /lote:
    post:
      operationId: "post_lote"
      summary: "Consulta em lote"
      description: "Consulta em lote de CPF, CNPJ, telefone e e-mail. Sem confirmar, devolve a leitura e o custo estimado e não debita. Com confirmar, o saldo precisa cobrir a estimativa. Cada item com resultado debita o produto escolhido no catálogo; sem resultado, não há débito. A mesma consulta já cobrada hoje não é debitada de novo. Cada envio aceita até 5000 documentos."
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                texto: {type: string}
                documentos: {type: array, items: {type: string}}
                arquivo_base64: {type: string}
                card_cpf: {type: string}
                card_cnpj: {type: string}
                card_telefone: {type: string}
                card_email: {type: string}
                confirmar: {type: boolean}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '413': {$ref: '#/components/responses/E413'}
        '422': {$ref: '#/components/responses/E422'}
  /lote/{id}:
    get:
      operationId: "get_lote"
      summary: "Andamento do lote"
      parameters:
        - {name: id, in: path, required: true, schema: {type: string}}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '404': {$ref: '#/components/responses/E404'}
  /lote/{id}/confirmar:
    post:
      operationId: "post_lote_confirmar"
      summary: "Confirma e inicia o lote"
      parameters:
        - {name: id, in: path, required: true, schema: {type: string}}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [confirmar]
              properties:
                card_cpf: {type: string}
                card_cnpj: {type: string}
                card_telefone: {type: string}
                card_email: {type: string}
                confirmar: {type: boolean}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
        '402': {$ref: '#/components/responses/E402'}
        '403': {$ref: '#/components/responses/E403'}
        '422': {$ref: '#/components/responses/E422'}
  /lote/{id}/linhas:
    get:
      operationId: "get_lote_linhas"
      summary: "Tabela do lote"
      parameters:
        - {name: id, in: path, required: true, schema: {type: string}}
        - {name: offset, in: query, schema: {type: integer}}
        - {name: limit, in: query, schema: {type: integer}}
        - {name: status, in: query, schema: {type: string}}
        - {name: tipo, in: query, schema: {type: string}}
        - {name: q, in: query, schema: {type: string}}
        - {name: coluna, in: query, schema: {type: string}}
        - {name: dir, in: query, schema: {type: string}}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
  /lote/{id}/avancar:
    post:
      operationId: "post_lote_avancar"
      summary: "Retoma o processamento do lote"
      parameters:
        - {name: id, in: path, required: true, schema: {type: string}}
      responses:
        '200': {$ref: '#/components/responses/Ok'}
        '401': {$ref: '#/components/responses/E401'}
components:
  securitySchemes:
    Bearer: {type: http, scheme: bearer, description: "Authorization: Bearer <chave>"}
    ChaveApi: {type: apiKey, in: header, name: X-API-Key}
  schemas:
    Erro:
      type: object
      required: [ok, erro]
      properties:
        ok: {const: false}
        erro:
          type: object
          required: [codigo, mensagem]
          properties:
            codigo: {type: string}
            mensagem: {type: string}
            campos: {type: array, items: {type: string}}
  responses:
    Ok:
      description: "Se a pesquisa não retornar resultado, ela não é cobrada. Resultado da consulta (só as seções com resultado), com o que foi cobrado (cobrado: true/false)."
      content:
        application/json:
          schema: {type: object, additionalProperties: true}
    E401:
      description: "Chave ausente, inválida ou de formato antigo."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E402:
      description: "Saldo insuficiente na conta dona da chave. Nada é consultado."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E403:
      description: "Chave revogada, sem campos ou sem os campos exigidos pela rota. Nada é consultado nem cobrado."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E404:
      description: "Rota inexistente."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E413:
      description: "O envio da lista passa do tamanho aceito. Divida o arquivo. Nada é consultado."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E422:
      description: "Parâmetro ausente, a mais ou inválido."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E429:
      description: "Muitas chamadas seguidas com a mesma chave. Aguarde o tempo de Retry-After."
      headers:
        Retry-After: {description: Segundos até poder repetir a chamada., schema: {type: integer}}
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E502:
      description: "A fonte de dados não respondeu. Nada é cobrado."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}
    E503:
      description: "API indisponível no momento."
      content:
        application/json:
          schema: {$ref: '#/components/schemas/Erro'}