---
title: "Sync Shipment Tracking"
method: POST
path: "/shipments/{shipment_id}/sync"
tags: ["Shipments"]
---

# Sync Shipment Tracking

`POST /shipments/{shipment_id}/sync`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/shipments/{shipment_id}/sync`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/docs/shipments/:shipment_id/sync/post.ts> (a function with typed inputs; its response is checked against the schema)

Synchronizes shipment tracking information by fetching real-time data from the courier using the existing tracking number. This endpoint retrieves the latest tracking updates directly from the shipping provider and performs instant verification of the shipment status, ensuring that the shipment data is current and accurate.

## Path parameters

- `shipment_id` string, required

## Response `200`

An object representing the Shipment.

- ShipmentObject
  - `id` string: Unique identifier of the Shipment.
  - `merchant_invoice_id` string: ID of the associated merchant invoice.
  - `fulfillment_method` 'shipping_provider' | 'self_delivery' | 'customer_pickup' | 'services_only': Method of fulfillment for the shipment.
  - `shipment_tracking_number` string: Tracking number provided by the shipping courier.
  - `shipment_courier` string: Shipping courier or provider name. While any value can be accepted, instant verification is supported for specific couriers. See the [Shipments API documentation](#tag/Shipments) for the complete list of supported couriers.
  - `verification_status` 'verified' | 'pending': Manual or automatic verification status of the shipment.
  - `created_at` string, date-time: Date time when the shipment was created.
  - `updated_at` string, date-time: Date time when the shipment was last updated.
  - `tracking_status` string, nullable: Current tracking status of the shipment from the courier.
  - `tracking_substatus` string, nullable: Detailed tracking substatus providing additional context about the shipment's current state.
  - `expected_delivery` string, date-time, nullable: Expected delivery date and time provided by the shipping courier.

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `404`: Not found error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/revisions/5a1c75b8b404?raw)