---
title: "Send order tracking details"
method: POST
path: "/v1/merchant/track_shipment"
tags: ["Orders"]
---

# Send order tracking details

`POST /v1/merchant/track_shipment`

Send the carrier and order tracking number to Bolt (after a label has been printed). Bolt then uses EasyPost to forward ongoing tracking event updates to the shopper. This request must include **all** items included in the shipment; their references must also match those found in the original cart generation.

## Request body

- object
  - `carrier` string, required — the name of the carrier used for shipment.
  - `is_non_bolt_order` boolean — Designates if the order was placed outside of Bolt checkout.
  - `items` Item[], required — A list of items.
    - `bolt_product_id` string — Unique ID generated for a product via the products endpoint.
    - `brand` string — The name of a brand.
    - `category` string — A category.
    - `collections` Collection[]
    - `color` string — The color.
    - `customizations` object[]
      - `attributes` MetadataComponent, required
        - `key1` string
        - `key2` string
      - `name` string, required — The name of the customization.
      - `price` Amounts, required — The amount. **Nullable** for Transactions Details.
        - `amount` integer, required — The amount in cents. **Nullable** for Transactions Details.
        - `currency` string, required — The 3-digit ISO code for the currency. **Nullable** for Transactions Details.
        - `currency_symbol` string, required — The currency symbol used for the amount. **Nullable** for Transactions Details.
    - `description` string — A description for the item added to the cart/order.
    - `details_url` string — The URL for the item's details.
    - `image_url` string — The URL for the item's image.
    - `isbn` string — A 13-digit identifier for a book item.
    - `item_group` string — Enables grouping in the checkout UI.
    - `manufacturer` string — The name of a manufacturer.
    - `name` string, required — The name of an item.
    - `options` string
    - `properties` ItemProperty[]
      - `name` string
      - `value` string
    - `quantity` integer, required — The quantity of this item.
    - `reference` string, required — Reference for the object.
    - `shipment_type` 'unknown' | 'door delivery' | 'in_store_pickup' | 'ship_to_store' — The shipment type selected by the shopper.
    - `size` string — The size.
    - `sku` string — The SKU identifier for this item or service.
    - `tags` string — A tag
    - `tax_amount` Amounts — The amount. **Nullable** for Transactions Details.
      - `amount` integer, required — The amount in cents. **Nullable** for Transactions Details.
      - `currency` string, required — The 3-digit ISO code for the currency. **Nullable** for Transactions Details.
      - `currency_symbol` string, required — The currency symbol used for the amount. **Nullable** for Transactions Details.
    - `taxable` boolean — Determines if item is taxable.
    - `total_amount` Amounts, required — The amount. **Nullable** for Transactions Details.
      - `amount` integer, required — The amount in cents. **Nullable** for Transactions Details.
      - `currency` string, required — The 3-digit ISO code for the currency. **Nullable** for Transactions Details.
      - `currency_symbol` string, required — The currency symbol used for the amount. **Nullable** for Transactions Details.
    - `type` 'bundled' | 'digital' | 'physical' | 'unknown' — Determines if item is a physical, digital, or bundled good, or if the good type is unknown.
    - `unit_price` Amounts, required — The amount. **Nullable** for Transactions Details.
      - `amount` integer, required — The amount in cents. **Nullable** for Transactions Details.
      - `currency` string, required — The 3-digit ISO code for the currency. **Nullable** for Transactions Details.
      - `currency_symbol` string, required — The currency symbol used for the amount. **Nullable** for Transactions Details.
    - `uom` string
    - `upc` string
    - `weight` TotalWeight
      - `unit` string — The unit of measurement for an item's weight.
      - `weight` integer — The weight of an item.
  - `tracking_number` string, required — The carrier's tracking number for the shipment.
  - `transaction_reference` string, required — The transaction's 12-digit Bolt reference ID. **Nullable** for Transactions Details.

## Response `200`

Order Tracking Successful

- object

## Other responses

- `400` — Generic Error Schema
- `422` — Generic Error Schema

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)