Get Event

GET /api/v1/events/:id

Overview

Retrieves the details of a specific event using its unique identifier.

Authorization

Header: Authorization: Bearer $PAYBYTOKEN_SECRET_KEY

Request Details

Request

curl https://api-prod.paybytoken.io/api/v1/events/evt_pe3C6ngyvcfAvNeW \
  -X GET \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY"

Request Parameters

Parameter	Type	Description
`id`	string	Unique identifier of the event (e.g., `evt_pe3C6ngyvcfAvNeW`).

Response Details

Response

The response returns an Event object containing the details of the specified event. See Events Overview for the full object definition.

Example Response

{
  "id": "evt_pe3C6ngyvcfAvNeW",
  "account_id": "p226968785",
  "resource_type": "payment_intent",
  "resource_id": "pay_pe337Vo53qcUJInIr4i3",
  "type": "payment_intent.succeeded",
  "api_version": "v1",
  "livemode": 0,
  "data": {
    "id": "pay_pe337Vo53qcUJInIr4i3",
    "object": "payment_intent",
    "status": "succeeded"
  },
  "created_at": "2025-09-25T11:44:10.000Z",
  "updated_at": "2025-09-25T19:44:10.000Z"
}

Errors

HTTP Status	Error Code	Description
404	404	Event not found.
400	400	Invalid event ID.
500	500	Internal server error.