> ## 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. # carrierShipmentTrackers > List tracking for purchased packages, by shipment, tracking number, status, or recent change. Redo checks the carrier about every 4 hours until the package is delivered, returned, or cancelled, or 21 days after purchase. There are no tracking webhooks yet, so poll. Labels from carriers that only push updates (Sendcloud, WeGrow, NZ Post) keep the status they had at purchase. Selecting scans multiplies each tracker's query cost by the scan page size, so a large page with scans can exceed the query cost limit: poll without scans, then fetch scans only for trackers that changed. **Required scopes:** [`shipping_read`](/docs/api-reference/v3/reference/scopes#scope-shipping_read) ## Arguments Forward pagination cursor — returns trackers after it. Backward pagination cursor — returns trackers before it. Forward pagination: returns the first N trackers (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`. Backward pagination: returns the last N trackers (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`. CarrierShipmentTrackerSortKey}> Which key to sort by (defaults to the first key, newest-first). Combine with `reverse` to flip direction. Reverses the sort direction selected by `orderBy` (or its default). Only trackers for this shipmentId from purchaseCarrierShipment. CarrierShipmentTrackerStatus}> Only trackers with this status. UNKNOWN also matches statuses Redo does not recognize. Only trackers with this carrier tracking number. DateTime}> Only trackers whose status, status detail, latest scan, or delivery dates changed at or after this ISO-8601 instant. To poll only what changed, pass the start of your previous poll minus a few minutes and de-duplicate by id: a change can be stamped slightly before it becomes visible. ## Returns CarrierShipmentTrackerConnection!} required> A paginated list of CarrierShipmentTracker items. [CarrierShipmentTrackerEdge!]!} required> The list of edges (each a node plus its pagination `cursor`). Opaque cursor for this item; pass to `after`/`before` to page from here. CarrierShipmentTracker!} required> The item at this edge. The carrier the label was bought from, as purchaseCarrierShipment returned it. DateTime!} required> When tracking started, right after purchase. DateTime}> When the package was delivered, if it has been. DateTime}> The carrier's estimated delivery time, if known. The id of this carrier shipment tracker. DateTime}> When the carrier last returned tracking data to Redo. Null until it first does, even while Redo is checking. CarrierShipmentTrackerScanConnection!} required> The package's carrier scans, newest first. Each tracker's query cost grows with the scan page size, so select scans only for trackers that changed. **Requires:** [`shipping_read`](/docs/api-reference/v3/reference/scopes#scope-shipping_read) **Arguments** Forward pagination cursor — returns scans after it. Backward pagination cursor — returns scans before it. Forward pagination: returns the first N scans (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`. Backward pagination: returns the last N scans (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`. The shipmentId purchaseCarrierShipment returned for this package's shipment. CarrierShipmentTrackerStatus!} required> The package's current delivery status. Usually PRE\_TRANSIT until the first carrier scan. Redo checks the carrier about every 4 hours until the package is delivered, returned, or cancelled, or 21 days after purchase. There are no tracking webhooks yet, so poll. Labels from carriers that only push updates (Sendcloud, WeGrow, NZ Post) keep the status they had at purchase. The carrier's raw status detail, if any. The carrier tracking number. DateTime!} required> When the status, status detail, latest scan, or delivery dates last changed. [CarrierShipmentTracker!]!} required> The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`. The carrier the label was bought from, as purchaseCarrierShipment returned it. DateTime!} required> When tracking started, right after purchase. DateTime}> When the package was delivered, if it has been. DateTime}> The carrier's estimated delivery time, if known. The id of this carrier shipment tracker. DateTime}> When the carrier last returned tracking data to Redo. Null until it first does, even while Redo is checking. CarrierShipmentTrackerScanConnection!} required> The package's carrier scans, newest first. Each tracker's query cost grows with the scan page size, so select scans only for trackers that changed. **Requires:** [`shipping_read`](/docs/api-reference/v3/reference/scopes#scope-shipping_read) **Arguments** Forward pagination cursor — returns scans after it. Backward pagination cursor — returns scans before it. Forward pagination: returns the first N scans (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`. Backward pagination: returns the last N scans (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`. **Fields** [CarrierShipmentTrackerScanEdge!]!} required> The list of edges (each a node plus its pagination `cursor`). [CarrierShipmentTrackerScan!]!} required> The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`. PageInfo!} required> Pagination metadata for the current page. The shipmentId purchaseCarrierShipment returned for this package's shipment. CarrierShipmentTrackerStatus!} required> The package's current delivery status. Usually PRE\_TRANSIT until the first carrier scan. Redo checks the carrier about every 4 hours until the package is delivered, returned, or cancelled, or 21 days after purchase. There are no tracking webhooks yet, so poll. Labels from carriers that only push updates (Sendcloud, WeGrow, NZ Post) keep the status they had at purchase. The carrier's raw status detail, if any. The carrier tracking number. DateTime!} required> When the status, status detail, latest scan, or delivery dates last changed. PageInfo!} required> Pagination metadata for the current page. Cursor of the last edge in this page; pass to `after` to page forward. Whether more items exist after this page (drives forward pagination with `first`/`after`). Whether more items exist before this page (drives backward pagination with `last`/`before`). Cursor of the first edge in this page; pass to `before` to page backward. ## Example ```graphql theme={null} query { carrierShipmentTrackers(after: "...", before: "...", first: 10, last: 10, orderBy: CREATED_AT, reverse: true, shipmentId: "...", status: AVAILABLE_FOR_PICKUP, trackingNumber: "...", updatedAtAfter: "...") { nodes { carrier createdAt deliveredAt estimatedDeliveryAt id lastCheckedAt shipmentId status # ... } pageInfo { hasNextPage endCursor } } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.