> ## 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.

# trackingPages

> List the store's tracking pages.

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

**Store must have one of:** `ORDER_TRACKING`

## Arguments

**after** `String`

Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.

**before** `String`

Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.

**first** `Int`

Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**orderBy** `[TrackingPageSortKey](/docs/api-reference/v3/reference/marketing/tracking-page-sort-key)`

Which key to sort by (defaults to `CREATED_AT`, newest-first). Combine with `reverse` to flip direction.

**reverse** `Boolean`

Reverses the sort direction selected by `orderBy` (or its default).

## Returns

**trackingPages** `[TrackingPageConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of TrackingPage items.

**fields**

**edges** `[\[TrackingPageEdge!\]!](/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** `[TrackingPage!](/docs/api-reference/v3/reference/marketing/tracking-page)` *required*

The item at this edge.

**fields**

**blocks** `[JSON!](/docs/api-reference/v3/reference/common/json)` *required*

Grid blocks from settings.blocks. Shape is `trackingPageBlockSchema`.

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

When the tracking page was created.

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

The id of this tracking page.

**isDefault** `Boolean!` *required*

Stored default. A published tracking-page flow ignores this flag.

**legacyId** `String!` *required*

Mongo ObjectId from the merchant app.

**metrics** `[TrackingPageMetrics](/docs/api-reference/v3/reference/marketing/tracking-page-metrics)`

Opens, clicks, and attributed revenue for this tracking page over the date range.

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

**fields**

**Arguments**

**attributionDays** `Int`

Days after the page view in which an order still counts. 1 through 5. Default 3.

**end** `[Date!](/docs/api-reference/v3/reference/common/date)` *required*

Last day to report on, inclusive, spanning at most 400 days.

**start** `[Date!](/docs/api-reference/v3/reference/common/date)` *required*

First day to report on, inclusive. Must be on or before `end`, spanning at most 400 days.

**name** `String`

settings.name. Null when the page was saved without one. The app shows "Untitled Tracking Page".

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

When the tracking page was last updated.

**nodes** `[\[TrackingPage!\]!](/docs/api-reference/v3/reference/marketing/tracking-page)` *required*

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

**fields**

**blocks** `[JSON!](/docs/api-reference/v3/reference/common/json)` *required*

Grid blocks from settings.blocks. Shape is `trackingPageBlockSchema`.

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

When the tracking page was created.

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

The id of this tracking page.

**isDefault** `Boolean!` *required*

Stored default. A published tracking-page flow ignores this flag.

**legacyId** `String!` *required*

Mongo ObjectId from the merchant app.

**metrics** `[TrackingPageMetrics](/docs/api-reference/v3/reference/marketing/tracking-page-metrics)`

Opens, clicks, and attributed revenue for this tracking page over the date range.

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

**fields**

**Arguments**

**attributionDays** `Int`

Days after the page view in which an order still counts. 1 through 5. Default 3.

**end** `[Date!](/docs/api-reference/v3/reference/common/date)` *required*

Last day to report on, inclusive, spanning at most 400 days.

**start** `[Date!](/docs/api-reference/v3/reference/common/date)` *required*

First day to report on, inclusive. Must be on or before `end`, spanning at most 400 days.

**Fields**

**clicks** `Int!` *required*

Clicks on interactive blocks recorded for this tracking page in the range.

**opens** `Int!` *required*

Page views recorded for this tracking page in the range.

**revenue** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

Sum of attributed order revenue in the store's currency.

**name** `String`

settings.name. Null when the page was saved without one. The app shows "Untitled Tracking Page".

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

When the tracking page was last updated.

**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 {
  trackingPages(after: "...", before: "...", first: 10, last: 10, orderBy: CREATED_AT, reverse: true) {
    nodes {
      blocks
      createdAt
      id
      isDefault
      legacyId
      name
      updatedAt
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


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