v1

latestOpenAPI 3.0.12026-07-242073551.1 MB
PUDO Locations

Get PUDO Locations

The Get PUDO Locations endpoint returns a list of PUDO Locations that are within a set radius of the postcode provided in the request. That radius is set to 10 Miles / 16.09 Kilometres. <br />This endpoint must be called before the Create Shipment endpoint to select a PUDO location, and the PUDO location details are then provided in the Create Shipment request. <br />The endpoint currently only supports Royal Mail and InPost.

get/v4/pudolocations/{carrierCode}/{countryCode}/{postcode}

Path parameters

carrierCodestring required

Carrier Code <br />Example: RM

countryCodestring required

2 Digit ISO Country Code, per ISO 3166 Standard

postcodestring required

Recipient Postcode. <br />This will be used to retrieve the available PUDO locations

Query parameters

maximumResultsinteger

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. <br /> <br />Note: If this value is not specified, then by default, a maximum of 10 PUDO locations will be returned in a single request.

locationServicesstring

This parameter specifies the available at each PUDO location. It accepts the following values based on the options provided by the location: <br /> <ul><li>Pickup: Indicates that customers can collect their parcels from the location.</li><li>Dropoff: Indicates that the customers can drop off parcels for shipment at the location.</li><li>Printinstore: Indicates that the location offers printing services for shipping labels, allowing customers to print their labels directly at the store.</li></ul>
<br />Note: If a service is selected, then the locations offering only the requested service will be returned in the response.

enhancedLocationDetailsboolean

This boolean parameter specifies whether the response includes additional detail about each PUDO location in the form of enhancedLocationDetails object. <br /> <ul><li>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 insist customers in making informed decisions.</li><li>If set to false, the response will be limited to the basic details of the PUDO locations without the enhanced attributes.</li></ul> <br />Note: By default, this field is set to false.

Response

Success

TotalCountinteger

Total number of locations returned

Example response

{
  "Locations": [
    {
      "CarrierCode": "RM",
      "LocationAlias": "Post office limited",
      "Address": {
        "Line1": "114-120 Camden High Street",
        "Line2": "Camden Town",
        "Town": "London",
        "Postcode": "TW18 4QR",
        "Geolocation": {
          "Longitude": -0.51174,
          "Latitude": 51.43341
        },
        "OpeningHours": {
          "Monday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Tuesday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Wednesday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Thursday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Friday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Saturday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          },
          "Sunday": {
            "OpeningTime": "09:00:00",
            "ClosingTime": "17:30:00"
          }
        }
      },
      "EnhancedLocationDetails": {
        "LocationType": "POL",
        "Supplier": "Collect+",
        "SupplierLocationType": "Locker",
        "DistanceFromPostcode": 1.4,
        "DistanceUnit": "miles",
        "LocationAvailableFeatures": {
          "ServiceCode": "TPN",
          "LocationServices": "pickup|dropoff|printinstore",
          "Facilities": "carparking|disabledaccess"
        },
        "LocationRestrictions": {
          "MaxSize": "Medium"
        }
      }
    }
  ],
  "TotalCount": 10
}