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

# Tracker

> A carrier shipment tracker: the live delivery state of a shipment, with its full carrier scan history.

**[Emits](/docs/api-reference/v3/reference/webhooks/overview):** `TRACKER_CREATED`, `TRACKER_STATUS_UPDATED`

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

**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`).

**fields**

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

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

**node** *required*

The item at this edge.

**nodes** *required*

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

**fields**

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

The id of this order.

**orderName** `String`

The order name, if any.

**orderNumber** `String`

The merchant-facing order number, if any.

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

**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`).

**fields**

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

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

**node** *required*

The item at this edge.

**nodes** *required*

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

**fields**

**city** `String`

The city where the scan occurred, if reported.

**country** `String`

The country where the scan occurred, if reported.

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

The id of this scan.

**message** `String!` *required*

The human-readable scan message.

**occurredAt** *required*

When the carrier recorded this scan.

**postalCode** `String`

The postal code where the scan occurred, if reported.

**state** `String`

The state or province where the scan occurred, if reported.

**status** *required*

The normalized carrier status at this scan.

**statusDetail** `String`

The carrier's raw status detail, if any.

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

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


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