inboundShipments

List inbound shipments, optionally filtered by status.

Required scopes: inventory_read

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 · InboundShipmentSortKey

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 · InboundShipmentStatus

Only return shipments with this status.

Returns

inboundShipments · InboundShipmentConnection! · required

A paginated list of InboundShipment items.

Show fields

edges · [InboundShipmentEdge!]! · required

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

Show fields

cursor · String! · required

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

node · InboundShipment! · required

The item at this edge.

Show fields

actualArrivalDate · Date

The date the shipment actually arrived.

carrier · String

The carrier transporting the shipment.

createdAt · DateTime! · required

When the record was created.

dutyCost · Money

The duty cost incurred for the shipment.

estimatedArrivalDate · Date

The estimated date the shipment will arrive.

freightCost · Money

The cost of freight for the shipment.

freightType · String

The type of freight used for the shipment.

id · ID! · required

The id of this inbound shipment.

items · InboundShipmentItemConnection! · required

A paginated list of the shipment’s line items.

Requires: inventory_read

Show fields

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.

location · Location

The location the shipment is arriving at.

Requires: locations_read

paymentTerms · String

The payment terms agreed for the shipment.

purchaseOrders · PurchaseOrderConnection! · required

Purchase orders this shipment fulfills.

Requires: inventory_read

Show fields

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.

shipmentId · String

The carrier’s identifier for the shipment.

status · InboundShipmentStatus! · required

The current status of the shipment.

trackingNumber · String

The shipment’s tracking number.

trackingUrl · String

A URL to track the shipment.

updatedAt · DateTime! · required

When the record was last updated.

nodes · [InboundShipment!]! · required

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

Show fields

actualArrivalDate · Date

The date the shipment actually arrived.

carrier · String

The carrier transporting the shipment.

createdAt · DateTime! · required

When the record was created.

dutyCost · Money

The duty cost incurred for the shipment.

Show fields

amount · Decimal! · required

The exact amount as a decimal string (e.g. “19.99”).

currency · String! · required

ISO 4217 currency code (e.g. USD).

estimatedArrivalDate · Date

The estimated date the shipment will arrive.

freightCost · Money

The cost of freight for the shipment.

Show fields

amount · Decimal! · required

The exact amount as a decimal string (e.g. “19.99”).

currency · String! · required

ISO 4217 currency code (e.g. USD).

freightType · String

The type of freight used for the shipment.

id · ID! · required

The id of this inbound shipment.

items · InboundShipmentItemConnection! · required

A paginated list of the shipment’s line items.

Requires: inventory_read

Show fields

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.

Fields

edges · [InboundShipmentItemEdge!]! · required

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

nodes · [InboundShipmentItem!]! · required

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

pageInfo · PageInfo! · required

Pagination metadata for the current page.

location · Location

The location the shipment is arriving at.

Requires: locations_read

Show fields

city · String

The city of the location’s address.

company · String

The company name associated with the location.

countryCode · String

The country code, e.g. “US”.

createdAt · DateTime! · required

When the record was created.

id · ID! · required

The id of this location.

inventoryLevels · LocationInventoryLevelConnection! · required

Per-product inventory levels held at this location.

Requires: inventory_read

Show fields

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.

name · String! · required

The location’s display name.

phone · String

The contact phone number for the location.

postalCode · String

The postal or ZIP code, e.g. “84101”.

stateCode · String

The state or province code, e.g. “UT”.

street1 · String

The first line of the street address.

street2 · String

The second line of the street address.

updatedAt · DateTime! · required

When the record was last updated.

paymentTerms · String

The payment terms agreed for the shipment.

purchaseOrders · PurchaseOrderConnection! · required

Purchase orders this shipment fulfills.

Requires: inventory_read

Show fields

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.

Fields

edges · [PurchaseOrderEdge!]! · required

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

nodes · [PurchaseOrder!]! · required

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

pageInfo · PageInfo! · required

Pagination metadata for the current page.

shipmentId · String

The carrier’s identifier for the shipment.

status · InboundShipmentStatus! · required

The current status of the shipment.

trackingNumber · String

The shipment’s tracking number.

trackingUrl · String

A URL to track the shipment.

updatedAt · DateTime! · required

When the record was last updated.

pageInfo · PageInfo! · required

Pagination metadata for the current page.

Show 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

query {
  inboundShipments(
    after: "..."
    before: "..."
    first: 10
    last: 10
    orderBy: CREATED_AT
    reverse: true
    status: IN_TRANSIT
  ) {
    nodes {
      actualArrivalDate
      carrier
      createdAt
      estimatedArrivalDate
      freightType
      id
      paymentTerms
      shipmentId
      # ...
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}