---
updatedAt: 2026-10-29T11:54:48.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Retrieve order fulfillments

Retrieves a list of fulfillments for an order in your Yotpo store.

> 👍 How to use this endpoint
>
> * Required parameters are listed below. For the full list of properties, see [About order fulfillments](https://docs.yotpo.com/reference/order-fulfillments).
> * For example responses, click the relevant status code on the right.

> 📘 App partners
>
> Partner apps call this endpoint at `GET https://developers.yotpo.com/core/v3/stores/{store_id}/orders/{yotpo_order_id}/fulfillments`, with the access token the merchant's install gave you in the `X-Yotpo-Token` header. See [Authenticating with OAuth 2.0](https://docs.yotpo.com/docs/authenticating).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Yotpo API V3",
    "description": "Yotpo API V3 endpoints on api.yotpo.com. Webhook events are defined separately, in webhooks.json.",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://api.yotpo.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-Yotpo-Token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Yotpo-Token",
        "description": "Your Yotpo account access token. See [Authentication](https://core-api.yotpo.com/reference/yotpo-authentication) to learn how to generate your access token."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized. The access token is missing, invalid or expired. With an invalid or expired `X-Yotpo-Token` the body is plain text: generate a new token with [Generate access token](ref:yotpo-authentication). A request with an `Authorization` header and no `X-Yotpo-Token` gets `Bad token; invalid JSON` as JSON: send the token in `X-Yotpo-Token`. An `Authorization` header sent along with a valid `X-Yotpo-Token` is ignored.",
        "content": {
          "text/plain": {
            "schema": {
              "type": "string",
              "example": "unauthorized"
            }
          },
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "description": "Error message.",
                  "example": "Bad token; invalid JSON"
                }
              }
            },
            "examples": {
              "Authorization header without X-Yotpo-Token": {
                "value": "{\n  \"message\": \"Bad token; invalid JSON\"\n}"
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden. The request has no `X-Yotpo-Token` header.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "description": "Error message.",
                  "example": "Forbidden"
                }
              }
            },
            "examples": {
              "Missing token": {
                "value": "{\n  \"message\": \"Forbidden\"\n}"
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "X-Yotpo-Token": []
    }
  ],
  "paths": {
    "/core/v3/stores/{store_id}/orders/{yotpo_order_id}/fulfillments": {
      "get": {
        "summary": "Retrieve order fulfillments",
        "description": "Retrieves a list of fulfillments for an order in your Yotpo store.",
        "operationId": "retrieve-order-fulfillments",
        "parameters": [
          {
            "name": "store_id",
            "in": "path",
            "description": "The store ID (app_key).",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "yotpo_order_id",
            "in": "path",
            "description": "The Yotpo ID for the order. This ID is created automatically upon creation of the order. You can find it by using the Retrieve endpoint.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "page_info",
            "in": "query",
            "description": "Encoded page info.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The number of results per page, from 1 to 100. Defaults to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "external_ids",
            "in": "query",
            "description": "Return only entities specified by a comma-separated (without spaces) list of external IDs. The argument must be <a href=\"https://www.urlencoder.io/learn\" target=\"_blank\">URL encoded</a>. Max 100 IDs. Can't come with page_info or limit.",
            "schema": {
              "type": "string"
            },
            "example": "4444444"
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"fulfillments\": [\n    {\n      \"id\": 0,\n      \"external_id\": \"string\",\n      \"order_id\": 10199744826,\n      \"fulfillment_date\": \"2021-03-31T11:58:51Z\",\n      \"status\": \"pending\",\n      \"created_at\": \"2021-03-25T13:57:05Z\",\n      \"updated_at\": \"2021-03-26T13:57:05Z\",\n      \"shipment_info\": {\n        \"shipment_status\": \"label_printed\",\n        \"tracking_company\": \"string\",\n        \"tracking_url\": \"string\",\n        \"tracking_number\": \"string\"\n      },\n      \"fulfilled_items\": [\n        {\n          \"external_product_id\": \"sd24tvas\",\n          \"quantity\": 0\n        }\n      ],\n      \"store_id\": \"YOUR_STORE_ID\"\n    }\n  ],\n  \"pagination\": {\n    \"next_page_info\": \"string\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "fulfillments": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 0,
                            "default": 0,
                            "description": "The Yotpo ID of the fulfillment."
                          },
                          "external_id": {
                            "type": "string",
                            "example": "string",
                            "description": "The fulfillment ID in your store."
                          },
                          "order_id": {
                            "type": "integer",
                            "example": "string",
                            "description": "The Yotpo ID of the order."
                          },
                          "fulfillment_date": {
                            "type": "string",
                            "example": "2021-03-31T11:58:51Z",
                            "description": "When the fulfillment was created (UTC, ISO 8601 without a time zone suffix)."
                          },
                          "status": {
                            "type": "string",
                            "example": "pending",
                            "description": "The fulfillment status: `pending`, `open`, `success`, `cancelled`, `error` or `failure`. Review requests are sent only for `success`."
                          },
                          "created_at": {
                            "type": "string",
                            "example": "2021-03-25T13:57:05Z",
                            "description": "When the fulfillment was created in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2021-03-26T13:57:05Z",
                            "description": "When the fulfillment was last updated in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                          },
                          "shipment_info": {
                            "type": "object",
                            "properties": {
                              "shipment_status": {
                                "type": "string",
                                "example": "label_printed",
                                "description": "The shipment status, for example `in_transit` or `delivered`."
                              },
                              "tracking_company": {
                                "type": "string",
                                "example": "string",
                                "description": "The carrier, for example `UPS`."
                              },
                              "tracking_url": {
                                "type": "string",
                                "example": "string",
                                "description": "The carrier's tracking page for the shipment."
                              },
                              "tracking_number": {
                                "type": "string",
                                "example": "string",
                                "description": "The carrier's tracking number."
                              }
                            },
                            "description": "Shipment tracking details. Empty when none were sent."
                          },
                          "fulfilled_items": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "external_product_id": {
                                  "type": "string",
                                  "example": "sd24tvas",
                                  "description": "The product ID in your store."
                                },
                                "quantity": {
                                  "type": "integer",
                                  "example": 0,
                                  "default": 0,
                                  "description": "The quantity fulfilled."
                                }
                              }
                            },
                            "description": "The products and quantities in this fulfillment."
                          },
                          "store_id": {
                            "type": "string",
                            "description": "The store ID (app key).",
                            "example": "YOUR_STORE_ID"
                          }
                        }
                      },
                      "description": "The order's fulfillments."
                    },
                    "pagination": {
                      "type": "object",
                      "properties": {
                        "next_page_info": {
                          "type": "string",
                          "example": "string",
                          "description": "Pass this value as `page_info` to get the next page. Omitted on the last page."
                        }
                      },
                      "description": "Pagination details. Empty on the last page."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"message\": \"page size cannot be bigger than the allowed maximum: 100\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "message": {
                            "type": "string",
                            "example": "page size cannot be bigger than the allowed maximum: 100",
                            "description": "What's wrong with the request, usually naming the missing or invalid field. Meant for logs; the wording can change, so don't parse it."
                          }
                        }
                      },
                      "description": "The validation errors. Usually one item."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"message\": \"order not found\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "message": {
                            "type": "string",
                            "example": "order not found",
                            "description": "Says which object wasn't found. Meant for logs; the wording can change, so don't parse it."
                          }
                        }
                      },
                      "description": "The errors. Usually one item."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "value": "application/json",
        "key": "Content-Type"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [About orders](https://docs.yotpo.com/reference/orders.md)
* [Create order](https://docs.yotpo.com/reference/create-order.md)
* [Update order](https://docs.yotpo.com/reference/update-order.md)
* [Retrieve orders](https://docs.yotpo.com/reference/retrieve-orders.md)
* [Retrieve order by ID](https://docs.yotpo.com/reference/retrieve-order-by-id.md)
* [About order fulfillments](https://docs.yotpo.com/reference/order-fulfillments.md)
* [Create order fulfillment](https://docs.yotpo.com/reference/create-order-fulfillment.md)
* [Update order fulfillment](https://docs.yotpo.com/reference/update-order-fulfillment.md)
* [Retrieve fulfillment by ID](https://docs.yotpo.com/reference/retrieve-fulfillment-by-id.md)
* [About aggregated order info](https://docs.yotpo.com/reference/aggregated-order-info.md)
* [Send aggregated order info](https://docs.yotpo.com/reference/send-aggregated-order-info.md)