orders_read
Arguments
ID!
required
The id of the tracker to fetch.
Returns
A carrier shipment tracker: the live delivery state of a shipment, with its full carrier scan history.
Show fields
Show fields
String
The carrier transporting the shipment, if known.
String
The carrier service level, if known.
ID!
required
The id of this tracker.
required
The orders fulfilled by this shipment.Requires:
orders_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor.
String
Backward pagination cursor.
Int
Forward pagination: returns the first N orders (max 100, default 25).
Int
Backward pagination: returns the last N orders (max 100, default 25).
required
The list of edges (each a node plus its pagination
cursor).Show fields
Show fields
String!
required
Opaque cursor for this item; pass to
after/before to page from here.required
The item at this edge.
required
Pagination metadata for the current page.
Show fields
Show fields
String
Cursor of the last edge in this page; pass to
after to page forward.Boolean!
required
Whether more items exist after this page (drives forward pagination with
first/after).Boolean!
required
Whether more items exist before this page (drives backward pagination with
last/before).String
Cursor of the first edge in this page; pass to
before to page backward.required
The tracker’s carrier scan history, newest first.Requires:
orders_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns scans after it.
String
Backward pagination cursor — returns scans before it.
Int
Forward pagination: returns the first N scans (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N scans (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).Show fields
Show fields
String!
required
Opaque cursor for this item; pass to
after/before to page from here.required
The item at this edge.
required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Show fields
Show fields
String
The city where the scan occurred, if reported.
String
The country where the scan occurred, if reported.
ID!
required
The id of this scan.
String!
required
The human-readable scan message.
String
The postal code where the scan occurred, if reported.
String
The state or province where the scan occurred, if reported.
required
The normalized carrier status at this scan.
String
The carrier’s raw status detail, if any.
Pagination metadata for the current page.
Show fields
Show fields
String
Cursor of the last edge in this page; pass to
after to page forward.Boolean!
required
Whether more items exist after this page (drives forward pagination with
first/after).Boolean!
required
Whether more items exist before this page (drives backward pagination with
last/before).String
Cursor of the first edge in this page; pass to
before to page backward.required
The current carrier-tracked delivery status.
String
The carrier tracking number, if known.
String
A public URL to track the shipment, if known.
Example
query {
tracker(id: "...") {
carrier
carrierService
createdAt
deliveredAt
estimatedDeliveryAt
id
orders {
nodes {
id
orderName
orderNumber
}
pageInfo { hasNextPage endCursor }
}
scans {
nodes {
city
country
id
message
occurredAt
postalCode
state
status
# ...
}
pageInfo { hasNextPage endCursor }
}
# ...
}
}