---
title: "Record Metered Usage"
method: POST
path: "/api/v2/metered_subscriptions/record"
tags: ["Metered Subscriptions"]
---

# Record Metered Usage

`POST /api/v2/metered_subscriptions/record`

Record metered usage events in bulk

## Request body

- MeterUsageBulkRequest — Request to record multiple usage events in bulk.
  - `records` MeterUsageRecordRequest[], required — List of usage records to record
    - `product_id` string, uuid, required — METERED product ID
    - `organization_consumer_id` string, uuid, required — Organization consumer ID
    - `usage_amount` integer, required — Usage quantity in whole units
    - `source_event_id` string, required — Stable source event ID used to prevent duplicate usage records

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)