---
# @generated by sylphx-gen 0.1.0 from contracts@190f1b33b937c1aef79697684018db853389b521c75e19ff69ac6af609e96f45. Do not edit.
title: "Usage events"
description: "The `usage_events` collection of Sylphx Money: A Usage Event is rated usage, immutable: what a settled reservation or a direct record produced."
type: reference
product: payments
summary: "A Usage Event is rated usage, immutable: what a settled reservation or a direct record produced."
updated: 2026-09-28
order: 900
---

A Usage Event is rated usage, immutable: what a settled reservation or a direct record produced.

**Service** Sylphx Money · **Resource type** `money.sylphx.com/UsageEvent` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/usage_events/{usage_event}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/usage_events/{usage_event}`. |
| `uid` | `string` | `uevt_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `subject` | `Subject` | Who used it. Required. |
| `subject_proof` | `string` | As on UsageReservation. Required. |
| `actor_proof` | `string` | As on UsageReservation. |
| `meter` | `string` | The meter's lookup key. Required. |
| `quantity` | `int64` | How much, in the meter's base unit. Required. |
| `occurred_time` | `timestamp` | When the work happened. Required. |
| `amount_nano` | `string` | The rated amount, nano-minor, a decimal string. Output only. |
| `usage_reservation` | `string` | The reservation it settled, when it did. Output only. |
| `late` | `bool` | Settled after the reservation expired; the usage is still recorded. 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 |
| --- | --- | --- |
| `POST` | [`create`](/docs/api/usage_events#create) | Records usage directly, only for a meter the merchant marked reservation-optional. |
| `GET` | [`list`](/docs/api/usage_events#list) | Lists usage events, newest first. |
| `POST` | [`check_standing`](/docs/api/usage_events#check-standing) | Reads a subject's standing: active, past due or suspended, whether a payment method is on file, headroom and the threshold. |

## create

Records usage directly, only for a meter the merchant marked reservation-optional.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/usage_events` · scope `billing:metering:write` · effect `write` · [Request, response and examples](/docs/api/usage_events/create)

## list

Lists usage events, newest first.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/usage_events` · scope `billing:read` · effect `read` · paginated · [Request, response and examples](/docs/api/usage_events/list)

## check_standing

Reads a subject's standing: active, past due or suspended, whether a payment method is on file, headroom and the threshold.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/usage_events:checkStanding` · scope `billing:read` · effect `read` · [Request, response and examples](/docs/api/usage_events/check_standing)