---
title: events - Partner API
description: A timeline of historical events for the authenticated partner.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/partner/latest/queries/events'
  md: 'https://shopify.dev/docs/api/partner/latest/queries/events.md'
api_name: partner
api_type: graphql
type: query
---

# events

query

A timeline of historical events for the authenticated partner.

## PartnerEventConnection arguments

[PartnerEventConnection](https://shopify.dev/docs/api/partner/latest/connections/PartnerEventConnection)

* after

  [String](https://shopify.dev/docs/api/partner/latest/scalars/String)

  Returns the elements in the list that come after the specified cursor.

* before

  [String](https://shopify.dev/docs/api/partner/latest/scalars/String)

  Returns the elements in the list that come before the specified cursor.

* filter

  [Event​Filter​Input](https://shopify.dev/docs/api/partner/latest/input-objects/EventFilterInput)

  Filter criteria for historical events.

* first

  [Int](https://shopify.dev/docs/api/partner/latest/scalars/Int)

  Returns the first *n* elements from the list.

* last

  [Int](https://shopify.dev/docs/api/partner/latest/scalars/Int)

  Returns the last *n* elements from the list.

* order​By

  [Event​Order](https://shopify.dev/docs/api/partner/latest/enums/EventOrder)

  Default:OCCURRED\_AT\_DESC

  The order in which to return events.

***

## Possible returns

* edges

  [\[Partner​Event​Edge!\]!](https://shopify.dev/docs/api/partner/latest/objects/PartnerEventEdge)

  non-null

  A list of edges.

* page​Info

  [Historical​Events​Page​Info!](https://shopify.dev/docs/api/partner/latest/objects/HistoricalEventsPageInfo)

  non-null

  Information about pagination in this connection.

***

## Examples

* ### events reference