Get PUDO Locations

get

https://api.intersoftsapient.net/v4/pudolocations/{carrierCode}/{countryCode}/{postcode}

Retrieves a list of Pick-Up and Drop-Off (PUDO) locations associated with a specified carrier that are within a set radius of the postcode provided in the request. That radius is set to 10 Miles / 16.09 Kilometres. With this endpoint, you can find convenient locations for dropping off or picking up shipments, enhancing logistical efficiency and user experience.

Before calling this endpoint, bear in mind the following:

• You must call this endpoint before the Create Shipment endpoint so that the desired PUDO location is selected in the Create Shipment request.

• This endpoint is currently supported by Royal Mail and InPost.

Path Params

carrierCode

string

required

A unique identifier for the shipping carrier for which the PUDO locations are being requested. This code helps specify the provider and ensures that the returned locations are relevant to the selected carrier's service.

countryCode

string

required

length between 2 and 2

An abbreviation representing the country in which you are seeking PUDO locations, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.

postcode

string

required

length ≤ 10

The postal or ZIP code corresponding to the area where you want to find PUDO locations. This helps in retrieving the available PUDO locations by narrowing down the search to relevant locations nearby.

Query Params

maximumResults

int32

An integer specifying the maximum number of PUDO locations returned in the response. With it, you can control the volume of data returned, optimising performance and usability.

Note: If this value is not specified, then by default, a maximum of 10 PUDO locations will be returned in a single request.

locationServices

string

This parameter specifies the services available at each PUDO location. It accepts the following values based on the options provided by the location:

Pickup: Indicates that customers can collect their parcels from the location.
Dropoff: Indicates that the customers can drop off parcels for shipment at the location.
Printinstore: Indicates that the location offers printing services for shipping labels, allowing customers to print their labels directly at the store.

Note: If a service is selected, then the locations offering only the requested service will be returned in the response.

enhancedLocationDetails

boolean

Defaults to false

This boolean parameter specifies whether the response includes additional detail about each PUDO location in the form of enhancedLocationDetails object.

If set to true, the response will include enhancedLocationDetails object for each PUDO location. This object provides more comprehensive information, such as facilities available at the location, for example, disabled access, parking, and so on, distance from postcode, and any additional attributes relevant to the location that might assist customers in making informed decisions.
If set to false, the response will be limited to the basic details of the PUDO locations without the enhanced attributes.

Note: By default, this field is set to false.

Responses

401

Unauthorized

403

Forbidden

404

The carrier code was not found.

500

Internal Server Error

Language

Credentials

OAuth2

Loading…

Response

Choose an example:

application/json

200Success

400Invalid request response.