Create a 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. Supports up to 100 events per 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: 2026-02-25.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

{}

Create a Meter Event with asynchronous validationÂ v2

Parameters

eventsarray of objectsRequired

Returns

Response attributes