---
title: FulfillmentEvent
description: >-
  Create fulfillment events for an order's fulfillments. The fulfillment events
  are displayed on the order status page so the customer can track the progress
  of their delivery.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent'
  md: 'https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md'
api_name: admin-rest
api_type: rest
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Fulfillment​Event

**Requires \`orders\` access scope.:**

The FulfillmentEvent resource represents tracking events that belong to a [fulfillment](https://shopify.dev/docs/admin-api/rest/reference/shipping-and-fulfillment/fulfillment) of one or more items in an [order](https://shopify.dev/docs/admin-api/rest/reference/orders/order). Fulfillment events are displayed on the [order status page](https://help.shopify.com/manual/orders/status-tracking) to update customers on the status of their shipment.

\#

## Endpoints

* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#post-orders-order-id-fulfillments-fulfillment-id-events)

  [/admin/api/latest/orders/{order\_​id}/fulfillments/{fulfillment\_​id}/events.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#post-orders-order-id-fulfillments-fulfillment-id-events)

  Creates a fulfillment event

  [fulfillmentEventCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentEventCreate?example=creates-a-fulfillment-event)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#get-orders-order-id-fulfillments-fulfillment-id-events)

  [/admin/api/latest/orders/{order\_​id}/fulfillments/{fulfillment\_​id}/events.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#get-orders-order-id-fulfillments-fulfillment-id-events)

  Retrieves a list of fulfillment events for a specific fulfillment

  [fulfillment](https://shopify.dev/docs/api/admin-graphql/latest/queries/fulfillment?example=retrieves-a-list-of-fulfillment-events-for-a-specific-fulfillment)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#get-orders-order-id-fulfillments-fulfillment-id-events-event-id)

  [/admin/api/latest/orders/{order\_​id}/fulfillments/{fulfillment\_​id}/events/{event\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#get-orders-order-id-fulfillments-fulfillment-id-events-event-id)

  Retrieves a specific fulfillment event

  **deprecated**

* [del](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#delete-orders-order-id-fulfillments-fulfillment-id-events-event-id)

  [/admin/api/latest/orders/{order\_​id}/fulfillments/{fulfillment\_​id}/events/{event\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/fulfillmentevent.md#delete-orders-order-id-fulfillments-fulfillment-id-events-event-id)

  Deletes a fulfillment event

  **deprecated**

***

## The FulfillmentEvent resource

### Properties

***

address1

->[address1](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.address1)

The street address where the fulfillment event occurred.

***

city

->[city](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.city)

The city where the fulfillment event occurred.

***

country

->[country](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.country)

The country where the fulfillment event occurred.

***

created\_at

->[createdAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.createdAt)

The date and time ([ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format) when the fulfillment event was created.

***

estimated\_delivery\_at

->[estimatedDeliveryAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.estimatedDeliveryAt)

The estimated delivery date based on the fulfillment's tracking number, as long as it's provided by one of the following carriers: USPS, FedEx, UPS, or Canada Post (Canada only). Value is `null` if no tracking number is available or if the tracking number is from an unsupported carrier. This property is available only when [carrier calculated rates](https://help.shopify.com/manual/shipping/rates-and-methods/custom-calculated-rates) are in use.'

***

fulfillment\_id

An ID for the fulfillment that's associated with the fulfillment event.

***

happened\_at

->[happenedAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.happenedAt)

The date and time ([ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format) when the fulfillment event occurred.

***

id

->[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.id)

An ID for the fulfillment event.

***

latitude

->[latitude](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.latitude)

A geographic coordinate specifying the latitude of the fulfillment event.

***

longitude

->[longitude](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.longitude)

A geographic coordinate specifying the longitude of the fulfillment event.

***

message

->[message](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.message)

An arbitrary message describing the status. Can be provided by a shipping carrier.

***

order\_id

**deprecated**

The ID of the order that's associated with the fulfillment event.

***

{}

## The FulfillmentEvent resource

```json
{
  "address1": "3575 Boul. Saint-Laurent",
  "city": "Montreal",
  "country": "Canada",
  "created_at": "2012-03-13T16:09:54-04:00",
  "estimated_delivery_at": "2014-04-13T16:09:54-04:00",
  "fulfillment_id": 450789469,
  "happened_at": "2012-03-13T16:09:54-04:00",
  "id": 255858046,
  "latitude": 45.5017,
  "longitude": 73.5673,
  "message": "IN_TRANSIT",
  "order_id": 3183479,
  "province": "QC",
  "shop_id": 255858046,
  "status": "in_transit",
  "updated_at": "2012-03-15T16:09:54-04:00",
  "zip": "H2X 2R7"
}
```

***

## postCreates a fulfillment event

[fulfillmentEventCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentEventCreate?example=creates-a-fulfillment-event)

Creates a fulfillment event

### Parameters

***

api\_version

**string**

**required**

***

fulfillment\_id

**string**

**required**

***

order\_id

**string**

**required**

***

### Examples

### Create a fulfillment event

post

## /admin/api/2026-07/orders/450789469/fulfillments/255858046/events.​json

```bash
curl -d '{"event":{"status":"in_transit"}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 201 Created
{
  "fulfillment_event": {
    "id": 944956398,
    "fulfillment_id": 255858046,
    "status": "in_transit",
    "message": null,
    "happened_at": "2026-07-01T12:17:00-04:00",
    "city": null,
    "province": null,
    "country": null,
    "zip": null,
    "address1": null,
    "latitude": null,
    "longitude": null,
    "shop_id": 548380009,
    "created_at": "2026-07-01T12:17:00-04:00",
    "updated_at": "2026-07-01T12:17:00-04:00",
    "estimated_delivery_at": null,
    "order_id": 450789469,
    "admin_graphql_api_id": "gid://shopify/FulfillmentEvent/944956398"
  }
}
```

### examples

* #### Create a fulfillment event

  #####

  ```curl
  curl -d '{"event":{"status":"in_transit"}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 201 Created{"fulfillment_event":{"id":944956398,"fulfillment_id":255858046,"status":"in_transit","message":null,"happened_at":"2026-07-01T12:17:00-04:00","city":null,"province":null,"country":null,"zip":null,"address1":null,"latitude":null,"longitude":null,"shop_id":548380009,"created_at":"2026-07-01T12:17:00-04:00","updated_at":"2026-07-01T12:17:00-04:00","estimated_delivery_at":null,"order_id":450789469,"admin_graphql_api_id":"gid://shopify/FulfillmentEvent/944956398"}}
  ```

***

## getRetrieves a list of fulfillment events for a specific fulfillment

[fulfillment](https://shopify.dev/docs/api/admin-graphql/latest/queries/fulfillment?example=retrieves-a-list-of-fulfillment-events-for-a-specific-fulfillment)

Retrieves a list of fulfillment events for a specific fulfillment

### Parameters

***

api\_version

**string**

**required**

***

fulfillment\_id

**string**

**required**

***

order\_id

**string**

**required**

***

fulfillment\_id

The ID of the fulfillment that's associated with the fulfillment event.

***

order\_id

The ID of the order that's associated with the fulfillment event.

***

### Examples

### Retrieve a list of all the fulfillment events that are associated with a specific fulfillment

get

## /admin/api/2026-07/orders/450789469/fulfillments/255858046/events.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "fulfillment_events": [
    {
      "id": 944956397,
      "fulfillment_id": 255858046,
      "status": "in_transit",
      "message": null,
      "happened_at": "2026-07-01T12:17:00-04:00",
      "city": null,
      "province": null,
      "country": null,
      "zip": null,
      "address1": null,
      "latitude": null,
      "longitude": null,
      "shop_id": 548380009,
      "created_at": "2026-07-01T12:17:00-04:00",
      "updated_at": "2026-07-01T12:17:00-04:00",
      "estimated_delivery_at": null,
      "order_id": 450789469,
      "admin_graphql_api_id": "gid://shopify/FulfillmentEvent/944956397"
    }
  ]
}
```

### examples

* #### Retrieve a list of all the fulfillment events that are associated with a specific fulfillment

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"fulfillment_events":[{"id":944956397,"fulfillment_id":255858046,"status":"in_transit","message":null,"happened_at":"2026-07-01T12:17:00-04:00","city":null,"province":null,"country":null,"zip":null,"address1":null,"latitude":null,"longitude":null,"shop_id":548380009,"created_at":"2026-07-01T12:17:00-04:00","updated_at":"2026-07-01T12:17:00-04:00","estimated_delivery_at":null,"order_id":450789469,"admin_graphql_api_id":"gid://shopify/FulfillmentEvent/944956397"}]}
  ```

***

## getRetrieves a specific fulfillment event**deprecated**

Retrieves a specific fulfillment event

### Parameters

***

api\_version

**string**

**required**

***

event\_id

**string**

**required**

***

fulfillment\_id

**string**

**required**

***

order\_id

**string**

**required**

***

event\_id

The ID of the fulfillment event.

***

### Examples

### Retrieve a specific fulfillment event

get

## /admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956395.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956395.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "fulfillment_event": {
    "id": 944956395,
    "fulfillment_id": 255858046,
    "status": "in_transit",
    "message": null,
    "happened_at": "2026-07-01T12:16:59-04:00",
    "city": null,
    "province": null,
    "country": null,
    "zip": null,
    "address1": null,
    "latitude": null,
    "longitude": null,
    "shop_id": 548380009,
    "created_at": "2026-07-01T12:16:59-04:00",
    "updated_at": "2026-07-01T12:16:59-04:00",
    "estimated_delivery_at": null,
    "order_id": 450789469,
    "admin_graphql_api_id": "gid://shopify/FulfillmentEvent/944956395"
  }
}
```

### examples

* #### Retrieve a specific fulfillment event

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956395.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"fulfillment_event":{"id":944956395,"fulfillment_id":255858046,"status":"in_transit","message":null,"happened_at":"2026-07-01T12:16:59-04:00","city":null,"province":null,"country":null,"zip":null,"address1":null,"latitude":null,"longitude":null,"shop_id":548380009,"created_at":"2026-07-01T12:16:59-04:00","updated_at":"2026-07-01T12:16:59-04:00","estimated_delivery_at":null,"order_id":450789469,"admin_graphql_api_id":"gid://shopify/FulfillmentEvent/944956395"}}
  ```

***

## delDeletes a fulfillment event**deprecated**

Deletes a fulfillment event

### Parameters

***

api\_version

**string**

**required**

***

event\_id

**string**

**required**

***

fulfillment\_id

**string**

**required**

***

order\_id

**string**

**required**

***

### Examples

### Delete a fulfillment event

del

## /admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956396.​json

```bash
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956396.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{}
```

### examples

* #### Delete a fulfillment event

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/orders/450789469/fulfillments/255858046/events/944956396.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{}
  ```