POST
/
v1
/
merchant
/
track_shipment
Send order tracking details
curl --request POST \
  --url https://api.bolt.com/v1/merchant/track_shipment \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "carrier": "UPS",
  "items": [
    {
      "name": "Blue Hat",
      "quantity": 3,
      "reference": "1123",
      "total_amount": {
        "amount": 754,
        "currency": "USD",
        "currency_symbol": "$"
      },
      "unit_price": {
        "amount": 754,
        "currency": "USD",
        "currency_symbol": "$"
      },
      "bolt_product_id": "e2bb0e7e-5625-536f-8ad7-25a26537ee28",
      "brand": "Bolt Swagstore",
      "category": "hats",
      "collections": [
        "summer"
      ],
      "color": "Red",
      "customizations": [
        {
          "attributes": {
            "key1": "value1",
            "key2": "value2"
          },
          "name": "Bedazzled",
          "price": {
            "amount": 754,
            "currency": "USD",
            "currency_symbol": "$"
          }
        }
      ],
      "description": " Large blue satin hat with initials embroidered.",
      "details_url": "https://boltswagstore.com/inventory/hats/red-hat.png",
      "image_url": "https://boltswagstore.com/inventory/hats/red-hat.png",
      "isbn": "12-345-678-90123",
      "item_group": "Ships Immediately",
      "manufacturer": "Bolt Factory",
      "options": "string option",
      "properties": [
        {
          "name": "a-name",
          "value": "a-value"
        }
      ],
      "size": "XXL",
      "sku": "SKU-11021",
      "tags": "red",
      "taxable": true,
      "type": "physical",
      "uom": "string",
      "upc": "string",
      "weight": {
        "unit": "kg",
        "weight": 22
      }
    }
  ],
  "tracking_number": "EZ1000000001",
  "transaction_reference": "LBLJ-TWW7-R9VC",
  "is_non_bolt_order": false
}
'
{}

Authorizations

X-API-Key
string
header
required

Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.

Body

application/json

Send order tracking details.

carrier
string
required

the name of the carrier used for shipment.

Example:

"UPS"

items
object[]
required

A list of items.

tracking_number
string
required

The carrier's tracking number for the shipment.

Example:

"EZ1000000001"

transaction_reference
string
required

The transaction's 12-digit Bolt reference ID. Nullable for Transactions Details.

Required string length: 12
Example:

"LBLJ-TWW7-R9VC"

is_non_bolt_order
boolean

Designates if the order was placed outside of Bolt checkout.

Example:

false

Response

Order Tracking Successful

The response is of type object.