---
updatedAt: 2026-10-29T08:22:22.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Send aggregated order info

Sends all relevant order information to Yotpo in one batch.

> 👍 How to use this endpoint
>
> * Required parameters are listed below. For the full list of properties, see [About aggregated order info](https://docs.yotpo.com/reference/aggregated-order-info). **Merchants using Yotpo Reviews must also add the "first\_name" and "last\_name" customer parameter.**
> * For example requests of full and minimal payload, see below.

## Example requests

```json Full payload
{
  "purchase": {
    "external_order_id": "000000006",
    "order_date": "2021-03-25T13:57:05Z",
    "checkout_token": "ll2lk3",
    "payment_method": "visa",
    "currency": "USD",
    "total_price": 20,
    "subtotal_price": 10,
    "landing_site_url": "https://www.example.com/surfboards",
    "payment_status": "paid",
    "customer": {
      "external_id": "ak123798684365sdfkj",
      "email": "name@example.com",
      "phone_number": "+14155550100",
      "first_name": "Tom",
      "last_name": "Smith",
      "custom_properties": {
        "membership": "gold"
      },
      "accepts_sms_marketing": false,
      "accepts_email_marketing": false
    },
    "billing_address": {
      "address1": "96 Coffee Street",
      "address2": "",
      "city": "Hudson",
      "company": "",
      "state": "New York",
      "zip": "13420",
      "province_code": "NY",
      "country_code": "US",
      "phone_number": "+14155550100"
    },
    "shipping_address": {
      "address1": "96 Coffee Street",
      "address2": "",
      "city": "Hudson",
      "company": "",
      "state": "New York",
      "zip": "13420",
      "province_code": "NY",
      "country_code": "US",
      "phone_number": "+14155550100"
    },
    "line_items": [
      {
        "quantity": 1,
        "total_price": 10,
        "subtotal_price": 10,
        "coupon_code": "hg4m",
        "custom_properties": {
          "color": "blue"
        },
        "product": {
          "external_id": "0000008",
          "name": "Minimal Surfboard",
          "description": "A great surfboard!",
          "url": "https://www.example.com/products/minimal-surfboard",
          "image_url": "https://www.example.com/images/minimal-surfboard.jpg",
          "price": 10,
          "currency": "USD",
          "inventory_quantity": 4,
          "is_discontinued": false,
          "group_name": "surfboards",
          "brand": "Waverider",
          "sku": "MS-001",
          "mpn": "MS-001-B",
          "gtins": [
            {
              "declared_type": "UPC",
              "value": "742833102466"
            }
          ]
        }
      }
    ],
    "fulfillments": [
      {
        "external_id": "5555555",
        "fulfillment_date": "2021-03-31T11:58:51Z",
        "status": "success",
        "shipment_info": {
          "shipment_status": "delivered",
          "tracking_company": "UPS",
          "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
          "tracking_number": "1Z999AA10123456784"
        },
        "fulfilled_items": [
          {
            "external_product_id": "0000008",
            "quantity": 1
          }
        ]
      }
    ],
    "custom_properties": {
      "delivery_type": "Express"
    }
  }
}
```
```json Minimal payload
{
   "purchase":{
      "external_order_id":"000000005",
      "order_date":"2021-03-25T13:57:05Z",
      "customer":{
         "external_id":"2sadfasdf"
      },
      "line_items":[
         {
            "product":{
               "external_id":"0000007",
               "name":"0000007"
            },
            "quantity":1
         }
      ]
   }
}
```

# 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 in `X-Yotpo-Token` is invalid or expired, and the body is plain text. Generate a new token with [Generate access token](ref:yotpo-authentication). If the request also has an `Authorization: Bearer` header, the API checks that header instead of `X-Yotpo-Token` and returns `Bad token; invalid JSON` as JSON. Remove the `Authorization` header and send the token in `X-Yotpo-Token` only.",
        "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 sent": {
                "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}/register_purchase": {
      "post": {
        "summary": "Send aggregated order info",
        "description": "Sends all relevant order information to Yotpo in one batch.",
        "operationId": "send-aggregated-order-info",
        "parameters": [
          {
            "name": "store_id",
            "in": "path",
            "description": "The store ID (app_key)",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK. The response has no body."
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"message\": \"all line item products must contain external_id\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "message": {
                            "type": "string",
                            "example": "all line item products must contain external_id",
                            "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"
          }
        },
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "purchase"
                ],
                "properties": {
                  "purchase": {
                    "type": "object",
                    "description": "All of the order's information, including its products and fulfillments. [See About aggregated order info](https://core-api.yotpo.com/reference/aggregated-order-info)",
                    "required": [
                      "external_order_id",
                      "order_date",
                      "customer",
                      "line_items"
                    ],
                    "properties": {
                      "external_order_id": {
                        "type": "string",
                        "description": "The merchant's unique ID for the order."
                      },
                      "order_date": {
                        "type": "string",
                        "description": "The date the order was created in the store, in ISO 8601 date-time format. Automatic review request emails aren't sent for orders older than six months.",
                        "format": "date-time"
                      },
                      "checkout_token": {
                        "type": "string",
                        "description": "The ID of the checkout associated with the order."
                      },
                      "payment_method": {
                        "type": "string",
                        "description": "The payment method used to pay for the order. For example, \"Visa\". Max. length: 64 characters."
                      },
                      "currency": {
                        "type": "string",
                        "description": "The currency in which the order was made. Must be a valid 3-character ISO code. [See currency codes](https://www.iban.com/currency-codes)"
                      },
                      "total_price": {
                        "type": "number",
                        "format": "double",
                        "description": "The sum of all line item prices, discounts, shipping, taxes, and tips. Uses the shop currency."
                      },
                      "subtotal_price": {
                        "type": "number",
                        "format": "double",
                        "description": "The price of the order after discounts but before shipping, taxes, and tips. Uses the shop currency."
                      },
                      "landing_site_url": {
                        "type": "string",
                        "description": "The URL of the page where the buyer landed when they entered the shop."
                      },
                      "payment_status": {
                        "type": "string",
                        "description": "The status of payments associated with the order.",
                        "enum": [
                          "pending",
                          "authorized",
                          "partially_paid",
                          "paid",
                          "partially_refunded",
                          "refunded",
                          "voided"
                        ]
                      },
                      "cancellation": {
                        "type": "object",
                        "description": "The cancellation info object.",
                        "required": [
                          "cancellation_date"
                        ],
                        "properties": {
                          "cancellation_date": {
                            "type": "string",
                            "description": "The date on which the order was cancelled. Format must be ISO 8601.",
                            "format": "date-time"
                          }
                        }
                      },
                      "customer": {
                        "type": "object",
                        "description": "Information about the customer. Merchants using Yotpo Reviews must also send `first_name` and `last_name`.",
                        "properties": {
                          "external_id": {
                            "type": "string",
                            "description": "A unique customer identifier, used to create profiles, attribute events, and merge profiles. If you don't have a unique identifier for the customer, omit this property. On Shopify, use the Shopify customer ID. Max. length: 255 characters."
                          },
                          "email": {
                            "type": "string",
                            "description": "The email address of the customer. Max. length: 255 characters."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "The phone number of the customer. Max. length: 255 characters."
                          },
                          "first_name": {
                            "type": "string",
                            "description": "The first name of the customer. Required when using Yotpo Reviews. Max. length: 255 characters."
                          },
                          "last_name": {
                            "type": "string",
                            "description": "The last name of the customer. Required when using Yotpo Reviews. Max. length: 255 characters."
                          },
                          "custom_properties": {
                            "type": "object",
                            "description": "Custom key-value pairs about the customer. Each key is stored on the order's `custom_properties` with a `customer_` prefix (for example `membership` becomes `customer_membership`)."
                          },
                          "accepts_sms_marketing": {
                            "type": "boolean",
                            "description": "Whether the customer accepts SMS marketing."
                          },
                          "accepts_email_marketing": {
                            "type": "boolean",
                            "description": "Whether the customer accepts email marketing."
                          }
                        }
                      },
                      "billing_address": {
                        "type": "object",
                        "description": "The billing address for this order.",
                        "properties": {
                          "address1": {
                            "type": "string",
                            "description": "The first line of the address. Max. length: 255 characters."
                          },
                          "address2": {
                            "type": "string",
                            "description": "The second line of the address. Max. length: 255 characters."
                          },
                          "city": {
                            "type": "string",
                            "description": "The name of the city, district, village, or town of the address. Max. length: 255 characters."
                          },
                          "company": {
                            "type": "string",
                            "description": "The name of the company or organization in the address. Max. length: 255 characters."
                          },
                          "state": {
                            "type": "string",
                            "description": "The state the address is located in. Max. length: 64 characters."
                          },
                          "zip": {
                            "type": "string",
                            "description": "The zip or postal code of the address. Max. length: 64 characters."
                          },
                          "province_code": {
                            "type": "string",
                            "description": "The two-letter code for the region of the address. Max. length: 64 characters."
                          },
                          "country_code": {
                            "type": "string",
                            "description": "The country of the address. Must be a valid 2-character ISO code. Default value: `US`. [See country codes](https://datahub.io/core/country-list). Max. length: 64 characters."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "The phone number in E.164 format. Max. length: 64 characters."
                          }
                        }
                      },
                      "shipping_address": {
                        "type": "object",
                        "description": "The shipping address for this order.",
                        "properties": {
                          "address1": {
                            "type": "string",
                            "description": "The first line of the address. Max. length: 255 characters."
                          },
                          "address2": {
                            "type": "string",
                            "description": "The second line of the address. Max. length: 255 characters."
                          },
                          "city": {
                            "type": "string",
                            "description": "The name of the city, district, village, or town of the address. Max. length: 255 characters."
                          },
                          "company": {
                            "type": "string",
                            "description": "The name of the company or organization in the address. Max. length: 255 characters."
                          },
                          "state": {
                            "type": "string",
                            "description": "The state the address is located in. Max. length: 64 characters."
                          },
                          "zip": {
                            "type": "string",
                            "description": "The zip or postal code of the address. Max. length: 64 characters."
                          },
                          "province_code": {
                            "type": "string",
                            "description": "The two-letter code for the region of the address. Max. length: 64 characters."
                          },
                          "country_code": {
                            "type": "string",
                            "description": "The country of the address. Must be a valid 2-character ISO code. Default value: `US`. [See country codes](https://datahub.io/core/country-list). Max. length: 64 characters."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "The phone number in E.164 format. Max. length: 64 characters."
                          }
                        }
                      },
                      "line_items": {
                        "type": "array",
                        "description": "The products purchased and the quantity of each. Each line item carries the full product, so products don't need to be synced beforehand.",
                        "items": {
                          "type": "object",
                          "required": [
                            "product",
                            "quantity"
                          ],
                          "properties": {
                            "quantity": {
                              "type": "integer",
                              "description": "The quantity of the line item."
                            },
                            "total_price": {
                              "type": "number",
                              "format": "double",
                              "description": "The total price of the line item."
                            },
                            "subtotal_price": {
                              "type": "number",
                              "format": "double",
                              "description": "The price of the products after discounts but before shipping, taxes, and tips."
                            },
                            "coupon_code": {
                              "type": "string",
                              "description": "The coupon code used in the purchase. Case sensitive. Max. length: 255 characters."
                            },
                            "custom_properties": {
                              "type": "object",
                              "description": "A key-value set of additional properties for the line item.",
                              "properties": {
                                "suppress_review_request": {
                                  "type": "boolean",
                                  "description": "When `true`, prevents Yotpo from sending automatic review requests for this product in the order."
                                },
                                "color": {
                                  "type": "string",
                                  "description": "The color of the line item's product (review metadata)."
                                },
                                "size": {
                                  "type": "string",
                                  "description": "The size of the line item's product (review metadata)."
                                },
                                "vendor": {
                                  "type": "string",
                                  "description": "The vendor of the line item's product (review metadata)."
                                },
                                "material": {
                                  "type": "string",
                                  "description": "The material of the line item's product (review metadata)."
                                },
                                "model": {
                                  "type": "string",
                                  "description": "The model of the line item's product (review metadata)."
                                },
                                "coupon_used": {
                                  "type": "boolean",
                                  "description": "Indicates if a coupon was used in the purchase of this line item (review metadata)."
                                },
                                "custom": {
                                  "type": "string",
                                  "description": "Any other information you want to link to the line item (review metadata)."
                                }
                              }
                            },
                            "product": {
                              "type": "object",
                              "required": [
                                "external_id",
                                "name"
                              ],
                              "properties": {
                                "external_id": {
                                  "type": "string",
                                  "description": "The merchant's unique ID for the product. Max. length: 255 characters."
                                },
                                "name": {
                                  "type": "string",
                                  "description": "The name of the product. Max. length: 255 characters."
                                },
                                "description": {
                                  "type": "string",
                                  "description": "The description of the product."
                                },
                                "url": {
                                  "type": "string",
                                  "description": "The URL of the product. Max. length: 2048 characters."
                                },
                                "image_url": {
                                  "type": "string",
                                  "description": "The URL of the product image. Max. length: 2048 characters."
                                },
                                "price": {
                                  "type": "number",
                                  "format": "double",
                                  "description": "The price of the product."
                                },
                                "currency": {
                                  "type": "string",
                                  "description": "The currency of the product. Must be a valid 3-character ISO code. [See currency codes](https://www.iban.com/currency-codes)"
                                },
                                "inventory_quantity": {
                                  "type": "integer",
                                  "description": "The number of items available in stock."
                                },
                                "is_discontinued": {
                                  "type": "boolean",
                                  "description": "Whether the product has been discontinued. Discontinued products are automatically added to the blocklist."
                                },
                                "group_name": {
                                  "type": "string",
                                  "description": "Products with the same group name will share reviews. If left empty, the product will be removed from its existing group. You can add up to 1,000 products to a group. [Learn more about grouping products](https://support.yotpo.com/docs/grouping-products). Max. length: 100 characters. Valid values: alphanumeric characters a-z, 0-9, \"_\" and \"-\"."
                                },
                                "brand": {
                                  "type": "string",
                                  "description": "The brand of the product. Important for Google and retail syndication integrations. Max. length: 255 characters."
                                },
                                "sku": {
                                  "type": "string",
                                  "description": "Stock-Keeping Unit. Cannot contain spaces or the \"/\" symbol. Max. length: 255 characters."
                                },
                                "mpn": {
                                  "type": "string",
                                  "description": "The Manufacturer Part Number of the product. Important for Google and retail syndication integrations. Max. length: 255 characters."
                                },
                                "gtins": {
                                  "type": "array",
                                  "description": "Global trade item numbers, often called barcodes. Important for Google and retail syndication integrations. [See GTIN object description](https://core-api.yotpo.com/docs/gtin)",
                                  "items": {
                                    "type": "object",
                                    "required": [
                                      "declared_type",
                                      "value"
                                    ],
                                    "properties": {
                                      "declared_type": {
                                        "type": "string",
                                        "description": "The GTIN standard.",
                                        "enum": [
                                          "EAN",
                                          "UPC",
                                          "ISBN"
                                        ]
                                      },
                                      "value": {
                                        "type": "string",
                                        "description": "The GTIN value."
                                      }
                                    }
                                  }
                                }
                              },
                              "description": "The purchased product. Created in your catalog if it doesn't exist yet. [See product properties](https://core-api.yotpo.com/reference/products)"
                            }
                          }
                        }
                      },
                      "fulfillments": {
                        "type": "array",
                        "description": "Fulfillment actions related to the order. Review requests are sent only for fulfilled orders (`status` = `success` with a `fulfillment_date`). Max. objects: 100. [See order fulfillments](https://core-api.yotpo.com/reference/order-fulfillments)",
                        "items": {
                          "type": "object",
                          "description": "An order fulfillment.",
                          "required": [
                            "external_id",
                            "fulfillment_date",
                            "status",
                            "fulfilled_items"
                          ],
                          "properties": {
                            "external_id": {
                              "type": "string",
                              "description": "The merchant's unique ID for the fulfillment."
                            },
                            "fulfillment_date": {
                              "type": "string",
                              "description": "The date the fulfillment was created. Format must be ISO 8601. Required for sending review requests.",
                              "format": "date-time"
                            },
                            "status": {
                              "type": "string",
                              "description": "The status of the fulfillment. Must be set to `success` for review requests to be sent.",
                              "enum": [
                                "pending",
                                "open",
                                "success",
                                "cancelled",
                                "error",
                                "failure"
                              ]
                            },
                            "shipment_info": {
                              "type": "object",
                              "description": "The shipping info object.",
                              "properties": {
                                "shipment_status": {
                                  "type": "string",
                                  "description": "The current shipment status of the fulfillment.",
                                  "enum": [
                                    "label_printed",
                                    "label_purchased",
                                    "attempted_delivery",
                                    "ready_for_pickup",
                                    "confirmed",
                                    "in_transit",
                                    "out_for_delivery",
                                    "delivered",
                                    "failure"
                                  ]
                                },
                                "tracking_company": {
                                  "type": "string",
                                  "description": "The name of the tracking company."
                                },
                                "tracking_url": {
                                  "type": "string",
                                  "description": "The URL of the tracking page for the shipment."
                                },
                                "tracking_number": {
                                  "type": "string",
                                  "description": "The tracking number as provided by the shipping company."
                                }
                              }
                            },
                            "fulfilled_items": {
                              "type": "array",
                              "description": "Information about the specific items fulfilled (i.e. product and quantity). Providing a fulfillment with an external product ID that is not included in the order will result in a bad request.",
                              "items": {
                                "type": "object",
                                "required": [
                                  "external_product_id",
                                  "quantity"
                                ],
                                "properties": {
                                  "external_product_id": {
                                    "type": "string",
                                    "description": "The merchant's unique ID for the product."
                                  },
                                  "quantity": {
                                    "type": "integer",
                                    "description": "The quantity actually fulfilled."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "custom_properties": {
                        "type": "object",
                        "description": "A key-value set of additional properties. Max. properties: 100. [Learn more](https://core-api.yotpo.com/reference/orders)",
                        "properties": {
                          "suppress_review_request": {
                            "type": "boolean",
                            "description": "When `true`, prevents Yotpo from sending automatic review requests for this order. To suppress requests for specific products only, set this on the relevant line items instead."
                          },
                          "coupon_used": {
                            "type": "boolean",
                            "description": "Indicates if a coupon was used in the purchase (review metadata)."
                          },
                          "delivery_type": {
                            "type": "string",
                            "description": "The type of shipping or delivery used (review metadata)."
                          },
                          "customer_state": {
                            "type": "string",
                            "description": "The state the customer is located in (review metadata). Max. length: 64 characters."
                          },
                          "customer_country": {
                            "type": "string",
                            "description": "The country the customer is located in (review metadata). Must be a valid 2-character ISO code. Default value: `US`. Required if you use Google seller ratings and gather site reviews from outside the US. Max. length: 64 characters."
                          },
                          "customer_address": {
                            "type": "string",
                            "description": "The customer's home address (review metadata)."
                          },
                          "customer_phonenumber": {
                            "type": "string",
                            "description": "The customer's phone number in E.164 format (review metadata). Max. length: 64 characters."
                          },
                          "custom": {
                            "type": "string",
                            "description": "Any other information you want to link to the order (review metadata)."
                          }
                        }
                      }
                    }
                  }
                }
              },
              "examples": {
                "Minimal payload": {
                  "value": {
                    "purchase": {
                      "external_order_id": "000000005",
                      "order_date": "2021-03-25T13:57:05Z",
                      "customer": {
                        "external_id": "2sadfasdf"
                      },
                      "line_items": [
                        {
                          "product": {
                            "external_id": "0000007",
                            "name": "0000007"
                          },
                          "quantity": 1
                        }
                      ]
                    }
                  }
                },
                "Full payload": {
                  "value": {
                    "purchase": {
                      "external_order_id": "000000006",
                      "order_date": "2021-03-25T13:57:05Z",
                      "checkout_token": "ll2lk3",
                      "payment_method": "visa",
                      "currency": "USD",
                      "total_price": 20,
                      "subtotal_price": 10,
                      "landing_site_url": "https://www.example.com/surfboards",
                      "payment_status": "paid",
                      "customer": {
                        "external_id": "ak123798684365sdfkj",
                        "email": "name@example.com",
                        "phone_number": "+14155550100",
                        "first_name": "Tom",
                        "last_name": "Smith",
                        "custom_properties": {
                          "membership": "gold"
                        },
                        "accepts_sms_marketing": false,
                        "accepts_email_marketing": false
                      },
                      "billing_address": {
                        "address1": "96 Coffee Street",
                        "address2": "",
                        "city": "Hudson",
                        "company": "",
                        "state": "New York",
                        "zip": "13420",
                        "province_code": "NY",
                        "country_code": "US",
                        "phone_number": "+14155550100"
                      },
                      "shipping_address": {
                        "address1": "96 Coffee Street",
                        "address2": "",
                        "city": "Hudson",
                        "company": "",
                        "state": "New York",
                        "zip": "13420",
                        "province_code": "NY",
                        "country_code": "US",
                        "phone_number": "+14155550100"
                      },
                      "line_items": [
                        {
                          "quantity": 1,
                          "total_price": 10,
                          "subtotal_price": 10,
                          "coupon_code": "hg4m",
                          "custom_properties": {
                            "color": "blue"
                          },
                          "product": {
                            "external_id": "0000008",
                            "name": "Minimal Surfboard",
                            "description": "A great surfboard!",
                            "url": "https://www.example.com/products/minimal-surfboard",
                            "image_url": "https://www.example.com/images/minimal-surfboard.jpg",
                            "price": 10,
                            "currency": "USD",
                            "inventory_quantity": 4,
                            "is_discontinued": false,
                            "group_name": "surfboards",
                            "brand": "Waverider",
                            "sku": "MS-001",
                            "mpn": "MS-001-B",
                            "gtins": [
                              {
                                "declared_type": "UPC",
                                "value": "742833102466"
                              }
                            ]
                          }
                        }
                      ],
                      "fulfillments": [
                        {
                          "external_id": "5555555",
                          "fulfillment_date": "2021-03-31T11:58:51Z",
                          "status": "success",
                          "shipment_info": {
                            "shipment_status": "delivered",
                            "tracking_company": "UPS",
                            "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
                            "tracking_number": "1Z999AA10123456784"
                          },
                          "fulfilled_items": [
                            {
                              "external_product_id": "0000008",
                              "quantity": 1
                            }
                          ]
                        }
                      ],
                      "custom_properties": {
                        "delivery_type": "Express"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "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 order fulfillments](https://docs.yotpo.com/reference/retrieve-order-fulfillments.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)