--- title: AssignedFulfillmentOrder description: View the fulfillment orders of a shop that are assigned to your app. api_version: 2025-10 api_name: admin-rest api_type: rest source_url: html: https://shopify.dev/docs/api/admin-rest/latest/resources/assignedfulfillmentorder md: https://shopify.dev/docs/api/admin-rest/latest/resources/assignedfulfillmentorder.md --- ![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg) The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate). # Assigned​Fulfillment​Order Requires `assigned_fulfillment_orders` access scope. A list of all the [fulfillment orders](https://shopify.dev/api/admin-rest/latest/resources/fulfillmentorder) that are assigned to an app at the shop level. The list of fulfillment orders can be filtered by [location](https://shopify.dev/api/admin-rest/latest/resources/location) and assignment status. Assigned fulfillment orders are fulfillment orders that are set to be fulfilled from locations managed by [fulfillment services](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentservice) that are registered by the app. One app (api\_client) may host multiple fulfillment services on a shop. Each fulfillment service manages a dedicated location on a shop. Assigned fulfillment orders can have associated [fulfillment requests](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentrequest) or might currently not be requested to be fulfilled. \# ## Endpoints * [get](https://shopify.dev/docs/api/admin-rest/latest/resources/assignedfulfillmentorder#get-assigned-fulfillment-orders?assignment-status=cancellation-requested\&location-ids\[]=24826418) [/admin/api/latest/assigned\_​fulfillment\_​orders.​json?assignment\_​status=cancellation\_​requested\&location\_​ids\[\]=24826418](https://shopify.dev/docs/api/admin-rest/latest/resources/assignedfulfillmentorder#get-assigned-fulfillment-orders?assignment-status=cancellation-requested\&location-ids\[]=24826418) Retrieves a list of fulfillment orders assigned to the shop locations that are owned by the app [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/shop?example=retrieves-a-list-of-fulfillment-orders-assigned-to-the-shop-locations-that-are-owned-by-the-app) [shop](https://shopify.dev/docs/api/admin-graphql/latest/queries/shop?example=retrieves-a-list-of-fulfillment-orders-assigned-to-the-shop-locations-that-are-owned-by-the-app) *** ## The AssignedFulfillmentOrder resource ### Properties *** assigned\_location\_id read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location#field-Location.fields.legacyResourceId) [legacyResourceId](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location#field-Location.fields.legacyResourceId) The ID of the fulfillment order's assigned location. This is the location from which the order is expected to be fulfilled. *** destination read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.destination) [destination](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.destination) The destination where the items should be sent upon fulfillment. Show destination properties * **id**: The ID of the fulfillment order destination. * **address1**: The first line of the address of the destination. * **address2**: The second line of the address of the destination. * **city**: The city of the destination. * **company**: The company of the destination. * **country**: The country of the destination. * **email**: The email of the customer at the destination. * **first\_name**: The first name of the customer at the destination. * **last\_name**: The last name of the customer at the destination. * **phone**: The phone number of the customer at the destination. * **province**: The province of the destination. * **zip**: The ZIP code of the destination. *** id read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.id) [id](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.id) The ID of the fulfillment order. *** line\_items read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.lineItems) [lineItems](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.lineItems) Represents line items belonging to a fulfillment order: Show line\_items properties * **id**: The ID of the fulfillment order line item. * **shop\_id**: The ID of the shop associated with the fulfillment order line item. * **fulfillment\_order\_id**: The ID of the fulfillment order associated with this line item. * **line\_item\_id**: The ID of the line item associated with this fulfillment order line item. * **inventory\_item\_id**: The ID of the inventory item associated with this fulfillment order line item. * **quantity**: The total number of units to be fulfilled. * **fulfillable\_quantity**: The number of units remaining to be fulfilled. *** order\_id read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.legacyResourceId) [legacyResourceId](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.legacyResourceId) The ID of the order that's associated with the fulfillment order. *** request\_status read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.requestStatus) [requestStatus](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.requestStatus) The request status of the fulfillment order. Valid values: Show request\_status properties * **unsubmitted**: The initial request status for the newly-created fulfillment orders. This is the only valid request status for fulfillment orders that aren't assigned to a fulfillment service. * **submitted**: The merchant requested fulfillment for this fulfillment order. * **accepted**: The fulfillment service accepted the merchant's fulfillment request. * **rejected**: The fulfillment service rejected the merchant's fulfillment request. * **cancellation\_requested**: The merchant requested a cancellation of the fulfillment request for this fulfillment order. * **cancellation\_accepted**: The fulfillment service accepted the merchant's fulfillment cancellation request. * **cancellation\_rejected**: The fulfillment service rejected the merchant's fulfillment cancellation request. * **closed**: The fulfillment service closed the fulfillment order without completing it. *** shop\_id deprecated The ID of the shop that's associated with the fulfillment order. *** status read-only -> [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.status) [status](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.status) The status of the fulfillment order. Valid values: Show status properties * **open**: Default state for newly created fulfillment orders. * **in\_progress**: The fulfillment order is being processed. * **cancelled**: The fulfillment order has been cancelled by the merchant. * **incomplete**: The fulfillment order cannot be completed as requested. * **closed**: The fulfillment order has been completed and closed. *** {} ## The AssignedFulfillmentOrder resource ```json { "assigned_location_id": 3183479, "destination": { "id": 54433189, "address1": "123 Amoebobacterieae St", "address2": "Unit 806", "city": "Ottawa", "company": "", "country": "Canada", "email": "bob@example.com", "first_name": "Bob", "last_name": "Bobsen", "phone": "(555)555-5555", "province": "Ontario", "zip": "K2P0V6" }, "id": 255858046, "line_items": [ { "id": 466157049, "shop_id": 3998762, "fulfillment_order_id": 1568020, "line_item_id": 466157049, "inventory_item_id": 6588097, "quantity": 1, "fulfillable_quantity": 1 } ], "order_id": 3183479, "request_status": "unsubmitted", "shop_id": 255858046, "status": "open" } ``` *** ## getRetrieves a list of fulfillment orders assigned to the shop locations that are owned by the app [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/shop?example=retrieves-a-list-of-fulfillment-orders-assigned-to-the-shop-locations-that-are-owned-by-the-app) [shop](https://shopify.dev/docs/api/admin-graphql/latest/queries/shop?example=retrieves-a-list-of-fulfillment-orders-assigned-to-the-shop-locations-that-are-owned-by-the-app) Retrieves a list of fulfillment orders assigned to the shop locations that are owned by the app. The app must have the `read_assigned_fulfillment_orders` [access scope](https://shopify.dev/docs/api/usage/access-scopes) to be able to retrieve fulfillment orders assigned to its locations. All assigned fulfillment orders (except those with the `CLOSED` status) will be returned by default. Perform filtering with the `assignment_status` query parameter to receive only fulfillment orders that have been requested to be fulfilled. ### Parameters *** api\_version string required *** assignment\_status The assignment status of the fulfillment orders that should be returned. If `assignment_status` parameter isn't provided, then the query will return all assigned fulfillment orders, except those with the `CLOSED` status. Show assignment\_status properties * **fulfillment\_unsubmitted**: Fulfillment orders for which the merchant hasn't yet requested fulfillment. Filtering by this value is supported as of the `2023-04` API version. * **fulfillment\_requested**: Fulfillment orders for which the merchant has requested fulfillment. * **fulfillment\_accepted**: Fulfillment orders for which the merchant's fulfillment request has been accepted. Any number of fulfillments can be created on these fulfillment orders to completely fulfill the requested items. * **cancellation\_requested**: Fulfillment orders for which the merchant has requested cancellation of the previously accepted fulfillment request. *** location\_ids The IDs of the assigned locations of the fulfillment orders that should be returned.\ If the `location_ids` parameter isn't provided, then all fulfillment orders assigned to the shop locations that are managed by the app will be returned. *** ### Examples Retrieve a list of fulfillment orders in cancellation\_requested state at a location for an app Query parameters assignment\_​status=​cancellation\_requested The assignment status of the fulfillment orders that should be returned. If `assignment_status` parameter isn't provided, then the query will return all assigned fulfillment orders, except those with the `CLOSED` status. Show assignment\_status properties * **fulfillment\_unsubmitted**: Fulfillment orders for which the merchant hasn't yet requested fulfillment. Filtering by this value is supported as of the `2023-04` API version. * **fulfillment\_requested**: Fulfillment orders for which the merchant has requested fulfillment. * **fulfillment\_accepted**: Fulfillment orders for which the merchant's fulfillment request has been accepted. Any number of fulfillments can be created on these fulfillment orders to completely fulfill the requested items. * **cancellation\_requested**: Fulfillment orders for which the merchant has requested cancellation of the previously accepted fulfillment request. get ## /admin/api/2025-10/assigned\_​fulfillment\_​orders.​json?assignment\_​status=​cancellation\_requested\&location\_​ids\[]=​24826418 ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/assigned_fulfillment_orders.json?assignment_status=cancellation_requested&location_ids%5B%5D=24826418" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "fulfillment_orders": [ { "id": 1046000787, "created_at": "2025-10-01T14:59:28-04:00", "updated_at": "2025-10-01T14:59:28-04:00", "shop_id": 548380009, "order_id": 450789469, "assigned_location_id": 24826418, "request_status": "cancellation_requested", "status": "in_progress", "fulfill_at": null, "fulfill_by": null, "supported_actions": [ "create_fulfillment", "cancel_fulfillment_order" ], "destination": { "id": 1042572119, "address1": "Chestnut Street 92", "address2": "", "city": "Louisville", "company": null, "country": "United States", "email": "bob.norman@mail.example.com", "first_name": "Bob", "last_name": "Norman", "phone": "+1(502)-459-2181", "province": "Kentucky", "zip": "40202" }, "line_items": [ { "id": 1072503284, "shop_id": 548380009, "fulfillment_order_id": 1046000787, "quantity": 1, "line_item_id": 518995019, "inventory_item_id": 49148385, "fulfillable_quantity": 1, "variant_id": 49148385 } ], "outgoing_requests": [], "international_duties": null, "fulfillment_holds": [], "delivery_method": null, "assigned_location": { "address1": null, "address2": null, "city": null, "country_code": "DE", "location_id": 24826418, "name": "Apple Api Shipwire", "phone": null, "province": null, "zip": null } } ] } ``` ### examples * #### Retrieve a list of fulfillment orders in cancellation\_requested state at a location for an app ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/assigned_fulfillment_orders.json?assignment_status=cancellation_requested&location_ids%5B%5D=24826418" \ -H "X-Shopify-Access-Token: {access_token}" ``` ##### ```remix await admin.rest.resources.AssignedFulfillmentOrder.all({ session: session, assignment_status: "cancellation_requested", location_ids: ["24826418"], }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session ShopifyAPI::AssignedFulfillmentOrder.all( session: test_session, assignment_status: "cancellation_requested", location_ids: ["24826418"], ) ``` ##### ```node // Session is built by the OAuth process await shopify.rest.AssignedFulfillmentOrder.all({ session: session, assignment_status: "cancellation_requested", location_ids: ["24826418"], }); ``` #### response ```json HTTP/1.1 200 OK{"fulfillment_orders":[{"id":1046000787,"created_at":"2025-10-01T14:59:28-04:00","updated_at":"2025-10-01T14:59:28-04:00","shop_id":548380009,"order_id":450789469,"assigned_location_id":24826418,"request_status":"cancellation_requested","status":"in_progress","fulfill_at":null,"fulfill_by":null,"supported_actions":["create_fulfillment","cancel_fulfillment_order"],"destination":{"id":1042572119,"address1":"Chestnut Street 92","address2":"","city":"Louisville","company":null,"country":"United States","email":"bob.norman@mail.example.com","first_name":"Bob","last_name":"Norman","phone":"+1(502)-459-2181","province":"Kentucky","zip":"40202"},"line_items":[{"id":1072503284,"shop_id":548380009,"fulfillment_order_id":1046000787,"quantity":1,"line_item_id":518995019,"inventory_item_id":49148385,"fulfillable_quantity":1,"variant_id":49148385}],"outgoing_requests":[],"international_duties":null,"fulfillment_holds":[],"delivery_method":null,"assigned_location":{"address1":null,"address2":null,"city":null,"country_code":"DE","location_id":24826418,"name":"Apple Api Shipwire","phone":null,"province":null,"zip":null}}]} ```