---
title: Fulfillment Object
seo:
  title: Fulfillment Object
  description: 'Object: Fulfillment Object'
slug: api-reference/orders/objects/fulfillment
sidebar:
  label: Fulfillment
search:
  tags:
    - API reference
    - Orders
lastModified: '2026-08-10'
---

Represents order fulfillment.



```graphql
type Fulfillment implements Node & ObjectWithMetadata {
  id: ID!
  privateMetadata: [MetadataItem!]!
  privateMetafield(key: String!): String
  privateMetafields(keys: [String!]): Metadata
  metadata: [MetadataItem!]!
  metafield(key: String!): String
  metafields(keys: [String!]): Metadata
  fulfillmentOrder: Int!
  status: FulfillmentStatus!
  trackingNumber: String!
  created: DateTime!
  lines: [FulfillmentLine!]
  statusDisplay: String
  warehouse: Warehouse
  shippingRefundedAmount: Money
  totalRefundedAmount: Money
  reason: String
  reasonReference: Page
}
```


## Interfaces

[`Node`](/api-reference/miscellaneous/interfaces/node), [`ObjectWithMetadata`](/api-reference/miscellaneous/interfaces/object-with-metadata)

## Fields

### id [#id]

**`id`** · [`ID!`](/api-reference/miscellaneous/scalars/id)

ID of the fulfillment.
### privateMetadata [#private-metadata]

**`privateMetadata`** · [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item)

List of private metadata items. Requires staff permissions to access.
### privateMetafield [#private-metafield]

**`privateMetafield`** · [`String`](/api-reference/miscellaneous/scalars/string)

A single key from private metadata. Requires staff permissions to access.

Tip: Use GraphQL aliases to fetch multiple keys.

#### key [#fulfillment-private-metafield-key]

**`key`** · [`String!`](/api-reference/miscellaneous/scalars/string)


### privateMetafields [#private-metafields]

**`privateMetafields`** · [`Metadata`](/api-reference/miscellaneous/scalars/metadata)

Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything.

#### keys [#fulfillment-private-metafields-keys]

**`keys`** · [`[String!]`](/api-reference/miscellaneous/scalars/string)


### metadata [#metadata]

**`metadata`** · [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item)

List of public metadata items. Can be accessed without permissions.
### metafield [#metafield]

**`metafield`** · [`String`](/api-reference/miscellaneous/scalars/string)

A single key from public metadata.

Tip: Use GraphQL aliases to fetch multiple keys.

#### key [#fulfillment-metafield-key]

**`key`** · [`String!`](/api-reference/miscellaneous/scalars/string)


### metafields [#metafields]

**`metafields`** · [`Metadata`](/api-reference/miscellaneous/scalars/metadata)

Public metadata. Use `keys` to control which fields you want to include. The default is to include everything.

#### keys [#fulfillment-metafields-keys]

**`keys`** · [`[String!]`](/api-reference/miscellaneous/scalars/string)


### fulfillmentOrder [#fulfillment-order]

**`fulfillmentOrder`** · [`Int!`](/api-reference/miscellaneous/scalars/int)

Sequence in which the fulfillments were created for an order.
### status [#status]

**`status`** · [`FulfillmentStatus!`](/api-reference/orders/enums/fulfillment-status)

Status of fulfillment.
### trackingNumber [#tracking-number]

**`trackingNumber`** · [`String!`](/api-reference/miscellaneous/scalars/string)

Fulfillment tracking number.
### created [#created]

**`created`** · [`DateTime!`](/api-reference/miscellaneous/scalars/date-time)

Date and time when fulfillment was created.
### lines [#lines]

**`lines`** · [`[FulfillmentLine!]`](/api-reference/orders/objects/fulfillment-line)

List of lines for the fulfillment.
### statusDisplay [#status-display]

**`statusDisplay`** · [`String`](/api-reference/miscellaneous/scalars/string)

User-friendly fulfillment status.
### warehouse [#warehouse]

**`warehouse`** · [`Warehouse`](/api-reference/products/objects/warehouse)

Warehouse from fulfillment was fulfilled.
### shippingRefundedAmount [#shipping-refunded-amount]

**`shippingRefundedAmount`** · [`Money`](/api-reference/miscellaneous/objects/money)

Amount of refunded shipping price.
### totalRefundedAmount [#total-refunded-amount]

**`totalRefundedAmount`** · [`Money`](/api-reference/miscellaneous/objects/money)

Total refunded amount assigned to this fulfillment.
### reason [#reason]

**`reason`** · [`String`](/api-reference/miscellaneous/scalars/string)

Reason for returning this fulfillment.

Added in Saleor 3.23

### reasonReference [#reason-reference]

**`reasonReference`** · [`Page`](/api-reference/pages/objects/page)

Reason Model (Page) reference for this fulfillment.

Added in Saleor 3.23

## Used by

- [FulfillmentApprove (objects)](/api-reference/orders/objects/fulfillment-approve)
- [FulfillmentApproved (objects)](/api-reference/orders/objects/fulfillment-approved)
- [FulfillmentCancel (objects)](/api-reference/orders/objects/fulfillment-cancel)
- [FulfillmentCanceled (objects)](/api-reference/orders/objects/fulfillment-canceled)
- [FulfillmentCreated (objects)](/api-reference/orders/objects/fulfillment-created)
- [FulfillmentMetadataUpdated (objects)](/api-reference/orders/objects/fulfillment-metadata-updated)
- [FulfillmentRefundProducts (objects)](/api-reference/orders/objects/fulfillment-refund-products)
- [FulfillmentReturnProducts (objects)](/api-reference/orders/objects/fulfillment-return-products)
- [FulfillmentTrackingNumberUpdated (objects)](/api-reference/orders/objects/fulfillment-tracking-number-updated)
- [FulfillmentUpdateTracking (objects)](/api-reference/orders/objects/fulfillment-update-tracking)
- [Order (objects)](/api-reference/orders/objects/order)
- [OrderFulfill (objects)](/api-reference/orders/objects/order-fulfill)

---

Schema: **Saleor 3.23.43**. [Download SDL](/schema/saleor.graphql).
