--- title: InventoryScheduledChange - GraphQL Admin description: Returns the scheduled changes to inventory states related to the ledger document. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryScheduledChange md: https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryScheduledChange.md --- # Inventory​Scheduled​Change object Requires `read_inventory` access scope. Returns the scheduled changes to inventory states related to the ledger document. ## Fields * expected​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time that the scheduled change is expected to happen. * from​Name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The quantity [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps/quantities-states#move-inventory-quantities-between-states) to transition from. * inventory​Level [Inventory​Level!](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) non-null The quantities of an inventory item that are related to a specific location. * ledger​Document​Uri [URL!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL) non-null A freeform URI that represents what changed the inventory quantities. * quantity [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) non-null The quantity of the scheduled change associated with the ledger document in the `fromName` state. * to​Name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The quantity [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps/quantities-states#move-inventory-quantities-between-states) to transition to. *** ## Map ### Fields and connections with this object * {}[InventoryLevel.scheduledChanges](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel#field-InventoryLevel.fields.scheduledChanges) * <->[InventoryScheduledChangeConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/InventoryScheduledChangeConnection#returns-nodes) * {}[InventoryScheduledChangeEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryScheduledChangeEdge#field-InventoryScheduledChangeEdge.fields.node) *** ## Mutations * [inventory​Set​Scheduled​Changes](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventorySetScheduledChanges) mutation Set up scheduled changes of inventory items. *** ## <\~> InventoryScheduledChange Mutations ### Mutated by * <\~>[inventory​Set​Scheduled​Changes](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventorySetScheduledChanges)