Skip to main content

Serialized Fulfillment GraphQL API

Important

This part of the GraphQL API is currently in Preview status. For more information, see the GraphQL API policy.

The Serialized Fulfillment GraphQL API supports a Serialized Fulfillment system that can track individually identified items within a shipment of physical products.

This system is related to the Inventory system, but is separate and distinct from it.

Serialized Fulfillment allows marketplace owners to identify individual items in the process of fulfillment, which aids managing the lifecycle of non-fungible items – for example, when items in a shipment come with a warranty, or when a particular policy applies to them regarding replacements or returns.

Each serialized item must have a primary identifier and a type, and may optionally have a secondary identifier. The type may be one of the following:

  • IMEI
  • ICCID
  • Serial
  • Other

You can use the query to retrieve a list of serialized units in a specific shipment. You can use the mutations to create such a list for a specific shipping item, or to remove an existing list for a specific shipping item.

Was this page helpful?