This documentation is for the v5 (stable) version of the API.
Invocation URL: /v5/psc/lookup

Descripton:

Perform a PSC lookup.
Note: All prices include GST unless otherwise stated.
Prices are for prepaid purchases only, for one-off cash sales please contact your local Regional Franchise.

Parameters:

RFCode - The RFCode of the pickup franchise (eg SYD, NPE, AUK). See the List Regional Franchises method for a more comprehensive list.
Suburb - The destination suburb (eg Homebush, Newcastle, Bunbury)
DestPostcode - The destination postcode (eg 2140, 4112, 4176)
WeightInKg - The total weight of the parcel, in kilograms. 25kg maximum for NZ/AU/IE, and 30kg maximum for SA
LengthInCm - Optional, used for specifying the length parameter of a cubic weight (in centimetres). If specified, Width and Height should also be specified.
WidthInCm - Optional, used for specifying the width parameter of a cubic weight (in centimetres). If specified, Length and Height should also be specified.
HeightInCm - Optional, used for specifying the height parameter of a cubic weight (in centimetres). If specified, Width and Length should also be specified.
FullAddress - Number street name suburb and postcode.
AllowMultipleRegions - Optional, if set to 'true' then will return information about the multiple region matches instead of throwing an error
ShowBoxProduct - Optional, if set to 'true' it will also display box product options

Note: If you specify a cubic weight AND a dead weight, then the greater one will be used in the calculation.

Returns:

A data structure. In JSON, it looks like:

{
    'result': {
        'from': 'Auckland',
        'to': 'Napier',
        'state': 'NI',
        'postcode': '4112',
        'delfranchise': 'Hawkes Bay',
		'delfranchise_code': 'NPE',
		'pickfranchise': 'Auckland',
		'pickfranchise_code': 'AUK',
        'delivery_timeframe_days': '1',
        'parcel_weight_kg': 0,
        'services': [
            {
                'type': 'Parcel',
                'name': 'Road (NI to NI)',
                'labelcolour': 'Orange',
                'labelcolour_array': ['ORANGE'],
                'labelcolour_pretty': 'Orange',
                'labelcolour_pretty_array': ['Orange'],
                'weightlimit': 10,
                'excess_labels_required': 0,
                'excess_label_price_normal': '0',
                'excess_label_price_frequent': '0',
                'excess_label_price_normal_exgst': '0',
                'excess_label_price_frequent_exgst': '0',
                'labelprice_normal': '12.13',
                'labelprice_frequent': '10.87',
                'labelprice_normal_exgst': 10.55,
                'labelprice_frequent_exgst': 9.45,
                'totalprice_normal': '12.13',
                'totalprice_frequent': '10.87',
                'totalprice_normal_exgst': '10.55',
                'totalprice_frequent_exgst': '9.45',
                'rural_labels_required': 0
            },
            {
                'type': 'Satchel',
                'name': 'Satchel',
                'labelcolour': 'SAT-NAT-E11/SAT-NAT-A5/SAT-NAT-A4/SAT-NAT-A3/SAT-NAT-A2',
                'labelcolour_array': ['SAT-NAT-E11','SAT-NAT-A5','SAT-NAT-A4','SAT-NAT-A3','SAT-NAT-A2'],
                'labelcolour_pretty': 'DL/A5/A4/A3/A2',
                'labelcolour_pretty_array': ['DL','A5','A4','A3','A2'],
                'weightlimit': 5,
                'excess_labels_required': 0,
                'excess_label_price_normal': '0',
                'excess_label_price_frequent': '0',
                'excess_label_price_normal_exgst': '0',
                'excess_label_price_frequent_exgst': '0',
                'labelprice_normal': '9.77',
                'labelprice_frequent': '2.59',
                'labelprice_normal_exgst': 8.5,
                'labelprice_frequent_exgst': 2.25,
                'totalprice_normal': '9.77',
                'totalprice_frequent': '2.59',
                'totalprice_normal_exgst': '8.50',
                'totalprice_frequent_exgst': '2.25',
                'rural_labels_required': 0
            }
        ]
    },
    'generated_in': '265ms'
}
Note: The 'rural_labels_required' key will only show for New Zealand based lookups.
If multiple regions are available (and AllowMultipleRegions is set to true), the result will look like:
{
    'result': {
        'multiple_regions': true,
        'regions': [
            {
                'RFCode': 'AUK',
                'Suburb': 'Ahuriri',
                'DestPostcode': '4110',
                'WeightInKg': 15,
                'DeliveryRF': 'NPE'
            },
            {
                'RFCode': 'AUK',
                'Suburb': 'Ahuriri',
                'DestPostcode': '7672',
                'WeightInKg': 15,
                'DeliveryRF': 'CHC'
            }
        ],
        'country_code': '6'
    },
    'generated_in': '78ms'
}

Example:

Lookup the cost of sending a 5kg (dead weight) parcel from Auckland to Elsthorpe:
https://nz.api.fastway.org/v5/psc/lookup/AUK/Elsthorpe/4110/5?api_key=YOUR_API_KEY
Lookup the cost of sending a 30cm x 30cm x 30cm parcel from Auckland to Napier:
https://nz.api.fastway.org/v5/psc/lookup/AUK/Napier/4110?LengthInCm=30&WidthInCm=30&HeightInCm=30&api_key=YOUR_API_KEY
Get the matching regions for a suburb with no postcode:
https://nz.api.fastway.org/v5/psc/lookup/AUK/Ahuriri?WeightInKg=15&AllowMultipleRegions=true&api_key=YOUR_API_KEY

Back to Price Service Calculator