KometricsDocsBack to site

Changelog

Breaking changes, new endpoints and new fields, newest first.

The API is versioned in its path. Additive changes, such as a new field on an existing response, ship without a version bump, so parse defensively and ignore fields you do not recognise.

2026-08-16

  • The API moved to its own host. Every endpoint now hangs off https://api.kometrics.com/v1, with the version leading the path.
  • New: the MCP connector at https://app.kometrics.com/mcp, for Claude, ChatGPT and any other MCP client.
  • It implements the stateless 2026-07-28 revision and answers the handshake-based revisions back to 2025-03-26.
  • Authentication is OAuth 2.1 with dynamic client registration, or a workspace API key sent as a bearer token.
  • The workspace each assistant reads is chosen on the approval screen and changed under Settings, API.

2026-08-14

  • New endpoint: GET /past-due lists the customers in dunning and the MRR they carry.
  • New filter on GET /customers: country, an exact ISO 3166-1 alpha-2 match, case insensitive.

2026-08-13

  • Documentation rewritten from the route handlers and moved to /docs.

v1

  • Account, metrics, customers and activities endpoints.
  • Cursor pagination on the two list endpoints.
  • OpenAPI 3.1 description at /openapi.json.