# Retrieve an event

Retrieves an existing event object.

Endpoint: GET /events/{eventId}
Version: 1.0.0
Security: BasicAuth

## Path parameters:

  - `eventId` (string, required)
    Identifier of the event object that should be retrieved.

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the event
    Example: event_EY7CzyQiffJykW8rC5wSRnAj

  - `created` (integer)
    Unix timestamp (seconds) when the event was created
    Example: 1701432000

  - `objectType` (string)
    Enum: "event"

  - `type` (string)
    Type of event.
    Enum: "CHARGE_SUCCEEDED", "CHARGE_PENDING", "CHARGE_FAILED", "CHARGE_UPDATED", "CHARGE_CAPTURED", "CHARGE_REFUNDED", "CHARGE_DISPUTE_CREATED", "CHARGE_DISPUTE_UPDATED", "CHARGE_DISPUTE_WON", "CHARGE_DISPUTE_LOST", "CHARGE_DISPUTE_FUNDS_WITHDRAWN", "CHARGE_DISPUTE_FUNDS_RESTORED", "REFUND_UPDATED", "CUSTOMER_CREATED", "CUSTOMER_UPDATED", "CUSTOMER_DELETED", "CUSTOMER_CARD_CREATED", "CUSTOMER_CARD_UPDATED", "CUSTOMER_CARD_DELETED", "CUSTOMER_SUBSCRIPTION_CREATED", "CUSTOMER_SUBSCRIPTION_UPDATED", "CUSTOMER_SUBSCRIPTION_DELETED", "PLAN_CREATED", "PLAN_UPDATED", "PLAN_DELETED", "CREDIT_SUCCEEDED", "CREDIT_FAILED", "CREDIT_UPDATED", "FRAUD_WARNING_CREATED", "FRAUD_WARNING_UPDATED", "PAYOUT_CREATED", "PAYOUT_UPDATED", "PAYMENT_METHOD_CREATED", "PAYMENT_METHOD_UPDATED", "PAYMENT_METHOD_DELETED", "PAYMENT_LINK_CREATED", "PAYMENT_LINK_UPDATED", "PAYMENT_LINK_DELETED", "CHARGE_SPLIT_CREATED", "CHARGE_SPLIT_REFUND_CREATED"

  - `data` (object)
    Object that is a subject of this event. For example, an event with type `CHARGE_SUCCEEDED` will have a [charge](/docs/api/shift4-gateway/charges/getcharge) object as the value of this attribute.

  - `log` (string)
    Identifier of request log associated with this event.
    Example: log_2KzhaJZBmylL40iGiHfZsKRm

## Response 404 fields (application/json):

  - `error` (object)

  - `error.type` (string)
    Error type
    Enum: "invalid_request", "card_error", "gateway_error"

  - `error.code` (string)
    Machine-readable error code
    Example: invalid_number

  - `error.message` (string)
    Human-readable error message
    Example: Requested object does not exist

  - `error.chargeId` (string)
    ID of the charge associated with this error (if applicable)
    Example: char_ORVCrwOrTkGsDwM3H50OIW7Q