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

# Especificação OpenAPI da API pública

> Devolve o documento OpenAPI 3 gerado a partir do código: rotas, schemas de entrada, projeções de resposta, escopos e catálogo de erros da API pública (/v1/...). Nunca um arquivo mantido em paralelo.



## OpenAPI

````yaml /referencia/openapi.json get /v1/openapi.json
openapi: 3.0.0
info:
  title: Koolisys — API Pública
  description: >-
    Contrato da API pública de integração da Koolisys: atendimentos, catálogo de
    serviços, elegibilidade, cadastro e consulta de clientes e veículos e a
    própria contratante. Gerada a partir do código — rotas, DTOs de entrada,
    projeções de resposta e escopos declarados —, nunca mantida à mão.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api-koolisys.eixoassistencia.com.br
    description: API pública da Koolisys
security: []
tags:
  - name: auth
    description: Emissão do token de curta duração a partir da chave de API
  - name: attendances
    description: Abertura, consulta e listagem de atendimentos
  - name: services
    description: Catálogo de serviços disponíveis
  - name: eligibility
    description: Consulta de elegibilidade de cliente e veículo
  - name: customers
    description: Cadastro, consulta, busca e listagem de clientes da contratante
  - name: vehicles
    description: Consulta e listagem de veículos da contratante
  - name: company
    description: 'A própria contratante: contratos vigentes e planos disponíveis'
  - name: meta
    description: A própria especificação
paths:
  /v1/openapi.json:
    get:
      tags:
        - meta
      summary: Especificação OpenAPI da API pública
      description: >-
        Devolve o documento OpenAPI 3 gerado a partir do código: rotas, schemas
        de entrada, projeções de resposta, escopos e catálogo de erros da API
        pública (/v1/...). Nunca um arquivo mantido em paralelo.
      operationId: OpenApiController_getSpecification
      parameters: []
      responses:
        '200':
          description: Documento OpenAPI 3
          content:
            application/json:
              example:
                openapi: 3.0.0
                info:
                  title: Koolisys — API Pública
                  version: 1.0.0
                paths: {}
      security: []

````

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