> ## 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.

# Lista o catálogo de serviços

> Lista os serviços ativos do catálogo interno, até 100 itens, sem paginação.



## OpenAPI

````yaml /referencia/openapi.json get /v1/services
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/services:
    get:
      tags:
        - services
      summary: Lista o catálogo de serviços
      description: >-
        Lista os serviços ativos do catálogo interno, até 100 itens, sem
        paginação.
      operationId: PublicServicesController_list
      parameters: []
      responses:
        '200':
          description: Catálogo de serviços ativos
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                  - errors
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicServiceSummary'
                  meta:
                    type: object
                    description: Metadados da resposta — vazio nesta operação.
                    properties: {}
                  errors:
                    type: array
                    description: Sempre vazio numa resposta de sucesso.
                    items:
                      type: object
                    maxItems: 0
              example:
                data:
                  - id: 7
                    name: Reboque leve
                    category: AUTO
                  - id: 12
                    name: Chaveiro automotivo
                    category: AUTO
                meta: {}
                errors: []
        '401':
          description: INVALID_TOKEN
          content:
            application/json:
              example:
                data: null
                errors:
                  - code: INVALID_TOKEN
                    message: Token inválido.
        '403':
          description: INSUFFICIENT_SCOPE
          content:
            application/json:
              example:
                data: null
                errors:
                  - code: INSUFFICIENT_SCOPE
                    message: Escopo insuficiente para este endpoint.
                    details:
                      requiredScope: attendances.read
        '429':
          description: RATE_LIMITED
          content:
            application/json:
              example:
                data: null
                errors:
                  - code: RATE_LIMITED
                    message: Limite de requisições excedido.
                    details:
                      retryAfterSeconds: 42
        '503':
          description: FEATURE_DISABLED
          content:
            application/json:
              example:
                data: null
                errors:
                  - code: FEATURE_DISABLED
                    message: 'Feature is disabled: public_api.enabled'
      security:
        - apiToken: []
components:
  schemas:
    PublicServiceSummary:
      type: object
      properties:
        id:
          type: integer
          format: int32
          description: Identificador do serviço no catálogo.
        name:
          type: string
          description: Nome do serviço.
        category:
          type: string
          enum:
            - AUTO
            - RESIDENCIAL
            - PET
            - MONTAGEM
            - SAUDE
            - FUNERARIA_PET
            - FUNERAL
            - PESSOA_E_BEM_ESTAR
            - SUPORTE
            - VIAGEM
            - VIDA
          description: >-
            Categoria do serviço: AUTO (automotivo), RESIDENCIAL, PET, MONTAGEM,
            SAUDE, FUNERARIA_PET, FUNERAL, PESSOA_E_BEM_ESTAR, SUPORTE, VIAGEM
            ou VIDA.
      required:
        - id
        - name
        - category
  securitySchemes:
    apiToken:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: >-
        Token de curta duração devolvido por POST /v1/auth/token, carregando os
        escopos concedidos à chave — exigido por todo endpoint de dados.

````

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