---
title: "List fulfillments"
method: GET
path: "/object-query/fulfillments"
tags: ["Object Queries"]
---

# List fulfillments

`GET /object-query/fulfillments`

Lists Fulfillment objects. You can use the query parameters to filter, expand, and sort the returned results.

## Query parameters

- `pageSize` integer
- `cursor` string
- `sort[]` string[]
- `expand[]` string[]
- `filter[]` string[]
- `fields[]` string[]
- `includeNullFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Response `200`

OK

- object
  - `nextPage` string, nullable — A string that can be used as the `cursor` value to retrieve the next page of the response if it exists; otherwise absent.
  - `data` ExpandedFulfillment[]
    - `id` string — The unique identifier of the fulfillment.
    - `createdById` string — The unique identifier of the user who created the fulfillment.
    - `createdDate` string, date-time — The date and time when the fulfillment was created.
    - `updatedById` string — The unique identifier of the user who last updated the fulfillment.
    - `updatedDate` string, date-time — The date and time when the fulfillment was last updated.
    - `orderLineItemId` string — ID of the order line item.
    - `fulfillmentNumber` string — The sytem generated number for the fulfillment.
    - `fulfillmentType` 'Delivery' | 'Return' — The type of the fulfillment.
    - `fulfillmentDate` string, date — The date of the fulfillment.
    - `quantity` number — The quantity of the fulfillment.
    - `state` 'Executing' | 'Booked' | 'SentToBilling' | 'Complete' | 'Cancelled' — The state of the fulfillment. See <a href="https://docs.zuora.com?resourceId=billing-state-transitions-order-line-items" target="_blank">Order Line Item states, Order states, and state transitions</a> for more information.
    - `trackingNumber` string — The tracking number of the fulfillment.
    - `billTargetDate` string, date — The target date for the fulfillment to be picked up by bill run for billing.
    - `description` string — The description of the fulfillment.
    - `carrier` string — The carrier of the fulfillment. The available values can be managed in the Fulfillment Settings page under Billing Settings.
    - `fulfillmentLocation` string — The location of the fulfillment. The available values can be managed in the Fulfillment Settings page under Billing Settings.
    - `fulfillmentSystem` string — The system of the fulfillment. The available values can be managed in the Fulfillment Settings page under Billing Settings.
    - `externalId` string — The external ID of the fulfillment.
    - `excludeItemBookingFromRevenueAccounting` boolean — The flag to exclude fulfillment item from revenue accounting. **Note**: This field is only available if you have the <a href="https://docs.zuora.com?resourceId=billing-order-to-revenue" target="_blank">Order to Revenue</a> or <a href="https://docs.zuora.com?resourceId=revenue-billing-integration" target="_blank">Zuora Billing - Revenue Integration</a> feature enabled.
    - `excludeItemBillingFromRevenueAccounting` boolean — The flag to exclude fulfillment item from revenue accounting. **Note**: This field is only available if you have the <a href="https://docs.zuora.com?resourceId=billing-order-to-revenue" target="_blank">Order to Revenue</a> or <a href="https://docs.zuora.com?resourceId=revenue-billing-integration" target="_blank">Zuora Billing - Revenue Integration</a> feature enabled.

## Other responses

- `500` — Internal server error
- `4XX` — Invalid input

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)