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

# trackers

> List shipment trackers, optionally filtered by status, tracking number, or created/updated date range.

**Required scopes:** [`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)

## Arguments

**after** `String`

Forward pagination cursor — returns trackers after it.

**before** `String`

Backward pagination cursor — returns trackers before it.

**createdAtAfter**

Only return trackers created at or after this ISO-8601 instant.

**createdAtBefore**

Only return trackers created at or before this ISO-8601 instant.

**first** `Int`

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

**last** `Int`

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

**orderBy**

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

**reverse** `Boolean`

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

**status**

Only return trackers with this status. `UNKNOWN` also matches trackers whose stored status Redo does not recognize.

**trackingNumber** `String`

Only return trackers with this carrier tracking number.

**updatedAtAfter**

Only return trackers updated at or after this ISO-8601 instant.

**updatedAtBefore**

Only return trackers updated at or before this ISO-8601 instant.

## Returns

**trackers** *required*

A paginated list of Tracker items.

**fields**

**edges** *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** *required*

The item at this edge.

**fields**

**carrier** `String`

The carrier transporting the shipment, if known.

**carrierService** `String`

The carrier service level, if known.

**createdAt** *required*

When the tracker was created.

**deliveredAt**

When the shipment was delivered, if it has been.

**estimatedDeliveryAt**

The carrier's estimated delivery time, if known.

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

The id of this tracker.

**orders** *required*

The orders fulfilled by this shipment.

**Requires:** [`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor.

**before** `String`

Backward pagination cursor.

**first** `Int`

Forward pagination: returns the first N orders (max 100, default 25).

**last** `Int`

Backward pagination: returns the last N orders (max 100, default 25).

**scans** *required*

The tracker's carrier scan history, newest first.

**Requires:** [`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns scans after it.

**before** `String`

Backward pagination cursor — returns scans before it.

**first** `Int`

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

**last** `Int`

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

**status** *required*

The current carrier-tracked delivery status.

**trackingNumber** `String`

The carrier tracking number, if known.

**trackingUrl** `String`

A public URL to track the shipment, if known.

**updatedAt** *required*

When the tracker was last updated.

**nodes** *required*

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

**fields**

**carrier** `String`

The carrier transporting the shipment, if known.

**carrierService** `String`

The carrier service level, if known.

**createdAt** *required*

When the tracker was created.

**deliveredAt**

When the shipment was delivered, if it has been.

**estimatedDeliveryAt**

The carrier's estimated delivery time, if known.

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

The id of this tracker.

**orders** *required*

The orders fulfilled by this shipment.

**Requires:** [`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor.

**before** `String`

Backward pagination cursor.

**first** `Int`

Forward pagination: returns the first N orders (max 100, default 25).

**last** `Int`

Backward pagination: returns the last N orders (max 100, default 25).

**Fields**

**edges** *required*

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

**nodes** *required*

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

**pageInfo** *required*

Pagination metadata for the current page.

**scans** *required*

The tracker's carrier scan history, newest first.

**Requires:** [`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns scans after it.

**before** `String`

Backward pagination cursor — returns scans before it.

**first** `Int`

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

**last** `Int`

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

**Fields**

**edges** *required*

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

**nodes** *required*

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

**pageInfo** *required*

Pagination metadata for the current page.

**status** *required*

The current carrier-tracked delivery status.

**trackingNumber** `String`

The carrier tracking number, if known.

**trackingUrl** `String`

A public URL to track the shipment, if known.

**updatedAt** *required*

When the tracker was last updated.

**pageInfo** *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 {
  trackers(after: "...", before: "...", createdAtAfter: "...", createdAtBefore: "...", first: 10, last: 10, orderBy: CREATED_AT, reverse: true, status: AVAILABLE_FOR_PICKUP, trackingNumber: "...", updatedAtAfter: "...", updatedAtBefore: "...") {
    nodes {
      carrier
      carrierService
      createdAt
      deliveredAt
      estimatedDeliveryAt
      id
      status
      trackingNumber
      # ...
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


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