# List events

List event objects. Results are sorted by creation date, with the most recent objects first.

Endpoint: GET /events
Version: 1.0.0
Security: BasicAuth

## Query parameters:

  - `limit` (integer)
    Number of results per page (1-100)

  - `startingAfterId` (string)
    Return results starting after the object with this ID

  - `endingBeforeId` (string)
    Return results ending before the object with this ID

  - `created[gt]` (integer)
    Filter results created strictly after this Unix timestamp

  - `created[gte]` (integer)
    Filter results created at or after this timestamp

  - `created[lt]` (integer)
    Filter results created strictly before this Unix timestamp

  - `created[lte]` (integer)
    Filter results created at or before this timestamp

## Response 200 fields (application/json):

  - `list` (array)

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

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

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

  - `list.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"

  - `list.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.

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

  - `hasMore` (boolean)
    Whether more results exist beyond this page
    Example: true