List metered items v2

List all MeteredItem objects in reverse chronological order of creation.

Learn more about calling API v2 endpoints.

Parameters

limitinteger
Optionally set the maximum number of results per page. Defaults to 20.

pagestring
Opaque page token.

Returns

Response attributes

dataarray of objects
The retrieved MeteredItem objects.

next_page_urlnullable string
The URL of the next page of results, if there is one.

previous_page_urlnullable string
The URL of the previous page of results, if there is one.

GET /v2/billing/metered_items

Server-side language

curl https://api.stripe.com/v2/billing/metered_items \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-07-30.preview"

Response

{
  "data": [
    {
      "id": "bli_test_61SGRtYMvrf176Kmm16RM8VQESSQ4t1K5KYFAmKUSVdY",
      "object": "v2.billing.metered_item",
      "created": "2025-03-27T00:04:48.000Z",
      "display_name": "Premium Chat API",
      "lookup_key": null,
      "metadata": {},
      "meter": "mtr_test_61SD5KZ52hzuwbPJE41H5wvQ9UC0V34K",
      "unit_label": null,
      "livemode": true
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

MeteredItem event types v2

This is a list of all public thin events we currently send for updates to MeteredItem, which are continually evolving and expanding. The payload of thin events is unversioned. During processing, you must fetch the versioned event from the API or fetch the resource’s current state.

Event types

Type

Filter events by type

Type

v2.billing.metered_item.created

Occurs when a MeteredItem is created.

Attributes

idstring
Unique identifier for the event.

objectstring, value is "v2.core.event"
String representing the object’s type. Objects of the same type share the same value of the object field.

contextnullable string
Authentication context needed to fetch the event or related object.

createdtimestamp
Time at which the object was created.

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

reasonnullable object
Reason for the event.

related_objectnullable object
Object containing the reference to API resource relevant to the event.

typestring, value is "v2.billing.metered_item.created"
The type of the event.

Fetched attributes

dataobject
Additional data about the event.

Event payload

{
  "created": "2025-01-01T00:00:00.000Z",
  "id": "evt_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2BpA",
  "object": "v2.core.event",
  "type": "v2.billing.metered_item.created",
  "livemode": true,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2FpE",
      "idempotency_key": "idem_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2GpH"
    }
  },
  "related_object": {
    "id": "bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL",
    "type": "v2.billing.metered_item",
    "url": "/v2/billing/metered_items/bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL"
  }
}

Event handler

Server-side language

# Select a client library to see examples of
# parsing and retrieving event details.

Fetched payload

{
  "created": "2025-01-01T00:00:00.000Z",
  "id": "evt_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2BpA",
  "object": "v2.core.event",
  "type": "v2.billing.metered_item.created",
  "livemode": true,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2FpE",
      "idempotency_key": "idem_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2GpH"
    }
  },
  "related_object": {
    "id": "bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL",
    "type": "v2.billing.metered_item",
    "url": "/v2/billing/metered_items/bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL"
  },
  "data": {}
}

v2.billing.metered_item.updated

Occurs when a MeteredItem is updated.

Attributes

idstring
Unique identifier for the event.

objectstring, value is "v2.core.event"
String representing the object’s type. Objects of the same type share the same value of the object field.

contextnullable string
Authentication context needed to fetch the event or related object.

createdtimestamp
Time at which the object was created.

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

reasonnullable object
Reason for the event.

related_objectnullable object
Object containing the reference to API resource relevant to the event.

typestring, value is "v2.billing.metered_item.updated"
The type of the event.

Fetched attributes

dataobject
Additional data about the event.

Event payload

{
  "created": "2025-01-01T00:00:00.000Z",
  "id": "evt_65SJhYZDkX1uJ5gsI1Z16RuKJoESSQUtPVJKIgeI4D20zW",
  "object": "v2.core.event",
  "type": "v2.billing.metered_item.updated",
  "livemode": true,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_65SJhXZEhB4oQ0Csu16RuKJoESSQUtPVJKIgeI4D26Fi",
      "idempotency_key": "idem_65SJhWUFiC5pR1Dtv16RuKJoESSQUtPVJKIgeI4D27Gj"
    }
  },
  "related_object": {
    "id": "bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc",
    "type": "v2.billing.metered_item",
    "url": "/v2/billing/metered_items/bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc"
  }
}

Event handler

Server-side language

# Select a client library to see examples of
# parsing and retrieving event details.

Fetched payload

{
  "created": "2025-01-01T00:00:00.000Z",
  "id": "evt_65SJhYZDkX1uJ5gsI1Z16RuKJoESSQUtPVJKIgeI4D20zW",
  "object": "v2.core.event",
  "type": "v2.billing.metered_item.updated",
  "livemode": true,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_65SJhXZEhB4oQ0Csu16RuKJoESSQUtPVJKIgeI4D26Fi",
      "idempotency_key": "idem_65SJhWUFiC5pR1Dtv16RuKJoESSQUtPVJKIgeI4D27Gj"
    }
  },
  "related_object": {
    "id": "bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc",
    "type": "v2.billing.metered_item",
    "url": "/v2/billing/metered_items/bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc"
  },
  "data": {}
}