Yodel Guide

Yodel offers domestic and international shipping solutions for shipments originating in Great Britain.

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

Connect Your Account

ShipEngine API allows you to connect your Yodel accounts programmatically without logging in to the ShipEngine API dashboard. This capability 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 Yodel 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 Yodel using the ShipEngine API.

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

Yodel Account Information Model

Property	Description	Type
nickname	This is a nickname for you to identify the carrier account in ShipEngine.	string, required
user_id	User ID	string, required
password	Password	string, required
account_id	Account ID	string, required

Example Request

POST /v1/connections/carriers/yodel

1
2
3
4
5
6
7
8
9
10
11
POST /v1/connections/carriers/yodel HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "nickname": "Test Yodel Account",
  "user_id": "your_user_id_here",
  "account_id": "your_account_id_here",
  "password": "your_password_here"
}

Example Response

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

Yodel Service Details

Carriers may update their service options at any time. To ensure you are always using valid services, be sure to use the List Carrier Services call.
You can also visit the Yodel Services page for additional service details.

Yodel Domestic Service Details

(Click to open)

NOTE: Not all services listed are available to every Yodel account. We recommend you check with Yodel so you know which services are available to your account, or use the List Services call.

Service	Carrier Code	Transit Time	Max Length	Max Weight	Service API Codes
Xpress 24 POD UK excl. NI	1CP	Next Day, Two-Day	90cm	17kg	`xpress_24_pod_uk_excl_ni`
Xpress 24 Non-POD UK excl. NI	1CN	Next Day, Two-Day	90cm	17kg	`xpress_24_non_pod_uk_excl_ni`
Xpress 48 POD UK excl. NI	2CP	Next Day, Two-Day	90cm	17kg	`xpress_48_pod_uk_excl_ni`
Xpress 48 Non-POD UK excl. NI	2CN	Next Day, Two-Day	90cm	17kg	`xpress_48_non_pod_uk_excl_ni`
Xpress Mini 48 Non-POD UK excl. NI	2CMN	Next Day, Two-Day	90cm	17kg	`xpress_mini_48_non_pod_uk_excl_ni`

Xpect 24 POD UK excl. NI	1VP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_24_pod_uk_excl_ni`
Xpect 24 Non-POD UK excl. NI	1VN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_24_non_pod_uk_excl_ni`
Xpect 48 POD UK excl. NI	2VP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_pod_uk_excl_ni`
Xpect 48 Non-POD UK excl. NI	2VN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_non_pod_uk_excl_ni`
Xpect 48 XL POD UK excl. NI	2VLP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_xl_pod_uk_excl_ni`
Xpect 48 XL Non-POD UK excl. NI	2VLN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_xl_non_pod_uk_excl_ni`
Xpect Saturday POD UK excl. NI	1VSP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_saturday_pod_uk_excl_ni`
Xpect Saturday Non-POD UK excl. NI	1VSN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_saturday_non_pod_uk_excl_ni`
Xpect Pre-12 POD UK excl. NI	12P	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_pre_12_pod_uk_excl_ni`

Xpert 24 POD Desk UK excl. NI	1VD	Next Day	120cm	30kg	`xpert_24_pod_desk_uk_excl_ni`
Xpert 24 Address Only UK excl. NI	1VA	Next Day	120cm	30kg	`xpert_24_address_only_uk_excl_ni`
Xpert 24 HVT POD UK excl. NI	1VT	Next Day	120cm	30kg	`xpert_24_hvt_pod_uk_excl_ni`
Xpert 24 BFPO POD UK excl. NI	1BFP	Next Day	120cm	30kg	`xpert_24_bfpo_pod_uk_excl_ni`
Xpert Saturday Address Only UK excl. NI	1VSA	Next Day	120cm	30kg	`xpert_saturday_address_only_uk_excl_ni`
Xpert Saturday HVT POD UK excl. NI	1VST	Next Day	120cm	30kg	`xpert_saturday_hvt_pod_uk_excl_ni`
Xpert Pre-12 Non-POD UK excl. NI	12N	Next Day	120cm	30kg	`xpert_pre_12_non_pod_uk_excl_ni`
Xpert Pre-12 Address Only UK excl. NI	12T	Next Day	120cm	30kg	`xpert_pre_12_hvt_address_only_uk_excl_ni`

Xpect Pre-12 Saturday POD UK excl. NI	12SP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_pre_12_saturday_pod_uk_excl_ni`

Xpert Pre-12 Saturday Non-POD UK excl. NI	12SN	Next Day	120cm	30kg	`xpert_pre_12_saturday_non_pod_uk_excl_ni`
Xpert Pre-12 Saturday Address Only UK excl. NI	12SA	Next Day	120cm	30kg	`xpert_pre_12_saturday_address_only_uk_excl_ni`
Xpert Pre-12 Saturday HVT Address Only UK excl. NI	12ST	Next Day	120cm	30kg	`xpert_pre_12_saturday_hvt_address_only_uk_excl_ni`
Xpert Catalogue Non-POD UK excl. NI	5CN	Next Day	120cm	30kg	`xpert_catalogue_non_pod_uk_excl_ni`

Xpect Mini 48 Non-POD UK excl. NI	2VSN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_mini_48_non_pod`
Xpect Mini 24 Non-POD	1SVN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_mini_24_non_pod`
Xpect Medium 24 POD UK excl. NI	1VMP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_medium_24_pod`
Xpect 24 Medium Non-POD UK excl. NI	1VMN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_24_medium_non_pod`
Xpect 48 Medium POD UK excl. NI	2VMP	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_medium_pod`
Xpect 48 Medium Non-POD UK excl. NI	2VMN	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_medium_non_pod`

Xpress 24 POD NI Only	1CPNI	Next Day, Two-Day	90cm	17kg	`xpress_24_pod_ni_only`
Xpress 24 Non-POD NI Only	1CNNI	Next Day, Two-Day	90cm	17kg	`xpress_24_non_pod_ni_only`
Xpress 48 POD NI Only	2CPNI	Next Day, Two-Day	90cm	17kg	`xpress_48_pod_ni_only`
Xpress 48 Non-POD NI Only	2CNNI	Next Day, Two-Day	90cm	17kg	`xpress_48_non_pod_ni_only`
Xpress Mini 48 Non-POD NI Only	2CMNNI	Next Day, Two-Day	90cm	17kg	`xpress_mini_48_non_pod_ni_only`

Xpect 24 POD NI Only	1VPNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_24_pod_ni_only`
Xpect 24 Non-POD NI Only	1VNNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_24_non_pod_ni_only`
Xpect 48 POD NI Only	2VPNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_pod_ni_only`
Xpect 48 Non-POD NI Only	2VNNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_non_pod_ni_only`
Xpect Mini 48 Non-POD NI Only	2VSNNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_mini_48_non_pod_ni_only`
Xpect 48 XL POD NI Only	2VLPNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_xl_pod_ni_only`
Xpect 48 XL Non-POD NI Only	2VLNNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_48_xl_non_pod_ni_only`
Xpect Saturday POD NI Only	1VSPNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_saturday_pod_ni_only`
Xpect Saturday Non-POD NI Only	1VSNNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_saturday_non_pod_ni_only`

Xpert 24 POD Desk NI Only	1VDNI	Next Day	120cm	30kg	`xpert_24_pod_desk_ni_only`
Xpert 24 Address Only NI Only	1VANI	Next Day	120cm	30kg	`xpert_24_address_only_ni_only`
Xpert 24 HVT POD NI Only	1VTNI	Next Day	120cm	30kg	`xpert_24_hvt_pod_ni_only`
Xpert Sat Address Only NI Only	1VSANI	Next Day	120cm	30kg	`xpert_sat_address_only_ni_only`
Xpert Saturday HVT POD NI Only	1VSTNI	Next Day	120cm	30kg	`xpert_saturday_hvt_pod_ni_only`
Xpert Pre-12 Non-POD NI Only	12NNI	Next Day	120cm	30kg	`xpert_pre_12_non_pod_ni_only`
Xpert Pre-12 HVT Address Only NI Only	12TNI	Next Day	120cm	30kg	`xpert_pre_12_hvt_address_only_ni_only`
Xpert Pre-12 Address Only NI Only	12ANI	Next Day	120cm	30kg	`xpert_pre_12_address_only_ni_only`

Xpect Pre-12 Saturday POD NI Only	12SPNI	Next Day, Two-Day	STD: 120cm XL: 170cm	30kg	`xpect_pre_12_saturday_pod_ni_only`

Xpert Pre-12 Saturday Non-POD NI Only	12SNNI	Next Day	120cm	30kg	`xpert_pre_12_saturday_non_pod_ni_only`
Xpert Pre-12 Saturday Address Only NI Only	12SANI	Next Day	120cm	30kg	`xpert_pre_12_saturday_address_only_ni_only`
Xpert Pre-12 Saturday HVT Address Only NI Only	12STNI	Next Day	120cm	30kg	`xpert_pre_12_saturday_hvt_address_only_ni_only`
Xpert Catalogue Non-POD NI Only	5CNNI	Next Day	120cm	30kg	`xpert_catalogue_non_pod_ni_only`

Yodel International Service Details

(Click to open)

NOTE: Not all services listed are available to every Yodel account. We recommend you check with Yodel so you know which services are available to your account, or use the List Services call.

Service	Carrier Code	Transit Time	Max Length	Max Weight	Service API Codes
Yodel 48 POD Channel Islands	48POD	1-5 days (Varies by location)	90cm	17kg	`yodel_48_pod_channel_islands`
Yodel 48 Non-POD Channel Islands	48NPOD	1-5 days	90cm	17kg	`yodel_48_non_pod_channel_islands`
Yodel 72 POD Channel Islands	72POD	1-5 days	90cm	17kg	`yodel_72_pod_channel_islands`
Yodel 72 Non-POD Channel Islands	72NPOD	1-5 days	90cm	17kg	`yodel_72_non_pod_channel_islands`
Yodel 48 POD International	EPL	1-5 days	90cm	17kg	`yodel_48_pod_international`
Yodel 48 Non-POD International	EPS	1-5 days	90cm	17kg	`yodel_48_non_pod_international`

Return Services

Return services not supported for this carrier.

Adding Shipment Insurance

Yodel supports adding shipment insurance.

Review the Parcel Insurance page for details on adding shipment insurance with ShipEngine.

You are now ready to create shipments using Yodel via ShipEngine!