Create a meter price
Create a usage price for a meter with a specific pricing model (per_unit, graduated, volume, or package).
Related endpoints
GET /meters— List metersPOST /meters— Create a meterGET /meters/{id}— Get a meterPATCH /meters/{id}— Update a meterGET /meters/{meterId}/prices— List meter pricesPATCH /meters/{meterId}/prices/{priceId}— Update a meter pricePOST /meters/{meterId}/prices/{priceId}/deactivate— Deactivate a meter price
Common errors
400 invalid_request— malformed payload or failed validation.401 unauthenticated— missing, malformed, or revoked API key.404 resource_missing— the referenced resource does not exist or is not visible to your key.
Idempotency
Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.
Authorization
apiKey Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.
In: header
Path Parameters
Meter ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.revkeen.com/v2/meters/string/prices" \ -H "x-api-key: $REVKEEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "pricing_model": "per_unit", "currency": "GBP", "unit_amount_minor": 100, "flat_fee_minor": 0, "package_size": 100, "cost_per_unit_minor": 5, "tiers": [ { "first_unit": 1, "last_unit": 1000, "unit_amount_minor": 10, "flat_amount_minor": 0 } ] }'{
"data": {
"property1": null,
"property2": null
}
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}