Retrieve an event

​

Retrieves an Event by the id returned by the Events API. Use it to inspect the resource snapshot and current webhook delivery progress when reconciling account activity.

Events are available for 30 days after creation. An event that has expired, does not exist, or belongs to another account or mode returns an error response with HTTP status 404.

Read type to identify the change and data.object to inspect the affected resource. The snapshot in data and its api_version stay unchanged; pending_webhooks reports the current delivery count. Event IDs returned by this API can differ from the IDs in webhook deliveries.

Related guides: Event types and Webhook Event Catalogue.

Path Parameters

  • id
    Type: string
    min length:  
    1
    required

    Event ID returned by the Events API.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/events/{id}
curl 'https://api.paypercut.io/v1/events/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
Checkout Session completed event

Illustrative v2 Checkout Session snapshot returned by the Events API. The pending_webhooks count reflects delivery progress at retrieval time.

{
  "id": "evt_01M3H7JSKWFQ9WRCVF0Z893RST",
  "created": "2026-09-27T10:30:45.123456789Z",
  "type": "checkout_session.completed",
  "account": "01KAKB228G3K4E98NFVE2MGHW4",
  "api_version": "v2",
  "livemode": false,
  "data": {
    "object": {
      "id": "01KA9T0VG5MDBTN4BBZK10QT0G",
      "account_id": "01KAKB228G3K4E98NFVE2MGHW4",
      "object": "checkout_session",
      "status": "complete",
      "payment_status": "paid",
      "amount_total": 2000,
      "currency": "EUR",
      "livemode": false,
      "client_reference_id": "example-order-1042",
      "client_customer_id": null,
      "customer": null,
      "payment_intent": {
        "id": "01KA9T0ABC123456789DEFGHIJ",
        "account_id": "01KAKB228G3K4E98NFVE2MGHW4",
        "object": "payment_intent",
        "amount": 2000,
        "amount_capturable": 0,
        "amount_received": 2000,
        "currency": "EUR",
        "currency_scale": 2,
        "status": "succeeded",
        "capture_method": "automatic",
        "created": "2026-09-27T10:30:00Z",
        "updated": "2026-09-27T10:30:45.123456789Z",
        "livemode": false,
        "checkout_id": "01KA9T0VG5MDBTN4BBZK10QT0G",
        "payment_method": null,
        "latest_payment": null,
        "customer": null,
        "statement_descriptor": null,
        "on_behalf_of": null,
        "transfer_group": null,
        "application_fee_amount": null,
        "setup_future_usage": null,
        "cancellation_reason": null,
        "canceled_at": null,
        "metadata": {
          "order_id": "example-order-1042"
        }
      },
      "setup_intent": null,
      "metadata": {
        "order_id": "example-order-1042"
      }
    },
    "previous_attributes": null
  },
  "pending_webhooks": 1,
  "request": {
    "id": "req_example_checkout",
    "idempotency_key": "example-checkout-1042"
  }
}

Event details