Royal Mail Track & Trace(DG Data)
Returns the latest Royal Mail tracking status for a parcel from DigitalGenius carrier storage. Use it in tracking flows when Royal Mail events are already being ingested by DigitalGenius.
What it does
- Looks up the parcel's tracking history in DigitalGenius carrier storage by tracking number.
- Maps the latest Royal Mail event code to a simple delivery status (Delivered, In Transit, and so on).
- Returns the current status, description, key dates and the full event history.
Inputs
| Name | Type | Description |
|---|---|---|
| Tracking Number | String | Tracking reference for the package |
| DG API Key | String | API Key |
| DG API Secret | String | API Secret |
| DG Region | String | Region |
Outputs
| Name | Type | Description |
|---|---|---|
| Tracking Found? | Boolean | Whether any tracking info was found for the tracking number provided |
| Status | String | Status of the package delivery Possible values: Delivered, In Transit, Ready for Shipment, Ready for Pickup, Problem with Delivery, Returning to Sender. |
| Status Description | String | Status description of the package delivery |
| Last Event Date | String | Date of the last update |
| Shipped Date | String | Date when the package was shipped |
| Activity History | List | History of events for this package |
Notes
- This reads from DigitalGenius carrier storage rather than calling Royal Mail directly, so the tracking must already have been registered and ingested.
- The DG Region must match the region where the carrier data is stored.