Core Resources
Payment Methods
Products
Commerce
Agentic Commerce
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Payment Records
Account Evaluation
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Meter Event Streams v2

You can send a higher-throughput of meter events using meter event streams. For this flow, you must first create a meter event session, which provides you with a session token. You can then create meter events through the meter event stream endpoint, using the session token for authentication. The session tokens are short-lived and you need to create a new meter event session when the token expires.

Learn more about calling API v2 endpoints.
Was this section helpful?YesNo
Create a Meter Event Stream Authentication Session
POST/v2/billing/meter_event_session
Create a Meter Event with asynchronous validation
POST/v2/billing/meter_event_stream

The Meter Event Session object v2

Attributes

  • idstring

    The unique ID of this auth session.

  • objectstring, value is "v2.billing.meter_event_session"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • authentication_tokenstring

    The authentication token for this session. Use this token when calling the high-throughput meter event API.

  • createdtimestamp

    The creation time of this session.

  • expires_attimestamp

    The time at which this session expires.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

The Meter Event Session object
{
  "id": "<AUTH_SESSION_ID>",
  "livemode": false,
  "object": "v2.billing.meter_event_session",
  "authentication_token": "token_12345678",
  "created": "2024-06-01T12:00:00.000Z",
  "expires_at": "2024-06-01T12:15:00.000Z"
}

Create a Meter Event Stream Authentication Session v2

Creates a meter event session to send usage on the high-throughput meter event stream. Authentication tokens are only valid for 15 minutes, so you need to create a new meter event session when your token expires.

Learn more about calling API v2 endpoints.

Parameters

No parameters.

Returns

Response attributes

  • idstring

    The unique ID of this auth session.

  • objectstring, value is "v2.billing.meter_event_session"

    String representing the object’s type. Objects of the same type share the same value of the object field.

  • authentication_tokenstring

    The authentication token for this session. Use this token when calling the high-throughput meter event API.

  • createdtimestamp

    The creation time of this session.

  • expires_attimestamp

    The time at which this session expires.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

curl -X POST https://api.stripe.com/v2/billing/meter_event_session \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2026-05-27.dahlia"
Response
{
  "id": "<AUTH_SESSION_ID>",
  "livemode": false,
  "object": "v2.billing.meter_event_session",
  "authentication_token": "token_12345678",
  "created": "2024-06-01T12:00:00.000Z",
  "expires_at": "2024-06-01T12:15:00.000Z"
}