---
updatedAt: 2025-11-11T23:06:37.000Z
agentTools:
  projectIndex: https://developers.shipup.co/llms.txt
---

# Fulfillment

## Example payload

```json
{
    "object": "fulfillment",
    "id": 42916,
    "custom_variables": null,
    "estimated_delivery_range_end": null,
    "estimated_delivery_range_start": null,
    "fulfillment_number": null,
    "merchant_id": null,
    "return_journey": false,
    "status_code": "pending",
    "updated_at": "2024-07-17T15:39:59Z",
    "uuid": "fe402ebf-4f70-4b0d-a50f-0e78bfe8914b",
    "created_at": "2024-07-17T00:00:00Z",
    "shipping_address": {
        "object": "address",
        "id": 83760
    },
    "trackers": {
        "object": "list",
        "data": [
            {
                "object": "tracker",
                "id": 37371
            }
        ]
    },
    "line_items": {
        "object": "list",
        "data": [
            {
                "object": "line_item",
                "id": 8793
            }
        ]
    },
    "notifications": {
        "object": "list",
        "data": [
            {
                "object": "notification",
                "id": 34768
            }
        ]
    },
}
```

<br />

## Attributes

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        FIELD
      </th>

      <th>
        DESCRIPTION
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **canceled**
        boolean
      </td>

      <td>
        Whether or not the fulfillment is canceled
      </td>
    </tr>

    <tr>
      <td>
        **custom\_variables**\
        object
      </td>

      <td>
        Custom variables for the fulfillment
      </td>
    </tr>

    <tr>
      <td>
        **estimated\_delivery\_range\_start**\
        datetime
      </td>

      <td>
        Estimated delivery date for the fulfillment. If estimated\_delivery\_range\_end is also provided, a range will be displayed. Otherwise, estimated\_delivery\_range\_start will be displayed alone  

        This field and `estimated_delivery_range_end` are currently only used to display a delivery estimate in the order view of your tracking page. The [tracker object](https://developers.shipup.co/reference/tracker-model)'s `displayable_expected_delivery_date` field is more globally used across Shipup
      </td>
    </tr>

    <tr>
      <td>
        **estimated\_delivery\_range\_end**\
        datetime
      </td>

      <td>
        End of estimated delivery date range for the fulfillment
      </td>
    </tr>

    <tr>
      <td>
        **fulfillment\_number**\
        string
      </td>

      <td>
        Shop reference of the fulfillment.
      </td>
    </tr>

    <tr>
      <td>
        **merchant\_id**\
        string
      </td>

      <td>
        ID used by the shop for the fulfillment
      </td>
    </tr>

    <tr>
      <td>
        **status\_code**\
        string
      </td>

      <td>
        Fulfillment status. See [available values](https://developers.shipup.co/reference/fulfillment-statuses) 
      </td>
    </tr>

    <tr>
      <td>
        **created\_at**\
        datetime
      </td>

      <td>
        Time at which the fulfillment was imported into Shipup
      </td>
    </tr>

    <tr>
      <td>
        **updated\_at**\
        datetime
      </td>

      <td>
        Time at which the fulfillment was last updated
      </td>
    </tr>
  </tbody>
</Table>

## Expandable resources

* [Order](https://developers.shipup.co/reference/order-api-resource)
* [Trackers](https://developers.shipup.co/reference/tracker-api-resource)
* [Line items](https://developers.shipup.co/reference/line-item-api-resource)
* [Shipping Address](https://developers.shipup.co/reference/address-api-resource)
* [Notifications](https://developers.shipup.co/reference/notification-api-resource)