---
# @generated by sylphx-gen 0.1.0 from contracts@190f1b33b937c1aef79697684018db853389b521c75e19ff69ac6af609e96f45. Do not edit.
title: "Usage meter prices"
description: "The `usage_meter_prices` collection of Sylphx Money: A Usage Meter Price is one entry of a meter's append-only price history."
type: reference
product: payments
summary: "A Usage Meter Price is one entry of a meter's append-only price history."
updated: 2026-09-28
order: 900
---

A Usage Meter Price is one entry of a meter's append-only price history. A price applies from `effective_time` on, so a change never rewrites usage already rated.

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

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/usage_meter_prices/{usage_meter_price}`. |
| `uid` | `string` | `umpr_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `meter` | `string` | The meter's key. Required. |
| `currency_code` | `string` | ISO 4217; it must be the environment's currency. Required. |
| `unit_price_nano` | `string` | List price of one unit, nano-minor (a billionth of a minor unit), a decimal string. Required. |
| `effective_time` | `timestamp` | When it starts applying; now when absent. Not in the past, and after the meter's latest price. |
| `tax_code` | `string` | The processor's tax code for the usage line; empty for the merchant's default. |

## 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_meter_prices#create) | Appends a price to a meter's history. It applies from its effective time on and never rewrites usage already rated. |
| `GET` | [`list`](/docs/api/usage_meter_prices#list) | Lists meter prices, newest first; filter by `meter`. |

## create

Appends a price to a meter's history. It applies from its effective time on and never rewrites usage already rated.

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

## list

Lists meter prices, newest first; filter by `meter`.

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