Site Logo

TNT UK Guide

TNT is a courier and logistics company that offers domestic and international shipping solutions for shipments originating in the UK. Their services include same-day delivery, next-day delivery, and international delivery options, as well as tracking and insurance for packages.

This guide provides developers an overview of shipping services that TNT UK offers and the service codes that you will use to create TNT shipments.

Connect Your Account

ShipEngine API allows you to connect your TNT accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing TNT accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect TNT UK using the ShipEngine API.

For instructions on connecting TNT via the ShipEngine dashboard, go to our TNT UK help article.

TNT UK Account Information Model

PropertyDescriptionTypeRequired?
usernameUsernamestringrequired
passwordPasswordstringrequired
countryAccount Countrystringrequired
domestic_accountDomestic Account Numberstringoptional
international_accountInternational Account Numberstringoptional

Example Request

POST /v1/connections/carriers/tnt_uk

1
2
3
4
5
6
7
8
9
10
11
12
POST /v1/connections/carriers/tnt_uk HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"username": "TNT_username"
"password": "pa55word",
"country": "United Kingdom",
"domestic_account": "12345",
"international_account": "6789",
}

Example Response

Your account will now appear in your carriers list with an assigned carrier_id that you will specify when creating TNT UK shipments.

1
2
3
{
"carrier-id": "se-1234567"
}

TNT Service Details

Domestic Services

ServiceMax DimensionsMax WeightService API Codes
EXPRESS Next Day Delivery3.6 x 1.8 x 2.12000kgstnt_uk_express
12:00 EXPRESS2.4 x 1.2 x 1.52000 kgstnt_uk_12_express
10:00 EXPRESS3.6 x 1.8 x 2.12000 kgstnt_uk_10_express
09:00 EXPRESS3.6 x 1.8 x 2.12000 kgstnt_uk_9_express
SATURDAYn/an/atnt_uk_saturday
12:00 SATURDAYn/an/atnt_uk_12_saturday
10:00 SATURDAYn/an/atnt_uk_10_saturday
09:00 SATURDAYn/an/atnt_uk_9_saturday
SATURDAY COLLECT MONDAY DELIVERn/an/atnt_uk_saturday_collect
12:00 SATURDAY COLLECT MONDAY DELIVERn/an/atnt_uk_12_saturday_collect
10:00 SATURDAY COLLECT MONDAY DELIVERn/an/atnt_uk_10_saturday_collect
09:00 SATURDAY COLLECT MONDAY DELIVERn/an/atnt_uk_9_saturday_collect

International Services

ServiceMax DimensionsMax WeightService API Codes
ECO EXPRESS2.4 x 1.2 x 1.870kgtnt_uk_economy_express
12:00 ECO EXPRESS2.4 x 1.2 x 1.570kgtnt_uk_12_economy_express
EXPRESS2.4 x 1.2 x 1.5500kgtnt_uk_international_express
12:00 EXPRESS2.4 x 1.2 x 1.5500kgtnt_uk_international_12_express
10:00 EXPRESS2.4 x 1.2 x 1.5210kgtnt_uk_international_10_express
09:00 EXPRESS2.4 x 1.2 x 1.5210kgtnt_uk_international_9_express

Packages

NameAPI CodePackage Attributes
Defaulttnt_uk_defaultInternational, Domestic

Return Services

TNT UK does support return labels for domestic shipments. Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Adding Shipment Insurance

TNT UK supports adding insurance to your shipments. Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

Shipping to Northern Ireland

TNT UK has made the following adjustments in accordance with the Windsor Framework. The Windsor Framework goes into effect 31st March 2025.

For shipments from Great Britain to Northern Ireland, TNT UK will require the usual customs declarations fields for all shipments. You must also print the commercial invoices for these shipments, just as you would for other cross-border shipments.

In the Products array:

  • description (must be detailed and describe the content accurately. Descriptions like "Gift" or "Merchandise" are not sufficient)
  • quantity
  • value (must include amount and currency)
  • harmonized_tariff_code
  • country_of_origin

For B2B shipments:

  • While not required to create a label successfully, you can declare the movement_indicator in the windsor_framework_details object. If you know the shipper and recipient UKIMS numbers, you should declare them in the tax_identifiers object in both the ship_to and ship_from objects.
  • If these values are not provided starting 31st March 2025, TNT UK's customs experts will identify whether the consignment is B2C or B2B and will contact you to obtain information regarding the shipment's risk indicator. UKIMS numbers will also be collected by TNT, if not provided when you create the label.

Additional Carrier Details

  • TNT UK does not have a void function. Labels that are created but never shipped expire after one week of inactivity.
  • Prior to using TNT services, users must complete the ExpressConnect & ExpressLabel Registration form. They can submit the completed form to [email protected] and we will submit the form to TNT on their behalf.

You are now ready to create shipments using TNT UK via ShipEngine!