API References

Get PUDO Locations

get
https://api.intersoftsapient.net/v4/pudolocations///

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, InPost and InPost Global.

• For InPost Global (INPOSTGLB), the query parameter shippingAccountId is required (shipping account id or alias) so Sapient can authenticate to the InPost Location API using that account's credentials.

Path Params
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.

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.

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
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.

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.

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.

string

Shipping account id or alias. Required for InPost Global (INPOSTGLB). Ignored for Royal Mail and legacy InPost.

Responses

401

Unauthorized

403

Forbidden

404

The carrier code was not found.

500

Internal Server Error

Updated about 1 month ago

Did this page help you?
Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json

Updated about 1 month ago

Did this page help you?