> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ship24.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Track Royal Mail Packages

### Introduction

Royal Mail needs one specific setting to track correctly on Ship24. You must supply the courier code **gb-post** with the tracking number, or the shipment will not be tracked.

Royal Mail also only shares tracking events from the moment the tracker is created, so events that happened earlier are not returned. This comes from Royal Mail's own data-sharing specifications, not from Ship24.

### In this article

* [Before you start](#3-before-you-start)
* [Track Royal Mail on the Shipment Dashboard](#3-track-royal-mail-on-the-shipment-dashboard)
* [Track Royal Mail with the Tracking API](#3-track-royal-mail-with-the-tracking-api)
* [Troubleshooting](#3-troubleshooting)
* [Best practice](#3-best-practice)

### Before you start

Through the API, include the courier code **gb-post** when you create the tracker. On the Shipment Dashboard, select **Royal Mail** manually rather than relying on auto-detection.

||| Without gb-post, Royal Mail shipments cannot be tracked.

|| No historical data is returned for events before the tracker was added. Royal Mail only shares events from the moment the tracker is created.

### Track Royal Mail on the Shipment Dashboard

The Shipment Dashboard lets you [add shipments](https://help.ship24.com/en/article/how-to-add-shipments-to-your-shipment-dashboard-1nx8fp1/) one at a time, in bulk, or by CSV import.

###### Add one Royal Mail shipment

1. Click **Add shipment**.
2. Select the **Add one shipment** tab.
3. Enter your Royal Mail tracking number.
4. In the **Courier** field, select **Royal Mail**, or enter the courier code `gb-post`.
5. Click **Add shipment**.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/0/5/d/b05de28401784000/single-shipment_1hfdqfl.png =1600x756)

| Add the tracker as early as possible in the delivery journey, since Royal Mail only returns events from the time the tracker is created.

###### Add multiple Royal Mail shipments with bulk paste

1. Click **Add shipment**.
2. Select the **Add multiple shipments** tab.
3. Select **Royal Mail** manually, or enter `gb-post` as the courier.
4. Paste your tracking numbers into the text box, one per line.
5. Click **Add shipment**.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/0/5/d/b05de28401784000/multiple-shipment_1od7d5w.png =1600x760)

| Invalid tracking numbers are skipped during the import rather than stopping it.

###### Import Royal Mail shipments via CSV file

1. Click **Add shipment**.
2. Select the **CSV Import** tab.
3. Upload your CSV file.
4. Click **Add shipment** to start the import.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/0/5/d/b05de28401784000/csv-shipment_17m5pho.png =1600x760)

|| In your CSV file, enter `gb-post` in the `courier_code_1` column. See [how to add shipments](https://help.ship24.com/en/article/how-to-add-shipments-to-your-shipment-dashboard-1nx8fp1/) for the full column reference.

| Duplicate or already imported tracking numbers are ignored.

### Track Royal Mail with the Tracking API

Create the tracker with the courier code **gb-post**.

###### Create a single Royal Mail tracker

```json
{
  "trackingNumber": "LA076200660GB",
  "courierCode": ["gb-post"]
}
```

###### Create Royal Mail trackers in bulk

```json
[
  {
    "trackingNumber": "LA076200661GB",
    "courierCode": ["gb-post"]
  },
  {
    "trackingNumber": "LA076200662GB",
    "courierCode": ["gb-post"]
  },
  {
    "trackingNumber": "LA076200663GB",
    "courierCode": ["gb-post"]
  }
]
```

For request details, response fields and endpoint specifications, see the [Ship24 API documentation](https://docs.ship24.com/tracking-api-reference/). If you are new to the API, start with [getting started with the Ship24 Tracking API](https://help.ship24.com/en/article/getting-started-with-the-ship24-tracking-api-m8s3iw/).

### Troubleshooting

###### No tracking result appears

Check that you selected **Royal Mail** on the dashboard, or included **gb-post** in your API request. Without that courier setting, Royal Mail tracking will not work.

If the courier is set correctly and results are still empty, see [why the shipment status is Pending](https://help.ship24.com/en/article/why-is-the-shipment-status-pending-wk75bm/).

###### Earlier events are missing

This is expected. Only events recorded after the tracker was added to Ship24 are returned.

### Best practice

Create the tracker as early as possible. If a parcel had events on the 1st and the 5th of the month and you create the tracker on the 10th, only events from the 10th onward are available.

For Royal Mail specifically, that makes it worth creating trackers at the point you generate the label rather than in a nightly batch.