openapi: 3.1.0
info:
  title: Cobli API
  version: '2026-10-09'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-09: 2 operation(s) read from 15 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Cobli has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 2
    pages-with-code: 0
    pages-read: 15
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-09'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.cobli.co/reference/eta.md
  - https://docs.cobli.co/reference/paths.md
  - https://docs.cobli.co/reference/groups.md
  - https://docs.cobli.co/reference/devices.md
  - https://docs.cobli.co/reference/getfine.md
  - https://docs.cobli.co/reference/vehicle.md
  - https://docs.cobli.co/reference/webhooksos
  - https://docs.cobli.co/reference/pocs-get.md
  - https://docs.cobli.co/reference/vehicles.md
  - https://docs.cobli.co/reference/webhookyawn
  - https://docs.cobli.co/reference/costsfuel.md
  - https://docs.cobli.co/reference/getroutes.md
  - https://docs.cobli.co/reference/listfines.md
  - https://docs.cobli.co/reference/listparts.md
  - https://docs.cobli.co/reference/telemetry.md
servers:
- url: https://api.cobli.co
paths:
  /public/v1/paths:
    get:
      operationId: get_public_v1_paths
      tags:
      - Public
      summary: Detalhes de trajetos e paradas
      description: 'Acompanhe todos os dados de trajetos e paradas da sua frota.

        Com esse endpoint, você pode:

        - Saber cada trajeto e parada que o veículo fez, com os endereços iniciais e finais;

        - Saber o tempo parado em cada parada e o tempo de motor ocioso;

        - Saber a distância percorrida e o tempo de cada trajeto

        - Saber se a parada foi realizada em um local de interesse;

        - Saber o total estimado de combustível gasto;

        - Saber o custo de combustível de cada trajeto e de motor ocioso'
      x-source: https://docs.cobli.co/reference/paths.md
      parameters:
      - name: startDate
        in: query
        required: true
        schema:
          type: string
        description: Data inicial da coleta de dados
      - name: endDate
        in: query
        required: true
        schema:
          type: string
        description: Data limite da coleta de dados
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Número de itens presentes na resposta. **O limite máximo de resposta é 2000, qualquer valor acima não será aceito.**
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Página da resposta, baseada no limite da resposta da requisição
      - name: deviceIds
        in: query
        required: false
        schema:
          type: string
        description: Filtro de busca que retorna somente informações dos dispositivos presentes na lista passada
      - name: groups
        in: query
        required: false
        schema:
          type: string
        description: Filtro de busca que retorna somente informações dos veículos pertencentes aos grupos listados
      - name: licensePlates
        in: query
        required: false
        schema:
          type: string
        description: Filtro de busca que retorna somente informações dos veículos com as placas passadas
      - name: timezone
        in: query
        required: false
        schema:
          type: string
        description: Fuso horário em que a frota opera - (Exemplo `America/Sao_Paulo`)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPublicV1PathsResponse'
      x-evidence:
        kind: documentation
  /public/v2/events:
    get:
      operationId: get_public_v2_events
      tags:
      - Public
      summary: Use GET /public/v2/events to reconcile deliveries of the last 15 days.
      x-source: https://docs.cobli.co/reference/vehicle.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetPublicV1PathsResponse:
      type: object
      properties:
        '200':
          type: string
          description: Lista de Trajetos retornada com sucesso
        '401':
          type: string
          description: Chave API inválida ou ausente
        '404':
          type: string
          description: Página não encontrada
        '500':
          type: string
          description: Erro no servidor
tags:
- name: Public