> Documentation index: [Saleor](/llms.txt) · [This section](/api-reference/orders/llms.txt)
> Source: https://docs.saleor.io/api-reference/orders/objects/fulfillment

# Fulfillment Object

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
}
```

<a id="fields"></a>

### Fields

<a id="id"></a>

#### [`id`](#id) ● [`ID!`](/api-reference/miscellaneous/scalars/id.md)

ID of the fulfillment.

<a id="private-metadata"></a>

#### [`privateMetadata`](#private-metadata) ● [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item.md)

List of private metadata items. Requires staff permissions to access.

<a id="private-metafield"></a>

#### [`privateMetafield`](#private-metafield) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

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

Tip: Use GraphQL aliases to fetch multiple keys.

<a id="fulfillment-private-metafield-key"></a>

##### [`key`](#fulfillment-private-metafield-key) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

<a id="private-metafields"></a>

#### [`privateMetafields`](#private-metafields) ● [`Metadata`](/api-reference/miscellaneous/scalars/metadata.md)

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

<a id="fulfillment-private-metafields-keys"></a>

##### [`keys`](#fulfillment-private-metafields-keys) ● [`[String!]`](/api-reference/miscellaneous/scalars/string.md)

<a id="metadata"></a>

#### [`metadata`](#metadata) ● [`[MetadataItem!]!`](/api-reference/miscellaneous/objects/metadata-item.md)

List of public metadata items. Can be accessed without permissions.

<a id="metafield"></a>

#### [`metafield`](#metafield) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

A single key from public metadata.

Tip: Use GraphQL aliases to fetch multiple keys.

<a id="fulfillment-metafield-key"></a>

##### [`key`](#fulfillment-metafield-key) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

<a id="metafields"></a>

#### [`metafields`](#metafields) ● [`Metadata`](/api-reference/miscellaneous/scalars/metadata.md)

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

<a id="fulfillment-metafields-keys"></a>

##### [`keys`](#fulfillment-metafields-keys) ● [`[String!]`](/api-reference/miscellaneous/scalars/string.md)

<a id="fulfillment-order"></a>

#### [`fulfillmentOrder`](#fulfillment-order) ● [`Int!`](/api-reference/miscellaneous/scalars/int.md)

Sequence in which the fulfillments were created for an order.

<a id="status"></a>

#### [`status`](#status) ● [`FulfillmentStatus!`](/api-reference/orders/enums/fulfillment-status.md)

Status of fulfillment.

<a id="tracking-number"></a>

#### [`trackingNumber`](#tracking-number) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

Fulfillment tracking number.

<a id="created"></a>

#### [`created`](#created) ● [`DateTime!`](/api-reference/miscellaneous/scalars/date-time.md)

Date and time when fulfillment was created.

<a id="lines"></a>

#### [`lines`](#lines) ● [`[FulfillmentLine!]`](/api-reference/orders/objects/fulfillment-line.md)

List of lines for the fulfillment.

<a id="status-display"></a>

#### [`statusDisplay`](#status-display) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

User-friendly fulfillment status.

<a id="warehouse"></a>

#### [`warehouse`](#warehouse) ● [`Warehouse`](/api-reference/products/objects/warehouse.md)

Warehouse from fulfillment was fulfilled.

<a id="shipping-refunded-amount"></a>

#### [`shippingRefundedAmount`](#shipping-refunded-amount) ● [`Money`](/api-reference/miscellaneous/objects/money.md)

Amount of refunded shipping price.

<a id="total-refunded-amount"></a>

#### [`totalRefundedAmount`](#total-refunded-amount) ● [`Money`](/api-reference/miscellaneous/objects/money.md)

Total refunded amount assigned to this fulfillment.

<a id="reason"></a>

#### [`reason`](#reason) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Reason for returning this fulfillment.

Added in Saleor 3.23

<a id="reason-reference"></a>

#### [`reasonReference`](#reason-reference) ● [`Page`](/api-reference/pages/objects/page.md)

Reason Model (Page) reference for this fulfillment.

Added in Saleor 3.23

<a id="interfaces"></a>

### Interfaces

<a id="node"></a>

#### [`Node`](/api-reference/miscellaneous/interfaces/node.md)

An object with an ID

<a id="objectwithmetadata"></a>

#### [`ObjectWithMetadata`](/api-reference/miscellaneous/interfaces/object-with-metadata.md)

<a id="member-of"></a>

### Member Of

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