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

List all Event objects v2

Core Resources
Events
List all Event objects

List events, going back up to 30 days.

Learn more about calling API v2 endpoints.

Parameters

  • object_idstringRequired

    Primary object ID used to retrieve related events.

  • limitinteger

    The page size.

  • pagestring

    The requested page.

Returns

Response attributes

  • dataarray of objects

    List of events.

    • data.idstring

      Unique identifier for the event.

    • data.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.

    • data.contextnullable string

      Authentication context needed to fetch the event or related object.

    • data.createdtimestamp

      Time at which the object was created.

    • data.datanullable object

      Additional data about the event.

    • data.livemodeboolean

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

    • data.reasonnullable object

      Reason for the event.

      • data.reason.requestnullable object

        Information on the API request that instigated the event.

        • data.reason.request.idstring

          ID of the API request that caused the event.

        • data.reason.request.idempotency_keystring

          The idempotency key transmitted during the request.

      • data.reason.typeenum

        Event reason type.

        Possible enum values
        request

        The event was published as the result of an API request.

    • data.related_objectnullable object

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

      • data.related_object.idstring

        Unique identifier for the object relevant to the event.

      • data.related_object.typestring

        Object tag of the resource relevant to the event.

      • data.related_object.urlstring

        URL to retrieve the resource.

    • data.typestring

      The type of the event.

  • next_page_urlnullable string

    The next page url.

  • previous_page_urlnullable string

    The previous page url.

GET /v2/core/events
curl -G https://api.stripe.com/v2/core/events \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-08-27.preview" \
  -d object_id=mtr_test_61RCjiqdTDC91zgip41IqPCzPnxqqSVc
Response
{
  "data": [
    {
      "id": "evt_test_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40u",
      "object": "v2.core.event",
      "context": null,
      "created": "2024-09-26T17:46:22.134Z",
      "data": {
        "developer_message_summary": "There is 1 invalid event",
        "reason": {
          "error_count": 1,
          "error_types": [
            {
              "code": "meter_event_no_customer_defined",
              "error_count": 1,
              "sample_errors": [
                {
                  "error_message": "Customer mapping key stripe_customer_id not found in payload.",
                  "request": {
                    "identifier": "cb447754-6880-45c2-8f2f-ef19b6ce81e9"
                  }
                }
              ]
            }
          ]
        },
        "validation_end": "2024-09-26T17:46:20.000Z",
        "validation_start": "2024-09-26T17:46:10.000Z"
      },
      "livemode": false,
      "reason": null,
      "related_object": {
        "id": "mtr_test_61RCjiqdTDC91zgip41IqPCzPnxqqSVc",
        "type": "billing.meter",
        "url": "/v1/billing/meters/mtr_test_61RCjiqdTDC91zgip41IqPCzPnxqqSVc"
      },
      "type": "v1.billing.meter.error_report_triggered"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}