This request allows you to retrieve parcel locker using different search methods.

You can list all lockers for a selected carrier in a country or city, or find the nearest lockers based on coordinates or a postcode. These endpoints are ideal for helping select the most convenient pickup or drop-off locations.

In most cases, you will not need to use these requests, as the Get Rates endpoint already returns the nearest available parcel lockers for the selected shipment.

The locker information provided by Get Rates eliminates the need for additional API calls, reducing network traffic and improving your application's performance.

These endpoints are primarily intended for advanced use cases, such as:

• Building a custom parcel locker selection experience.
• Importing and maintaining a local database of parcel locker locations.
• Periodically synchronizing parcel locker data with your own system.
• Displaying parcel lockers independently of the shipment or rate calculation process.

For the best performance and the lowest number of API requests, we recommend relying on the parcel locker data returned by the Get Rates endpoint whenever possible.

1 Get all carrier parcel lockers in country 

GET https://api.sender.lv/api/v1/parcel_lockers?carrier={{carrier_code}}&country_iso={{country_iso}}

Get All Omniva parcel lockers in Latvia

carrier={{carrier_code}}  carrier=omniva / speficy carrier code

country_iso={{country_iso}}  country_iso=LV / speficy country iso code

2 Get Nearest Lockers by Coordinates 

GET https://api.sender.lv/api/v1/parcel_lockers?latitude={{latitude}}&longitude={{longitude}}&radius_km={{radius_km}}

Retrieve the nearest parcel lockers within a 2 km radius of the provided coordinates.

latitude={{latitude}}  latitude=56.924861

longitude={{longitude}} longitude=24.175283

radius_km={{radius_km}}  radius_km=2

3 Get Nearest Lockers by Postcode 

GET https://api.sender.lv/api/v1/parcel_lockers?country_iso={{country_iso}}&postcode={{postcode}}&radius_km={{radius_km}}

Retrieve the nearest parcel lockers within a 2 km radius of the specified postcode and country. We recommend providing the country, as the same postcode may exist in multiple countries.

country_iso={{country_iso}}  country_iso=LV

postcode={{postcode}} postcode=LV-1021

radius_km={{radius_km}} radius_km=2

4 Get All Carrier Lockers in a City 

GET https://api.sender.lv/api/v1/parcel_lockers?country_iso=LV&city={{city}}

Retrieve all parcel lockers available in the specified city for the selected carrier. We recommend including the country, as cities with the same name may exist in multiple countries.

country_iso={{country_iso}}  country_iso=LV

city={{city}} city=Madona