Create a billing meter event with asynchronous validation v2

Creates meter events. Events are processed asynchronously, including validation. Requires a meter event session for authentication. Supports up to 10,000 requests per second in livemode. For even higher rate-limits, contact sales.

Learn more about calling API v2 endpoints.

Parameters

  • eventsarray of objectsRequired

    List of meter events to include in the request.

Returns

Response attributes

No response attributes.

Error Codes
401billing_meter_event_session_expired

The temporary session token has expired.

POST /v2/billing/meter_event_stream
curl -X POST https://meter-events.stripe.com/v2/billing/meter_event_stream \
-H "Authorization: Bearer {{SESSION AUTH TOKEN}}" \
-H "Stripe-Version: 2025-07-30.preview" \
--json '{
"events": [
{
"identifier": "idmp_12345678",
"event_name": "ai_search_api",
"timestamp": "2024-06-01T12:00:00.000Z",
"payload": {
"stripe_customer_id": "cus_12345678",
"value": "25"
}
}
]
}'
Response
{}

Meter Event Summary 

A billing meter event summary represents an aggregated view of a customer’s billing meter events within a specified timeframe. It indicates how much usage was accrued by a customer for that period.

Note: Meters events are aggregated asynchronously so the meter event summaries provide an eventually consistent view of the reported usage.

Credit Grant 

Credit Balance Summary 

Indicates the billing credit balance for billing credits granted to a customer.

Credit Balance Transaction 

A credit balance transaction is a resource representing a transaction (either a credit or a debit) against an existing credit grant.