---
title: "Retrieve a fulfillment"
method: GET
path: "/object-query/fulfillments/{key}"
tags: ["Object Queries"]
---

# Retrieve a fulfillment

`GET /object-query/fulfillments/{key}`

Retrieves a Fulfillment object. You can use the query parameters to filter, expand, and sort the returned results.

## Path parameters

- `key` string, required

## 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

- 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)