Request Details

Request – Structure for Get Service

from media-type in original link (Note: */* in place of the header value will return an error)

Authorization

Basic {Base64 encoding of userid:password}

Accept-language

en-CA or fr-CA

Body

None

Query String

There is one optional parameter for the query string:

Element Name

Description

country

This parameter will fine tune the options if provided. For example, some countries support the signature option for Xpresspost™-International and some do not.

Note: we do not validate whether the shipping service you specified is a valid service for the country you provide. Therefore, even if the service is not offered for the country you specify, a list of the default options will still be returned.

Request – Elements

The Get Service service does not require any input XML data.

Response Details

Response – Elements

Element Name

Type

Description

service-code

simple

Service identifier.

service-name

simple

Description of service in the language of choice.

comment

simple

Coverage message stating the maximum amount of coverage included with this service (which can be none); only returned on a few U.S. and international services where additional coverage cannot be purchased.

True indicates that this option if selected must include a qualifier on the option. This is true for insurance (COV) and collect on delivery (COD) options.

qualifier-max

simple

Numeric – indicates the maximum value of the qualifier for this service. The maximum value of a qualifier may differ between services. This is specific to the insurance (COV) option.

restrictions

complex

Details the weight and size restrictions of parcels shipped via this service.

weight-restriction

complex

Details the weight restrictions of items shipped via this service.

min

attribute on weight-restriction

Minimum weight in grams.

max

attribute on weight-restriction

Maximum weight in grams that can be sent using this service.

dimensional-restrictions

complex

Details the dimension restrictions of items shipped via this service

length

Complex

Specifies the dimension range of the longest dimension of an item in cm.

width

Complex

Specifies the dimension range of the second longest dimension of an item in cm.

height

Complex

Specifies the dimension range of the shortest dimension of an item in cm.

min

attribute on length, width and height

Minimum measurement in centimetres allowed for the dimension.

max

attribute on length, width and height

Maximum measurement in centimetres allowed for the dimension.

length-plus-girth-max

Simple

Maximum calculated value of length + 2*width + 2*height in cm.

length-height-width-sum-max

Simple

Maximum value of length + width + height in cm.

oversize-limit

Simple

If any dimension exceeds this limit an oversize fee will apply to the shipment (cm).

density-factor

Simple

Standard density factor used to calculate volumetric equivalent of actual weight (VE). Note: Canada Post can use another factor to calculate the volumetric equivalent, depending on your parcels agreement.

can-ship-in-mailing-tube

simple

True | False

True indicates that parcels shipped with this service can be shipped in a mailing tube (option CYL can be used).

can-ship-unpackaged

Simple

True | False

True indicates that parcels shipped with this service can be shipped unpackaged (option UP can be used).

allowed-as-return-service

Simple

True | False

True indicates that this service can be used in the return-spec of a Create Shipment request.

Response – XML Diagram

The following is the hierarchical structure of the XML to be used for providing the service details. Either the service response (valid response) or the messages response (error response) will be returned.