---
title: "Get PUDO Locations"
method: GET
path: "/v4/pudolocations/{carrierCode}/{countryCode}/{postcode}"
tags: ["PUDO Locations"]
---

# Get PUDO Locations

`GET /v4/pudolocations/{carrierCode}/{countryCode}/{postcode}`

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.

## Path parameters

- `carrierCode` string, required
- `countryCode` string, required
- `postcode` string, required

## Query parameters

- `maximumResults` integer
- `locationServices` string
- `enhancedLocationDetails` boolean

## Response `200`

Success

- GetPudoLocationsResponse — Get PUDO Locations response
  - `Locations` Location[], nullable — The locations
    - `CarrierCode` string, required — Carrier code sent in the request <br />Valid values are the following: <br />**RM** - for Royal Mail <br />**INPOST** - for InPost
    - `LocationAlias` string, required — The location alias.
    - `LocationId` string, required — For Royal Mail this will be the Postcode of the post office.
    - `Address` Address — Address
      - `Line1` string, required — The 1st of the PUDO location address
      - `Line2` string, nullable — The line 2 of the PUDO location address
      - `Line3` string, nullable — The line 3 of the PUDO Location address
      - `Town` string, required — City of the PUDO location
      - `Postcode` string, nullable — Postcode of the PUDO location
      - `Geolocation` Geolocation — The longitude and latitude for the PUDO location
        - `Longitude` number, double — Only returned for carriers that provide this information
        - `Latitude` number, double — Only returned for carriers that provide this information
      - `OpeningHours` OpeningHours — A list of opening hours by day of week
        - `Monday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Tuesday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Wednesday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Thursday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Friday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Saturday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
        - `Sunday` OpeningHoursTime — Opening Hours time
          - `OpeningTime` string, nullable — Opening time for this location in HH:MM:SS format
          - `ClosingTime` string, nullable — Closing time for this location in HH:MM:SS format
    - `EnhancedLocationDetails` EnhancedLocationDetails — This object provides detailed information on the PUDO location for the requested service. <br /> <br />***Note**: This information is only provided if the **enhancedLocationDetails** field in the query parameter is set to true.*
      - `LocationType` string, nullable — Indicates the type of location where parcels can be collected or dropped off. <br />Valid values are the following: <br /><ul><li>**POL** - Post Office Location</li><li>**CSP** - Customer Service Point</li><li>**PSH** - Parcel Shop</li><li>**LOK** - Locker</li></ul>
      - `Supplier` string, nullable — Indicates the name of the supplier associated with the specific location type, for example, PSH (RMShop).
      - `SupplierLocationType` string, nullable — A categorisation that indicates the specific type of supplier location, providing additional context about the addition options available at that location, for example, RMShop.
      - `LabelId` string, nullable — A unique identifier for the Local Collect label and Pre-advice associated with the shipments at the location, which may be used for tracking and processing purposes.
      - `DistanceFromPostcode` number, double, nullable — The distance from the specified postcode to the PUDO location, giving customers an indication of how far the location is from your desired address.
      - `DistanceUnit` string, nullable — The unit for the distance specified in the **DistanceFromPostcode** field. <br /> <br />***Note**: By default, this field only returns the unit in miles.*
      - `SupplementCode` string, nullable — A specific code that represents the type of location associated with a PUDO (Pick Up Drop Off) point. This code is essential in the pre-advice for shipments and indicates the type of PUDO location. However, when using the Create Shipment request, this code is automatically added based on the selected PUDO location. <br /> <br />The codes may include the following with their associated suppliers: <br /><ul><li>**LC1**: Customer Service Point (CSP)—Royal Mail</li><li>**LC2**: Post Office (POL)—Post Office</li><li>**LC3**: RMShop (PSH)—Royal Mail</li><li>**LC4**: Locker (LOK)—Quadient</li><li>**LC5**: Locker (LOK)—Royal Mail</li></ul>
      - `LocationAvailableFeatures` LocationAvailableFeatures — This object contains key details about the capabilities and services offered at each PUDO location.
        - `ServiceCode` string, nullable — Identifies the specific carrier shipping service that can be utilised at the local collect location, for example, TPN, TPS, ITL, and so on, allowing customers to understand the service options available for their parcels.
        - `AcceptSignature` boolean, nullable — Indicates whether the location is capable of accepting parcels that require a signature upon collection, ensuring that customers know which location can accommodate their signing requirements.
        - `AcceptNonSignature` boolean, nullable — Indicates whether the location accepts parcels that require a signature upon collection, giving customers flexibility in choosing their pickup options based on their specific needs.
        - `LocationServices` string, nullable — Provides a list of services available at the location, which may include the following: <br /><ul><li>**Pickup**</li><li>**Dropoff**</li><li>**Printinstore**</li></ul>
        - `Facilities` string, nullable — Provides information about any additional facilities available at the location, such as disabled access, parking, or other amenities, enhancing customer convenience.
      - `LocationRestrictions` LocationRestrictions — This object outlines the limitations regarding parcel acceptance at each PUDO location. This object is critical for ensuring that customers are aware of the maximum allowable dimensions and weights for the parcels they intend to send or collect.
        - `MaxHeight` number, double, nullable — The maximum height restriction for parcels accepted at the location, ensuring that items are within acceptable measurement limits, measured in centimeters.
        - `MaxWidth` number, double, nullable — The maximum width restriction for parcels accepted at the location, providing guidance on the acceptable dimensions for incoming shipments, measured in centimeters.
        - `MaxLength` number, double, nullable — The maximum length restriction for parcels accepted at the location, indicating the longest dimension acceptable for parcels at the location, measured in centimeters.
        - `MaxWeight` number, double, nullable — The maximum weight limit for parcels that the location can handle, ensuring that heavier items are appropriately received and processed, measured in kilograms.
        - `MaxSize` string, nullable — The maximum overall size restriction for parcels accepted at the location, for example, Small, Medium, Large, serving as a general guideline for the dimensional limits of parcels, ensuring compliance with the location's parcel acceptance policies.
  - `TotalCount` integer — Total number of locations returned

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The carrier code was not found.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)