---
title: "Trackings"
method: POST
path: "/v4/trackings"
tags: ["Trackings"]
---

# Trackings

`POST /v4/trackings`

*Note: This is a chargeable service, and you are billed automatically based on the number of shipments tracked using the **Trackings** API.* 
<br />
<br />The **Trackings** API is an addition to the standard tracking webhook service, that automatically pushes tracking information for Royal Mail shipments created through Intersoft. This endpoint is intended for registering tracking numbers for shipments produced on other systems or different Intersoft accounts.
<br />
<br />
<br />It is essential to note that this endpoint should not be be used for Royal Mail shipments created on your own Intersoft account. The primary function of this endpoint is to monitor tracking events and push the data to the tracking webhook, ensuring effective tracking management.

## Request body

- CreateShipmentsToTrackRequest[]
  - `TrackingNumber` string, required — Tracking Number
  - `ShipperReference` string, nullable — Shipper Reference
  - `CarrierCode` string, required — Carrier Code
  - `CountryCode` string, nullable — Country Code
  - `Postcode` string, nullable — Postcode
  - `AccountNumber` string, nullable — Carrier Account Number <br />The account number given by the carrier.
  - `ShippingDate` string, date, nullable — Shipping Date <br />Shipping date in YYYY-MM-DD format. Required by some couriers. <br /> <br />Accepted Format: YYYY-MM-DD
  - `ServiceCode` string, nullable — Service Code

## Response `200`

Returns an array of tracking numbers and the shipment ids assigned to them, corresponding to future tracking information.

- ShipmentToTrackDetails[]
  - `TrackingNumber` string, nullable — Tracking Number as provided in the request
  - `CarrierCode` string, nullable — Carrier Code as provided in the request
  - `ShipmentId` string, uuid — Shipment Id generated for the shipment

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)