# Retrieve an Event by Id

This is used to fetch an Event by its eventId

Endpoint: GET /events/{eventId}
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `eventId` (string, required)
    Event to retrieve
    Example: "ev_01FCTS1XMKH9FF43CAFA4CXT3P"

## Header parameters:

  - `Account` (string)
    The linked accountId (use this when you want to fetch events related to a linked account)
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

## Response 200 fields (application/json):

  - `id` (string)
    The unique id of the event
    Example: "ev_01FGNPAY1DB5TKPB35M1MNT6PN"

  - `eventType` (string)
    The type of the event. Note that we consider adding new types non-breaking changes so recommend you do not hard-code all values listed here.
    Enum: "PaymentSession.approved", "PaymentSession.captured", "PaymentSession.declined", "PaymentSession.voided", "PaymentSession.void_failed", "PaymentSession.refunded", "PaymentSession.refund_failed", "PaymentSession.requires_action", "Account.created", "Account.updated", "Account.verification_status_updated", "Person.created", "Person.updated", "Person.deleted", "PayoutMethod.created", "PayoutMethod.updated", "PayoutMethod.deleted", "Payout.created", "Payout.status_updated", "Customer.created", "Customer.updated", "Customer.deleted", "Subscription.created", "Subscription.updated", "Subscription.cancelled", "Subscription.past_due", "Subscription.ended", "Transfer.created", "Transfer.updated", "Dispute.created", "Dispute.closed", "Dispute.challenged", "PlatformFee.created", "PlatformFee.refunded", "InPersonOrder.created", "InPersonOrder.updated", "InPersonLocation.created", "InPersonLocation.updated", "Terminal.created", "Terminal.updated", "Terminal.deleted"

  - `data` (any)
    Contains the full underlying response object at the time the event was emitted.
For example, a PaymentSession.captured event will contain the entire PaymentSession resource in this field.

Note that some older events (prior to August 2025) consisted of a more specific model. We have dropped support for this model and typically recommend events older than 30 days be considered archived.

  - `endpoints` (array)
    The webhook endpoints that this event was sent to. Note that this is only present on the /events API.

  - `endpoints.webhookId` (string)
    The unique id of the webhook endpoint
    Example: "wh_31fba123-0fef-41d6-92ad-fd7089f49f8a"

  - `endpoints.acknowledged` (boolean)
    Whether the webhook endpoint has received and acknowledged the event
    Example: true

  - `endpoints.attempts` (integer)
    How many times we have attempted to deliver the event to the webhook endpoint
    Example: 2

  - `accountId` (string,null)
    The account id in which this event happened.
    Example: "ac_b83f2653-06d7-44a9-a548-5825e8186004"

  - `createdTimestamp` (integer)
    The epoch timestamp (seconds) when the event was created
    Example: 1570989538

## Response 404 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"