> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# customerEvents

> What one shopper did, newest first: their events of the types you ask for. Filters combine with AND.

**Required scopes:** [`customers_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-customers_read)

## Arguments

**after** `String`

Read events older than this cursor, from `pageInfo.endCursor`.

**before** `String`

Read events newer than this cursor, from `pageInfo.startCursor`.

**customer** `ID!` *required*

The customer's `id` or `legacyId`.

**first** `Int`

Page size reading older events (default 25, max 100).

**last** `Int`

Page size reading newer events (default 25, max 100).

**occurredAfter** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

Only events at or after this instant.

**occurredBefore** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

Only events before this instant.

**types** `[\[CustomerEventType!\]!](/docs/api-reference/v3/reference/events/customer-event-type)` *required*

Only events of these types. At least one.

## Returns

**customerEvents** `[CustomerEventConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of CustomerEvent items.

**fields**

**edges** `[\[CustomerEventEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[CustomerEvent!](/docs/api-reference/v3/reference/events/customer-event)` *required*

The item at this edge.

**fields**

**id** `ID!` *required*

The id of this event.

**name** `String`

The event's name for a `CUSTOM_EVENT`; null for the other types.

**occurredAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the shopper did it.

**type** `[CustomerEventType!](/docs/api-reference/v3/reference/events/customer-event-type)` *required*

What the shopper did.

**nodes** `[\[CustomerEvent!\]!](/docs/api-reference/v3/reference/events/customer-event)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**id** `ID!` *required*

The id of this event.

**name** `String`

The event's name for a `CUSTOM_EVENT`; null for the other types.

**occurredAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the shopper did it.

**type** `[CustomerEventType!](/docs/api-reference/v3/reference/events/customer-event-type)` *required*

What the shopper did.

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  customerEvents(after: "...", before: "...", customer: "...", first: 10, last: 10, occurredAfter: "...", occurredBefore: "...", types: CHECKOUT_COMPLETED) {
    nodes {
      id
      name
      occurredAt
      type
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.