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

# Licitacoes por CNPJ

> Busca todas as licitacoes publicas em que o CNPJ participou. Retorna dados completos de cada licitacao incluindo itens e demais participantes.



## OpenAPI

````yaml /openapi/licitacoes.json get /licitacoes/cnpj/{cnpj}
openapi: 3.0.0
info:
  title: Sherlocker Licitacoes API
  description: Consulta de licitacoes e contratos publicos
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /licitacoes/cnpj/{cnpj}:
    get:
      tags:
        - Licitacoes
      summary: Licitacoes por CNPJ
      description: >-
        Busca todas as licitacoes publicas em que o CNPJ participou. Retorna
        dados completos de cada licitacao incluindo itens e demais
        participantes.
      operationId: getLicitacoesByCnpj
      parameters:
        - name: cnpj
          in: path
          required: true
          schema:
            type: string
            example: '12345678000199'
      responses:
        '200':
          description: Licitacoes encontradas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LicitacoesResponse'
        '400':
          description: Parametro invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Token ausente ou invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    LicitacoesResponse:
      type: object
      properties:
        documento:
          type: string
          description: >-
            Documento consultado, apenas digitos (sem formatacao). Observacao:
            difere de participantes[].documento, que vem formatado.
        total:
          type: number
          description: Total de licitacoes encontradas
        licitacoes:
          type: array
          items:
            $ref: '#/components/schemas/Licitacao'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        erro:
          type: object
          properties:
            codigo:
              type: string
              example: VALIDATION_ERROR
            mensagem:
              type: string
              example: CPF invalido
    Licitacao:
      type: object
      properties:
        id:
          type: string
          format: uuid
        id_licitacao:
          type: string
          description: Numero da licitacao no sistema de origem
        id_pregao:
          type: string
          description: Numero do pregao. String vazia quando ausente na fonte (nunca null).
        id_uasg:
          type: string
          description: Codigo UASG do orgao
        titulo:
          type: string
          description: Titulo do edital
        descricao:
          type: string
          description: Descricao do objeto da licitacao
        fonte:
          type: string
          example: PNCP
          description: Fonte dos dados
        modalidade:
          type: string
          example: Pregao Eletronico
          description: Modalidade de contratacao
        tipo_disputa:
          type: string
          example: Aberto
          description: Tipo de disputa
        data_publicacao:
          type: string
          format: date
          description: Data de publicacao
        data_inicio:
          type: string
          format: date
          description: Data de inicio da vigencia
        data_fim:
          type: string
          format: date
          description: Data de fim da vigencia
        uf:
          type: string
          example: SP
          description: UF do orgao
        local:
          type: string
          example: Sao Paulo
          description: Municipio do orgao
        exclusivoMEEPP:
          type: boolean
          description: Exclusivo para ME/EPP
        items:
          type: array
          description: Itens da licitacao
          items:
            $ref: '#/components/schemas/LicitacaoItem'
        participantes:
          type: array
          description: Todos os participantes da licitacao
          items:
            $ref: '#/components/schemas/LicitacaoParticipante'
    LicitacaoItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: ID interno da licitacao
        codigo:
          type: string
          description: Codigo do item
        descricao:
          type: string
          description: Descricao do item
        quantidade:
          type: number
          description: Quantidade
        valor_total:
          type: number
          description: Valor total em reais
        decreto7174:
          type: boolean
        exclusivoMEEPP:
          type: boolean
          description: Exclusivo para ME/EPP
    LicitacaoParticipante:
      type: object
      properties:
        id:
          type: string
          format: uuid
        documento:
          type: string
          description: >-
            CPF ou CNPJ do participante, formatado (ex: 039.167.186-30).
            Observacao: difere do campo documento no nivel raiz da resposta, que
            vem apenas com digitos.
        nome:
          type: string
          description: Nome ou razao social
        tipo:
          type: string
          enum:
            - PF
            - PJ
          description: Tipo de pessoa
        totalLicitacoes:
          type: number
          description: Total de licitacoes do participante
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````