Articles on: Tracking & Status

How to Track Royal Mail Packages

Introduction


This article explains the setup requirements that apply when tracking Royal Mail shipments on Ship24. To track a Royal Mail shipment correctly, you must include the courier code gb-post when submitting the tracking number. Without it, the shipment will not be tracked in our system.


Royal Mail also only shares new tracking events from the moment the tracker is created, which means earlier events will not be returned. This behavior is based on Royal Mail’s current data-sharing specifications.


What You'll Learn


This article will show you:


Before Your Start

Track Royal Mail Package on the Shipment Dashboard:

Track Royal Mail Packages with Ship24's API

Troubleshooting

Best Practice for Royal Mail Tracking


Before You Start


To track Royal Mail shipments correctly, you must use the courier code gb-post when submitting Royal Mail tracking numbers through the API. On the Shipment Dashboard, make sure you manually select Royal Mail when creating the tracker.


No historical data will be returned prior to adding the tracking number. Royal Mail only shares tracking events from the moment the tracker is created. This behavior comes from Royal Mail’s data-sharing policy.


If you do not provide gb-post in the API request, Royal Mail shipments cannot be tracked.


Track Royal Mail Packages on the Shipment Dashboard


Ship24’s Shipment Dashboard lets you add shipments manually, in bulk, or by CSV import. The dashboard supports adding a single shipment, multiple shipments, and file imports from one place.


Add One Royal Mail Shipment


Use this method if you want to track one package manually. On your Shipment Dashboard:


  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.




Tip: Add the tracker as early as possible in the delivery lifecycle. Royal Mail only returns events from the time the tracker is created.


Add Multiple Royal Mail Shipments with Bulk Paste


Use this option when you want to add several Royal Mail tracking numbers at once.


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




Tip: If a tracking number is invalid, it may be skipped during the import. The dashboard bulk paste flow supports large batches and is designed for faster manual upload.


Import Royal Mail Shipments via CSV File


Use CSV import if you manage your tracking numbers in a spreadsheet.


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




Tip: Ship24 also provides CSV templates for shipment imports in the dashboard workflow. Duplicate or already imported tracking numbers will be ignored.


When using the CSV template, make sure that "gb-post" is entered as the courier code.


Track Royal Mail Packages with Ship24's API


If you track Royal Mail packages through the API, create a tracker with the courier code gb-post.


Create a Single Royal Mail Tracker


Use a payload like this:


{

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


Bulk Create Royal Mail Trackers


Use a payload like this when creating multiple trackers at once:


[

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


For full request details, response fields, and endpoint specifications, see Ship24’s API Documentation.


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 correctly.


Earlier events are missing


This is expected for Royal Mail. Only events created after the tracker is added to Ship24 will be returned.


Best Practice for Royal Mail Tracking


Create the tracker as early as possible. For example, if the parcel had events on the 1st and 5th of the month, but you create the tracker on the 10th, only events from the 10th onward will be available.

Updated on: 02/04/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!