Couriers Please
Couriers Please offers domestic and international services to accounts shipping from Australia.
This guide provides developers with the details needed to build Couriers Please shipping capabilities into your ShipStation API workflows.
If you are using or plan to use the Couriers Please services included with ShipStation API, rather than connecting your own Couriers Please account, see our Couriers Please from ShipStation guide.
Requirements
Property | Type | Required? | Description |
---|---|---|---|
nickname | string | required | Used to identify your account in ShipStation API |
account_number | string | required | Your Couriers Please account number |
api_secret | string | required | Your Couriers Please API secret |
add_ship_date_during_label_creation | boolean | Optional | Add shipment date during label creation |
skip_rating_during_label_creation | boolean | Optional | Skip rating during label creation |
Shipping Requirements
- Weight and dimensions are required for all shipments.
- Ship From address must hvae both a first and last name.
- Ship To email address is required for all shipments.
Connect Account
You can connect a Couriers Please account using the POST method to the /v1/connections/carriers/
endpoint, or via the ShipStation API Dashboard.
Connect via Endpoint
carrier_name
: couriers_please
POST /v1/connections/carriers/:carrier_name
Sample request:
A successful connection will return a response with the carrier_id
, which you'll use for any requests for this account going forward.
Connect via Dashboard
Steps to connect account via the dashboard coming soon.
Rates
Couriers Please supports rate shopping with ShipStation API.
Service Details
Available Couriers Please services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.
Domestic Services
Service | API Code |
---|---|
DSL - Domestic Priority - Signature Required | couriers_please_domestic_priority |
RSL - Domestic Off Peak - Signature Required | couriers_please_off_peak |
GEC - Gold Domestic - Signature Required | couriers_please_gold_domestic |
CouriersPlease Road Express | couriers_please_road_express |
CouriersPlease 500 Gram Satchel | couriers_please_500g_satchel |
X31 - 1KG Satchel | couriers_please_1kg_satchel |
X1A - 1KG Satchel - Authority To Leave | couriers_please_1kg_satchel_authority_to_leave |
X33 - 3KG Satchel | couriers_please_3kg_satchel |
X3A - 3KG Satchel - Authority To Leave | couriers_please_3kg_satchel_authority_to_leave |
X35 - 5KG Satchel | couriers_please_5kg_satchel |
X5A - 5KG Satchel - Authority To Leave | couriers_please_5kg_satchel_authority_to_leave |
P0 - 500Gram Parcel | couriers_please_500g_item |
P0A - 500Gram Parcel - Authority To Leave | couriers_please_500g_item_authority_to_leave |
P1 - 1KG Parcel | couriers_please_1kg_item |
P2 - 2KG Parcel | couriers_please_2kg |
P3 - 3KG Parcel | couriers_please_3kg_item |
P5 - 5KG Parcel | couriers_please_5kg_item |
P10 - 10KG Parcel | couriers_please_10kg_item |
P15 - 15KG Parcel | couriers_please_15kg_item |
CouriersPlease 20KG Parcel | couriers_please_20kg |
P25 - 25 KG Parcel | couriers_please_25kg |
DAL - Domestic Priority - Authority To Leave | couriers_please_domestic_priority_authority_to_leave |
RCL - Domestic Off Peak - Authority To Leave | couriers_please_off_peak_authority_to_leave |
DSM - Domestic Priority - Signature Required | domestic_priority_signature_required_dsm |
DSH - Domestic Priority - Signature Required | domestic_priority_signature_required_dsh |
DAM - Domestic Priority - Authority To Leave/POPPoints | domestic_priority_authority_to_leave_poppoints_dam |
DAH - Domestic Priority - Authority To Leave/POPPoints | domestic_priority_authority_to_leave_poppoints_dah |
RSM - Off Peak - Signature Required | off_peak_signature_required_rsm |
RSH - Off Peak - Signature Required | off_peak_signature_required_rsh |
RCM - Off Peak - Authority To Leave/POPPoints | off_peak_authority_to_leave_poppoints_rcm |
RCH - Off Peak - Authority To Leave/POPPoints | off_peak_authority_to_leave_poppoints_rch |
SGE - Gold Domestic - Signature Required | gold_domestic_signature_required_sge |
I77 - Road Express | road_express_i77 |
I66 - Road Express | road_express_i66 |
I55 - Road Express | road_express_i55 |
I50 - Road Express | road_express_i50 |
I44 - Road Express | road_express_i44 |
I33 - Road Express | road_express_i33 |
I22 - Road Express | road_express_i22 |
I11 - Road Express | road_express_i11 |
I10 - Road Express | road_express_i10 |
I05 - Road Express | road_express_i05 |
I00 - Road Express | road_express_i00 |
L77 - Road Express | road_express_l77 |
L66 - Road Express | road_express_l66 |
L55 - Road Express | road_express_l55 |
L50 - Road Express | road_express_l50 |
L44 - Road Express | road_express_l44 |
L33 - Road Express | road_express_l33 |
L22 - Road Express | road_express_l22 |
L11 - Road Express | road_express_l11 |
L10 - Road Express | road_express_l10 |
L05 - Road Express | road_express_l05 |
L00 - Road Express | road_express_l00 |
L7719 - Road Express | road_express_l7719 |
L6619 - Road Express | road_express_l6619 |
L5519 - Road Express | road_express_l5519 |
L5019 - Road Express | road_express_l5019 |
L4419 - Road Express | road_express_l4419 |
L3319 - Road Express | road_express_l3319 |
L2219 - Road Express | road_express_l2219 |
L1119 - Road Express | road_express_l1119 |
L1019 - Road Express | road_express_l1019 |
L0519 - Road Express | road_express_l0519 |
L0019 - Road Express | road_express_l0019 |
NDL - Road Express No Delivery | road_express_no_delivery_ndl |
NPU - Road Express No Pick Up | road_express_no_pick_up_npu |
49L - Road Express | road_express_49l |
Y35 - 5Kg Satchel | 5kg_satchel_y35 |
Y5A - 5Kg Satchel ATL | 5kg_satchel_atl_y5a |
Y33 - 3Kg Satchel | 3kg_satchel_y33 |
Y3A - 3Kg Satchel ATL | 3kg_satchel_atl_y3a |
Y31 - 1Kg Satchel | 1kg_satchel_y31 |
Y1A - 1Kg Satchel ATL | 1kg_satchel_atl_y1a |
Y30 - 500Gram Satchel | 500gram_satchel_y30 |
Y0A - 500Gram Satchel ATL | 500gram_satchel_atl_y0a` |
Y3519 - 5Kg Satchel | 5kg_satchel_y3519 |
Y5A19 - 5Kg Satchel ATL | 5kg_satchel_atl_y5a19 |
Y3319 - 3Kg Satchel | 3kg_satchel_y3319 |
Y3A19 - 3Kg Satchel ATL | 3kg_satchel_atl_y3a19 |
Y3119 - 1Kg Satchel | 1kg_satchel_y3119 |
Y1A19 - 1Kg Satchel ATL | 1kg_satchel_atl_y1a19 |
Y3019 - 500Gram Satchel | 500gram_satchel_y3019 |
Y0A19 - 500Gram Satchel ATL | 500gram_satchel_atl_y0a19 |
P5A - 5Kg Parcel ATL | 5kg_parcel_atl_p5a |
P3A - 3Kg Parcel ATL | 3kg_parcel_atl_p3a |
P2A - 2Kg Parcel ATL | 2kg_parcel_atl_p2a |
P1A - 1Kg Parcel ATL | 1kg_parcel_atl_p1a |
PX519 - 5Kg Parcel | 5kg_parcel_px519 |
PX319 - 3Kg Parcel | 3kg_parcel_px319 |
PX119 - 1Kg Parcel | 1kg_parcel_px119 |
PX019 - 500Gram Parcel | 500gram_parcel_px019 |
PX5 - 5Kg Parcel | 5kg_parcel_px5 |
PX3 - 3Kg Parcel | 3kg_parcel_px3 |
PX1 - 1Kg Parcel | 1kg_parcel_px1 |
PX0 - 500Gram Parcel | 500gram_parcel_px0 |
PC25 - 25Kg Parcel | 25kg_parcel_pc25 |
PC15 - 15Kg Parcel | 15kg_parcel_pc15 |
PC10 - 10Kg Parcel | 10kg_parcel_pc10 |
PC5 - 5Kg Parcel | 5kg_parcel_pc5 |
PC3 - 3Kg Parcel | 3kg_parcel_pc3 |
PC2 - 2Kg Parcel | 2kg_parcel_pc2 |
PC1 - 1Kg Parcel | 1kg_parcel_pc1 |
PC0 - 500Gram Parcel | 500gram_parcel_pc0 |
WP5 - 5Kg Parcel | 5kg_parcel_wp5 |
WP3 - 3Kg Parcel | 3kg_parcel_wp3 |
WP1 - 1Kg Parcel | 1kg_parcel_wp1 |
WP0 - 500Gram Parcel | 500gram_parcel_wp0 |
PP10 - 10Kg Parcel | 10kg_parcel_pp10 |
PP5 - 5Kg Parcel | 5kg_parcel_pp5 |
PP3 - 3Kg Parcel | 3kg_parcel_pp3 |
PP1 - 1Kg Parcel | 1kg_parcel_pp1 |
PP0 - 500Gram Parcel | 500gram_parcel_pp0 |
D5 - 5Kg Parcel | 5kg_parcel_d5 |
D3 - 3Kg Parcel | 3kg_parcel_d3 |
D1 - 1Kg Parcel | 1kg_parcel_d1 |
D0 - 500Gram Parcel | 500gram_parcel_d0 |
DS10 - 10Kg Parcel | 10kg_parcel_ds10 |
DS20 - 20Kg Parcel | 20kg_parcel_ds20 |
AEP10 - AGG EXP ATL P10 | agg_exp_atl_p10_aep10 |
AEP25 - AGG EXP ATL P25 | agg_exp_atl_p25_aep25 |
AGEBK - AGG EXP ATL Base & Kilo | agg_exp_atl_base_kilo_agebk |
AGEP0 - AGG EXP ATL P0 | agg_exp_atl_p0_agep0 |
AGEP1 - AGG EXP ATL P1 | agg_exp_atl_p1_agep1 |
AGEP3 - AGG EXP ATL P3 | agg_exp_atl_p3_agep3 |
AGEP5 - AGG EXP ATL P5 | agg_exp_atl_p5_agep5 |
AGHBK - AGG DROP OFF HUBBED Base&Kilo | agg_drop_off_hubbed_base_kilo_aghbk |
AGHP0 - AGG DROP OFF HUBBED P0 | agg_drop_off_hubbed_p0_aghp0 |
AGHP1 - AGG DROP OFF HUBBED P1 | agg_drop_off_hubbed_p1_aghp1 |
AGHP3 - AGG DROP OFF HUBBED P3 | agg_drop_off_hubbed_p3_aghp3 |
AGHP5 - AGG DROP OFF HUBBED P5 | agg_drop_off_hubbed_p5_aghp5 |
AGP10 - AGG STD ATL P10 | agg_std_atl_p10_agp10 |
AGSBK - AGG STD ATL Base & Kilo | agg_std_atl_base_kilo_agsbk |
AGSP0 - AGG STD ATL P0 | agg_std_atl_p0_agsp0 |
AGSP1 - AGG STD ATL P1 | agg_std_atl_p1_agsp1 |
AGSP3 - AGG STD ATL P3 | agg_std_atl_p3_agsp3 |
AGSP5 - AGG STD ATL P5 | agg_std_atl_p5_agsp5 |
AGVBK - AGG ECom Base & Kilo | agg_ecom_base_kilo_agvbk |
AGVP0 - AGG ECom P0 | agg_ecom_p0_agvp0 |
AGVP1 - AGG ECom P1 | agg_ecom_p1_agvp1 |
AGVP3 - AGG ECom P3 | agg_ecom_p3_agvp3 |
AGVP5 - AGG ECom P5 | agg_ecom_p5_agvp5 |
AHP10 - AGG DROP OFF HUBBED P10 | agg_drop_off_hubbed_p10_ahp10 |
AHP25 - AGG DROP OFF HUBBED P25 | agg_drop_off_hubbed_p25_ahp25 |
ASP25 - AGG STD ATL P25 | agg_std_atl_p25_asp25 |
AVP10 - AGG ECom P10 | agg_ecom_p10_avp10 |
AVP25 - AGG ECom P25 | agg_ecom_p25_avp25 |
PS5 - 5Kg Parcel | 5kg_parcel_ps5 |
PS3 - 3Kg Parcel | 3kg_parcel_ps3 |
PS1 - 1Kg Parcel | 1kg_parcel_ps1 |
PS0 - 500Gram Parcel | 500gram_parcel_ps0 |
L7720 - Road Express | road_express_l7720 |
L6620 - Road Express | road_express_l6620 |
L5520 - Road Express | road_express_l5520 |
L5020 - Road Express | road_express_l5020 |
L4420 - Road Express | road_express_l4420 |
L3320 - Road Express | road_express_l3320 |
L2220 - Road Express | road_express_l2220 |
L1120 - Road Express | road_express_l1120 |
L1020 - Road Express | road_express_l1020 |
L0520 - Road Express | road_express_l0520 |
L0020 - Road Express | road_express_l0020 |
Y3020 - 500Gram Satchel | 500gram_satchel_y3020 |
Y3120 - 1KG Satchel | 1kg_satchel_y3120 |
Y3320 - 3KG Satchel | 3kg_satchel_y3320 |
Y3520 - 5KG Satchel | 5kg_satchel_y3520 |
PX020 - 500Gram Parcel | 500gram_parcel_px020 |
PX120 - 1Kg Parcel | 1kg_parcel_px120 |
PX320 - 3Kg Parcel | 3kg_parcel_px320 |
PX520 - 5Kg Parcel | 5kg_parcel_px520 |
TS0 - 500Gram Parcel | 500gram_parcel_ts0 |
TS1 - 1Kg Parcel | 1kg_parcel_ts1 |
TS3 - 3Kg Parcel | 3kg_parcel_ts3 |
TS5 - 5Kg Parcel | 5kg_parcel_ts5 |
TSKG - Road Express | road_express_tskg |
TA0 - 500Gram Parcel | 500gram_parcel_ta0 |
TA1 - 1Kg Parcel | 1kg_parcel_ta1 |
TA3 - 3Kg Parcel | 3kg_parcel_ta3 |
TA5 - 5Kg Parcel | 5kg_parcel_ta5 |
TAKG - Road Express | road_express_takg |
TB0 - 500Gram Parcel | 500gram_parcel_tb0 |
TB1 - 1Kg Parcel | 1kg_parcel_tb1 |
TB3 - 3Kg Parcel | 3kg_parcel_tb3 |
TB5 - 5Kg Parcel | 5kg_parcel_tb5 |
TBKG - Road Express | road_express_tbkg |
TC0 - 500Gram Parcel | 500gram_parcel_tc0 |
TC1 - 1Kg Parcel | 1kg_parcel_tc1 |
TC3 - 3Kg Parcel | 3kg_parcel_tc3 |
TC5 - 5Kg Parcel | 5kg_parcel_tc5 |
TCKG - Road Express | road_express_tckg |
TD0 - 500Gram Parcel | 500gram_parcel_td0 |
TD1 - 1Kg Parcel | 1kg_parcel_td1 |
TD3 - 3Kg Parcel | 3kg_parcel_td3 |
TD5 - 5Kg Parcel | 5kg_parcel_td5 |
TDKG - Road Express | road_express_tdkg |
SNP1 - 1Kg Parcel Sendle | couriers_please_1kg_parcel_sendle_snp1 |
SNP0 - 500 Gram Parcel Sendle | couriers_please_500gram_parcel_sendle_snp0 |
S250G - 250 Gram Parcel Sendle | couriers_please_250gram_parcel_sendle_s250g |
BU0 - 500Gram Parcel | couriers_please_500gram_parcel_bu0 |
BU1 - 1Kg Parcel | couriers_please_1kg_parcel_bu1 |
BU10 - 10Kg Parcel | couriers_please_10kg_parcel_bu10 |
BU15 - 15Kg Parcel | couriers_please_15kg_parcel_bu15 |
BU20 - 20Kg Parcel | couriers_please_20kg_parcel_bu20 |
BU25 - 25Kg Parcel | couriers_please_25kg_parcel_bu25 |
BU3 - 3Kg Parcel | couriers_please_3kg_parcel_bu3 |
BU5 - 5Kg Parcel | couriers_please_5kg_parcel_bu5 |
DS1 - 1Kg Parcel | couriers_please_1kg_parcel_ds1 |
DS15 - 15Kg Parcel | couriers_please_15kg_parcel_ds15 |
DS25 - 25Kg Parcel | couriers_please_25kg_parcel_ds25 |
DS3 - 3Kg Parcel | couriers_please_3kg_parcel_ds3 |
DS5 - 5Kg Parcel | couriers_please_5kg_parcel_ds5 |
P10A - 10Kg Parcel ATL | couriers_please_10kg_parcel_atl_p10a |
P15A - 15Kg Parcel ATL | couriers_please_15kg_parcel_atl_p15a |
SNBK - Road Express Bulk Pick Up | couriers_please_road_express_bulk_pick_up_snbk |
SNP10 - 10Kg Parcel | couriers_please_10kg_parcel_snp10 |
SNP15 - 15Kg Parcel | couriers_please_15kg_parcel_snp15 |
SNP2 - 2Kg Parcel | couriers_please_2kg_parcel_snp2 |
SNP25 - 25Kg Parcel | couriers_please_25kg_parcel_snp25 |
SNP3 - 3Kg Parcel | couriers_please_3kg_parcel_snp3 |
SNP5 - 5Kg Parcel | couriers_please_5kg_parcel_snp5 |
TAO - 500Gram Parcel | couriers_please_500gram_parcel_tao |
TBO - 500Gram Parcel | couriers_please_500gram_parcel_tbo |
TCO - 500Gram Parcel | couriers_please_500gram_parcel_tco |
TDO - 500Gram Parcel | couriers_please_500gram_parcel_tdo |
TSO - 500Gram Parcel | couriers_please_500gram_parcel_tso |
TZ1 - 1Kg Parcel | couriers_please_1kg_parcel_tz1 |
TZ3 - 3Kg Parcel | couriers_please_3kg_parcel_tz3 |
TZ5 - 5Kg Parcel | couriers_please_5kg_parcel_tz5 |
TZKG - Road Express | couriers_please_road_express_tzkg |
TZO - 500Gram Parcel | couriers_please_500gram_parcel_tzo |
DS0 - 500Gram Parcel | couriers_please_500gram_parcel_ds0 |
PWF0 - 500g Parcel | couriers_please_500gm_pwf0 |
PWF1 - 1kg Parcel | couriers_please_1kg_pwf1 |
PWF3 - 3kg Parcel | couriers_please_3kg_pwf3 |
PWF5 - 5kg Parcel | couriers_please_5kg_pwf5 |
TS250 - 250Gram Parcel | couriers_please_250gm_ts250 |
TA250 - 250Gram Parcel | couriers_please_250gm_ta250 |
TB250 - 250Gram Parcel | couriers_please_250gm_tb250 |
TC250 - 250Gram Parcel | couriers_please_250gm_tc250 |
TD250 - 250Gram Parcel | couriers_please_250gm_td250 |
TE250 - Single Item up to 250 Grams | couriers_please_250gm_te250 |
TE0 - Single Item up to 500 Grams | couriers_please_500gm_te0 |
TE1 - Single item up to 1Kg | couriers_please_1kg_te1 |
TE3 - Single item up to 3Kg | couriers_please_3kg_te3 |
TE5 - Single item up to 5Kg | couriers_please_5kg_te5 |
TEKG - Single Item over 5Kg | couriers_please_over_5kg_tekg |
TZ250 - 250Gram Parcel | couriers_please_250gm_tz250 |
TZ0 - 500Gram Parcel | couriers_please_500gm_tz0 |
XP0A - Single Item up to 500 Grams | couriers_please_500gm_xp0a |
XP1A - Single item up to 1Kg | couriers_please_1kg_xp1a |
XP3A - Single item up to 3Kg | couriers_please_3kg_xp3a |
XP5A - Single item up to 5Kg | couriers_please_5kg_xp5a |
International Services
Service | API Code |
---|---|
SAVW - International Saver | couriers_please_international_saver |
EXPW - International Express | couriers_please_international_express |
EXPI - International Express Import | couriers_please_international_express_import |
EXPD - International Express (D) | international_express_d_expd |
Return Services
Couriers Please supports the following services for return labels:
Service | API Code |
---|---|
49 - Road Express - Returns | couriers_please_returns |
RDPE5 - Returns Pickup | couriers_please_returns_pickup |
RDOE5 - Returns Drop Off | couriers_please_returns_drop_off |
Review the Return Shipping Labels page for details on creating return labels with ShipStation API.
Packages
Couriers Please does not currently include specific carrier package types. You can use the generic package
type or custom package types.
Adding Shipment Insurance
Couriers Please supports adding carrier insurance to shipments created with ShipStation API. Review our insurance page for details on adding insurance to your shipments.
Label Support
- Label sizes: 4" x 6"
- Label formats: PDF
- Supports unicode characters: unknown
Label Reference Fields
Couriers Please supports adding custom label messages.
- Label message 1 only
Multi-Package Labels
Couriers Please supports creating multi-package shipments for certain services.
CouriersPlease has three rate types:
- Item (single package only)
- Kilo (single or multipackage)
- Base (single or multipackage)
If a service is listed as an “Item rate,” it is a single package only. Everything else can be multi-package.
See our Multi-Package Shipping page for details about creating multi-package labels.
Label Branding
Couriers Please does not support label branding.
Voiding Labels
Couriers Please supports voiding labels with ShipStation API.
See our Void a Label page for details about voiding labels with ShipStation API.
Paperless Labels
Couriers Please does not support paperless labels.
Customs Declarations
You can download customs declarations from the forms_download
object in the label response. You must print and include with the international shipments. No electronic submission is available.
Delivery Confirmation
Confirmation Type | API Code | Description |
---|---|---|
Authority to leave | none | No confirmation requested. |
No authority to leave | signature | Signature is required for the shipment to be delivered. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present). |
See our Delivery Confirmation page for more details about using the confirmation
property.
Advanced Options
Couriers Please supports certain advanced options, which you can add to the shipment
object when creating a shipment or label.
Option | Type | Default Value | Description |
---|---|---|---|
dangerous_goods | boolean | false | Indicates if dangerous goods are present in the shipment. |
To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.
Dangerous Goods
Use the dangerous_goods
property in the advanced_options
object to mark the shipment as containing dangerous goods. No additional properties are required by the carrier at this time.
See our Dangerous Goods page for more details about shipping dangerous goods with ShipStation API.
Manifests
Couriers Please does not require manifesting your shipments.
Scheduling Pickups
Couriers Please does not support scheduling pickups using ShipStation API.
Service Points (PUDO)
Couriers Please drop off services support dropping off at a service point.
See our Intro to Service Points for more details about how to use service points with ShipStation API.
Tracking
Couriers Please supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation API.
Disconnecting Your Couriers Please Account
See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation API.