---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Meters"
description: "The `meters` collection of Sylphx Billing: A Meter is one billable quantity a service emits, for example `hosting.vcpu_seconds`."
type: reference
product: platform
summary: "A Meter is one billable quantity a service emits, for example `hosting.vcpu_seconds`."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

A Meter is one billable quantity a service emits, for example `hosting.vcpu_seconds`. Meters are top-level and read-only; each has immutable versions, and a usage event names the version it was measured under.

**Service** Sylphx Billing · **Resource type** `billing.sylphx.com/Meter` · **Name pattern** `meters/{meter}` · **Shape** `record`

**Not available yet.** Sylphx Billing is declared in the registry but no backend serves it: every call answers `501` with the problem code `UNIMPLEMENTED`.

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `meters/{meter}`, where `{meter}` is the meter id `{service}.{quantity}`, for example `meters/hosting.vcpu_seconds`. |
| `uid` | `string` | `mtr_<cell><ulid>`. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. Output only. |
| `service` | `string` | The service that emits the meter; the meter id's prefix. Output only. |
| `current_version` | `int32` | The version new usage is measured under. Output only. |
| `versions` | `MeterVersion[]` | Every version, oldest first. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/meters#get) | Gets a meter. |
| `GET` | [`list`](/docs/api/meters#list) | Lists meters. Anonymous-readable: the pricing page renders from it. |

## get

Gets a meter.

`GET https://api.sylphx.com/v1/meters/meter` · scope `billing:read` · effect `read` · not available yet · callable with a publishable key · [Request, response and examples](/docs/api/meters/get)

## list

Lists meters. Anonymous-readable: the pricing page renders from it.

`GET https://api.sylphx.com/v1/meters` · scope `billing:read` · effect `read` · not available yet · callable with a publishable key · paginated · [Request, response and examples](/docs/api/meters/list)