Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

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

PropertyTypeRequired?Description
nicknamestringrequiredUsed to identify your account in ShipStation API
account_numberstringrequiredYour Couriers Please account number
api_secretstringrequiredYour Couriers Please API secret
add_ship_date_during_label_creationbooleanOptionalAdd shipment date during label creation
skip_rating_during_label_creationbooleanOptionalSkip 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:

1
2
3
4
5
6
7
8
9
10
POST /v1/connections/carriers/couriers_please HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "My Couriers Please account",
"account_number": "123456789",
"api_secret": "mycouriersplease-api-secret"
}

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

ServiceAPI Code
DSL - Domestic Priority - Signature Requiredcouriers_please_domestic_priority
RSL - Domestic Off Peak - Signature Requiredcouriers_please_off_peak
GEC - Gold Domestic - Signature Requiredcouriers_please_gold_domestic
CouriersPlease Road Expresscouriers_please_road_express
CouriersPlease 500 Gram Satchelcouriers_please_500g_satchel
X31 - 1KG Satchelcouriers_please_1kg_satchel
X1A - 1KG Satchel - Authority To Leavecouriers_please_1kg_satchel_authority_to_leave
X33 - 3KG Satchelcouriers_please_3kg_satchel
X3A - 3KG Satchel - Authority To Leavecouriers_please_3kg_satchel_authority_to_leave
X35 - 5KG Satchelcouriers_please_5kg_satchel
X5A - 5KG Satchel - Authority To Leavecouriers_please_5kg_satchel_authority_to_leave
P0 - 500Gram Parcelcouriers_please_500g_item
P0A - 500Gram Parcel - Authority To Leavecouriers_please_500g_item_authority_to_leave
P1 - 1KG Parcelcouriers_please_1kg_item
P2 - 2KG Parcelcouriers_please_2kg
P3 - 3KG Parcelcouriers_please_3kg_item
P5 - 5KG Parcelcouriers_please_5kg_item
P10 - 10KG Parcelcouriers_please_10kg_item
P15 - 15KG Parcelcouriers_please_15kg_item
CouriersPlease 20KG Parcelcouriers_please_20kg
P25 - 25 KG Parcelcouriers_please_25kg
DAL - Domestic Priority - Authority To Leavecouriers_please_domestic_priority_authority_to_leave
RCL - Domestic Off Peak - Authority To Leavecouriers_please_off_peak_authority_to_leave
DSM - Domestic Priority - Signature Requireddomestic_priority_signature_required_dsm
DSH - Domestic Priority - Signature Requireddomestic_priority_signature_required_dsh
DAM - Domestic Priority - Authority To Leave/POPPointsdomestic_priority_authority_to_leave_poppoints_dam
DAH - Domestic Priority - Authority To Leave/POPPointsdomestic_priority_authority_to_leave_poppoints_dah
RSM - Off Peak - Signature Requiredoff_peak_signature_required_rsm
RSH - Off Peak - Signature Requiredoff_peak_signature_required_rsh
RCM - Off Peak - Authority To Leave/POPPointsoff_peak_authority_to_leave_poppoints_rcm
RCH - Off Peak - Authority To Leave/POPPointsoff_peak_authority_to_leave_poppoints_rch
SGE - Gold Domestic - Signature Requiredgold_domestic_signature_required_sge
I77 - Road Expressroad_express_i77
I66 - Road Expressroad_express_i66
I55 - Road Expressroad_express_i55
I50 - Road Expressroad_express_i50
I44 - Road Expressroad_express_i44
I33 - Road Expressroad_express_i33
I22 - Road Expressroad_express_i22
I11 - Road Expressroad_express_i11
I10 - Road Expressroad_express_i10
I05 - Road Expressroad_express_i05
I00 - Road Expressroad_express_i00
L77 - Road Expressroad_express_l77
L66 - Road Expressroad_express_l66
L55 - Road Expressroad_express_l55
L50 - Road Expressroad_express_l50
L44 - Road Expressroad_express_l44
L33 - Road Expressroad_express_l33
L22 - Road Expressroad_express_l22
L11 - Road Expressroad_express_l11
L10 - Road Expressroad_express_l10
L05 - Road Expressroad_express_l05
L00 - Road Expressroad_express_l00
L7719 - Road Expressroad_express_l7719
L6619 - Road Expressroad_express_l6619
L5519 - Road Expressroad_express_l5519
L5019 - Road Expressroad_express_l5019
L4419 - Road Expressroad_express_l4419
L3319 - Road Expressroad_express_l3319
L2219 - Road Expressroad_express_l2219
L1119 - Road Expressroad_express_l1119
L1019 - Road Expressroad_express_l1019
L0519 - Road Expressroad_express_l0519
L0019 - Road Expressroad_express_l0019
NDL - Road Express No Deliveryroad_express_no_delivery_ndl
NPU - Road Express No Pick Uproad_express_no_pick_up_npu
49L - Road Expressroad_express_49l
Y35 - 5Kg Satchel5kg_satchel_y35
Y5A - 5Kg Satchel ATL5kg_satchel_atl_y5a
Y33 - 3Kg Satchel3kg_satchel_y33
Y3A - 3Kg Satchel ATL3kg_satchel_atl_y3a
Y31 - 1Kg Satchel1kg_satchel_y31
Y1A - 1Kg Satchel ATL1kg_satchel_atl_y1a
Y30 - 500Gram Satchel500gram_satchel_y30
Y0A - 500Gram Satchel ATL500gram_satchel_atl_y0a`
Y3519 - 5Kg Satchel5kg_satchel_y3519
Y5A19 - 5Kg Satchel ATL5kg_satchel_atl_y5a19
Y3319 - 3Kg Satchel3kg_satchel_y3319
Y3A19 - 3Kg Satchel ATL3kg_satchel_atl_y3a19
Y3119 - 1Kg Satchel1kg_satchel_y3119
Y1A19 - 1Kg Satchel ATL1kg_satchel_atl_y1a19
Y3019 - 500Gram Satchel500gram_satchel_y3019
Y0A19 - 500Gram Satchel ATL500gram_satchel_atl_y0a19
P5A - 5Kg Parcel ATL5kg_parcel_atl_p5a
P3A - 3Kg Parcel ATL3kg_parcel_atl_p3a
P2A - 2Kg Parcel ATL2kg_parcel_atl_p2a
P1A - 1Kg Parcel ATL1kg_parcel_atl_p1a
PX519 - 5Kg Parcel5kg_parcel_px519
PX319 - 3Kg Parcel3kg_parcel_px319
PX119 - 1Kg Parcel1kg_parcel_px119
PX019 - 500Gram Parcel500gram_parcel_px019
PX5 - 5Kg Parcel5kg_parcel_px5
PX3 - 3Kg Parcel3kg_parcel_px3
PX1 - 1Kg Parcel1kg_parcel_px1
PX0 - 500Gram Parcel500gram_parcel_px0
PC25 - 25Kg Parcel25kg_parcel_pc25
PC15 - 15Kg Parcel15kg_parcel_pc15
PC10 - 10Kg Parcel10kg_parcel_pc10
PC5 - 5Kg Parcel5kg_parcel_pc5
PC3 - 3Kg Parcel3kg_parcel_pc3
PC2 - 2Kg Parcel2kg_parcel_pc2
PC1 - 1Kg Parcel1kg_parcel_pc1
PC0 - 500Gram Parcel500gram_parcel_pc0
WP5 - 5Kg Parcel5kg_parcel_wp5
WP3 - 3Kg Parcel3kg_parcel_wp3
WP1 - 1Kg Parcel1kg_parcel_wp1
WP0 - 500Gram Parcel500gram_parcel_wp0
PP10 - 10Kg Parcel10kg_parcel_pp10
PP5 - 5Kg Parcel5kg_parcel_pp5
PP3 - 3Kg Parcel3kg_parcel_pp3
PP1 - 1Kg Parcel1kg_parcel_pp1
PP0 - 500Gram Parcel500gram_parcel_pp0
D5 - 5Kg Parcel5kg_parcel_d5
D3 - 3Kg Parcel3kg_parcel_d3
D1 - 1Kg Parcel1kg_parcel_d1
D0 - 500Gram Parcel500gram_parcel_d0
DS10 - 10Kg Parcel10kg_parcel_ds10
DS20 - 20Kg Parcel20kg_parcel_ds20
AEP10 - AGG EXP ATL P10agg_exp_atl_p10_aep10
AEP25 - AGG EXP ATL P25agg_exp_atl_p25_aep25
AGEBK - AGG EXP ATL Base & Kiloagg_exp_atl_base_kilo_agebk
AGEP0 - AGG EXP ATL P0agg_exp_atl_p0_agep0
AGEP1 - AGG EXP ATL P1agg_exp_atl_p1_agep1
AGEP3 - AGG EXP ATL P3agg_exp_atl_p3_agep3
AGEP5 - AGG EXP ATL P5agg_exp_atl_p5_agep5
AGHBK - AGG DROP OFF HUBBED Base&Kiloagg_drop_off_hubbed_base_kilo_aghbk
AGHP0 - AGG DROP OFF HUBBED P0agg_drop_off_hubbed_p0_aghp0
AGHP1 - AGG DROP OFF HUBBED P1agg_drop_off_hubbed_p1_aghp1
AGHP3 - AGG DROP OFF HUBBED P3agg_drop_off_hubbed_p3_aghp3
AGHP5 - AGG DROP OFF HUBBED P5agg_drop_off_hubbed_p5_aghp5
AGP10 - AGG STD ATL P10agg_std_atl_p10_agp10
AGSBK - AGG STD ATL Base & Kiloagg_std_atl_base_kilo_agsbk
AGSP0 - AGG STD ATL P0agg_std_atl_p0_agsp0
AGSP1 - AGG STD ATL P1agg_std_atl_p1_agsp1
AGSP3 - AGG STD ATL P3agg_std_atl_p3_agsp3
AGSP5 - AGG STD ATL P5agg_std_atl_p5_agsp5
AGVBK - AGG ECom Base & Kiloagg_ecom_base_kilo_agvbk
AGVP0 - AGG ECom P0agg_ecom_p0_agvp0
AGVP1 - AGG ECom P1agg_ecom_p1_agvp1
AGVP3 - AGG ECom P3agg_ecom_p3_agvp3
AGVP5 - AGG ECom P5agg_ecom_p5_agvp5
AHP10 - AGG DROP OFF HUBBED P10agg_drop_off_hubbed_p10_ahp10
AHP25 - AGG DROP OFF HUBBED P25agg_drop_off_hubbed_p25_ahp25
ASP25 - AGG STD ATL P25agg_std_atl_p25_asp25
AVP10 - AGG ECom P10agg_ecom_p10_avp10
AVP25 - AGG ECom P25agg_ecom_p25_avp25
PS5 - 5Kg Parcel5kg_parcel_ps5
PS3 - 3Kg Parcel3kg_parcel_ps3
PS1 - 1Kg Parcel1kg_parcel_ps1
PS0 - 500Gram Parcel500gram_parcel_ps0
L7720 - Road Expressroad_express_l7720
L6620 - Road Expressroad_express_l6620
L5520 - Road Expressroad_express_l5520
L5020 - Road Expressroad_express_l5020
L4420 - Road Expressroad_express_l4420
L3320 - Road Expressroad_express_l3320
L2220 - Road Expressroad_express_l2220
L1120 - Road Expressroad_express_l1120
L1020 - Road Expressroad_express_l1020
L0520 - Road Expressroad_express_l0520
L0020 - Road Expressroad_express_l0020
Y3020 - 500Gram Satchel500gram_satchel_y3020
Y3120 - 1KG Satchel1kg_satchel_y3120
Y3320 - 3KG Satchel3kg_satchel_y3320
Y3520 - 5KG Satchel5kg_satchel_y3520
PX020 - 500Gram Parcel500gram_parcel_px020
PX120 - 1Kg Parcel1kg_parcel_px120
PX320 - 3Kg Parcel3kg_parcel_px320
PX520 - 5Kg Parcel5kg_parcel_px520
TS0 - 500Gram Parcel500gram_parcel_ts0
TS1 - 1Kg Parcel1kg_parcel_ts1
TS3 - 3Kg Parcel3kg_parcel_ts3
TS5 - 5Kg Parcel5kg_parcel_ts5
TSKG - Road Expressroad_express_tskg
TA0 - 500Gram Parcel500gram_parcel_ta0
TA1 - 1Kg Parcel1kg_parcel_ta1
TA3 - 3Kg Parcel3kg_parcel_ta3
TA5 - 5Kg Parcel5kg_parcel_ta5
TAKG - Road Expressroad_express_takg
TB0 - 500Gram Parcel500gram_parcel_tb0
TB1 - 1Kg Parcel1kg_parcel_tb1
TB3 - 3Kg Parcel3kg_parcel_tb3
TB5 - 5Kg Parcel5kg_parcel_tb5
TBKG - Road Expressroad_express_tbkg
TC0 - 500Gram Parcel500gram_parcel_tc0
TC1 - 1Kg Parcel1kg_parcel_tc1
TC3 - 3Kg Parcel3kg_parcel_tc3
TC5 - 5Kg Parcel5kg_parcel_tc5
TCKG - Road Expressroad_express_tckg
TD0 - 500Gram Parcel500gram_parcel_td0
TD1 - 1Kg Parcel1kg_parcel_td1
TD3 - 3Kg Parcel3kg_parcel_td3
TD5 - 5Kg Parcel5kg_parcel_td5
TDKG - Road Expressroad_express_tdkg
SNP1 - 1Kg Parcel Sendlecouriers_please_1kg_parcel_sendle_snp1
SNP0 - 500 Gram Parcel Sendlecouriers_please_500gram_parcel_sendle_snp0
S250G - 250 Gram Parcel Sendlecouriers_please_250gram_parcel_sendle_s250g
BU0 - 500Gram Parcelcouriers_please_500gram_parcel_bu0
BU1 - 1Kg Parcelcouriers_please_1kg_parcel_bu1
BU10 - 10Kg Parcelcouriers_please_10kg_parcel_bu10
BU15 - 15Kg Parcelcouriers_please_15kg_parcel_bu15
BU20 - 20Kg Parcelcouriers_please_20kg_parcel_bu20
BU25 - 25Kg Parcelcouriers_please_25kg_parcel_bu25
BU3 - 3Kg Parcelcouriers_please_3kg_parcel_bu3
BU5 - 5Kg Parcelcouriers_please_5kg_parcel_bu5
DS1 - 1Kg Parcelcouriers_please_1kg_parcel_ds1
DS15 - 15Kg Parcelcouriers_please_15kg_parcel_ds15
DS25 - 25Kg Parcelcouriers_please_25kg_parcel_ds25
DS3 - 3Kg Parcelcouriers_please_3kg_parcel_ds3
DS5 - 5Kg Parcelcouriers_please_5kg_parcel_ds5
P10A - 10Kg Parcel ATLcouriers_please_10kg_parcel_atl_p10a
P15A - 15Kg Parcel ATLcouriers_please_15kg_parcel_atl_p15a
SNBK - Road Express Bulk Pick Upcouriers_please_road_express_bulk_pick_up_snbk
SNP10 - 10Kg Parcelcouriers_please_10kg_parcel_snp10
SNP15 - 15Kg Parcelcouriers_please_15kg_parcel_snp15
SNP2 - 2Kg Parcelcouriers_please_2kg_parcel_snp2
SNP25 - 25Kg Parcelcouriers_please_25kg_parcel_snp25
SNP3 - 3Kg Parcelcouriers_please_3kg_parcel_snp3
SNP5 - 5Kg Parcelcouriers_please_5kg_parcel_snp5
TAO - 500Gram Parcelcouriers_please_500gram_parcel_tao
TBO - 500Gram Parcelcouriers_please_500gram_parcel_tbo
TCO - 500Gram Parcelcouriers_please_500gram_parcel_tco
TDO - 500Gram Parcelcouriers_please_500gram_parcel_tdo
TSO - 500Gram Parcelcouriers_please_500gram_parcel_tso
TZ1 - 1Kg Parcelcouriers_please_1kg_parcel_tz1
TZ3 - 3Kg Parcelcouriers_please_3kg_parcel_tz3
TZ5 - 5Kg Parcelcouriers_please_5kg_parcel_tz5
TZKG - Road Expresscouriers_please_road_express_tzkg
TZO - 500Gram Parcelcouriers_please_500gram_parcel_tzo
DS0 - 500Gram Parcelcouriers_please_500gram_parcel_ds0
PWF0 - 500g Parcelcouriers_please_500gm_pwf0
PWF1 - 1kg Parcelcouriers_please_1kg_pwf1
PWF3 - 3kg Parcelcouriers_please_3kg_pwf3
PWF5 - 5kg Parcelcouriers_please_5kg_pwf5
TS250 - 250Gram Parcelcouriers_please_250gm_ts250
TA250 - 250Gram Parcelcouriers_please_250gm_ta250
TB250 - 250Gram Parcelcouriers_please_250gm_tb250
TC250 - 250Gram Parcelcouriers_please_250gm_tc250
TD250 - 250Gram Parcelcouriers_please_250gm_td250
TE250 - Single Item up to 250 Gramscouriers_please_250gm_te250
TE0 - Single Item up to 500 Gramscouriers_please_500gm_te0
TE1 - Single item up to 1Kgcouriers_please_1kg_te1
TE3 - Single item up to 3Kgcouriers_please_3kg_te3
TE5 - Single item up to 5Kgcouriers_please_5kg_te5
TEKG - Single Item over 5Kgcouriers_please_over_5kg_tekg
TZ250 - 250Gram Parcelcouriers_please_250gm_tz250
TZ0 - 500Gram Parcelcouriers_please_500gm_tz0
XP0A - Single Item up to 500 Gramscouriers_please_500gm_xp0a
XP1A - Single item up to 1Kgcouriers_please_1kg_xp1a
XP3A - Single item up to 3Kgcouriers_please_3kg_xp3a
XP5A - Single item up to 5Kgcouriers_please_5kg_xp5a

International Services

ServiceAPI Code
SAVW - International Savercouriers_please_international_saver
EXPW - International Expresscouriers_please_international_express
EXPI - International Express Importcouriers_please_international_express_import
EXPD - International Express (D)international_express_d_expd

Return Services

Couriers Please supports the following services for return labels:

ServiceAPI Code
49 - Road Express - Returnscouriers_please_returns
RDPE5 - Returns Pickupcouriers_please_returns_pickup
RDOE5 - Returns Drop Offcouriers_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 TypeAPI CodeDescription
Authority to leavenoneNo confirmation requested.
No authority to leavesignatureSignature 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.

OptionTypeDefault ValueDescription
dangerous_goodsbooleanfalseIndicates 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.