Mezmo

Mezmo Usage API

Query log usage by app, host, or tag via /v1/usage/{type} and detailed byte-based consumption via /v2/usage. Used for chargeback, anomaly detection, and capacity planning against ingestion contract volumes.

Mezmo Usage API is one of 12 APIs that Mezmo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Usage, Billing, Reporting, and FinOps. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.mezmo.com/log-analysis-api/reference/usage

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mezmo/refs/heads/main/openapi/mezmo-usage-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/mezmo/refs/heads/main/capabilities/usage-usage.yaml

OpenAPI Specification

mezmo-usage-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Mezmo Usage API
  description: |
    Query log usage by app, host, or tag for the account. V2 reports detailed
    byte-based consumption suitable for chargeback and FinOps.
  version: '2.0'
servers:
- url: https://api.mezmo.com
tags:
- name: Usage
security:
- AccessToken: []
paths:
  /v1/usage/{type}:
    get:
      tags:
      - Usage
      summary: Get Usage By Type
      operationId: getUsageByType
      parameters:
      - name: type
        in: path
        required: true
        schema:
          type: string
          enum:
          - apps
          - hosts
          - tags
      - name: from
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: to
        in: query
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Usage rollup by resource.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UsageEntry'
  /v2/usage:
    get:
      tags:
      - Usage
      summary: Get Detailed Usage
      operationId: getUsageDetailed
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: to
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: groupby
        in: query
        schema:
          type: string
          enum:
          - app
          - host
          - tag
          - level
      responses:
        '200':
          description: Detailed usage rollup with byte and line counts.
components:
  securitySchemes:
    AccessToken:
      type: http
      scheme: bearer
  schemas:
    UsageEntry:
      type: object
      properties:
        name:
          type: string
        bytes:
          type: integer
          format: int64
        lines:
          type: integer
          format: int64
        from:
          type: integer
          format: int64
        to:
          type: integer
          format: int64