List Delivery Locations

Request

Retrieve delivery locations for a service based on the given parameters:

Parameter	Type	Required	Description
company_slug	string	yes	The slug of your company in Scurri.
service_slug	string	yes	The slug of the carrier service whose delivery locations are to be searched.
postcode	string	no¹	The postcode being the epicentre of the search.
country	string	no¹	The country of the postcode.
latitude	string	no²	The latitude of the epicentre of the search.
longitude	string	no²	The longitude of the epicentre of the search.
radius	string	no	The search radius in kilometers
limit	string	no	The maximum number of points returned.
categories	array	no	The categories of delivery locations to return. Accepts multiple values.

^1,2 At least one set of the numbered parameters is required (either postcode+country or latitude+longitude).

IMPORTANT!

To trigger postcode-specific rules within Delivery Options, you MUST use postcode and country. Coordinates (latitude / longitude) are not supported for evaluating these conditions.

Security

basicAuth

Query

postcodestring

The postcode to filter locations by. Acts as the epicenter of the search, from which locations will be returned based on the radius and limit specified

Example:postcode=Y35 1X5

countrystring, <= 20 characters

The country of the postcode. Required if postcode is provided.

Example:country=IE

latitudenumber, (float), [ -90 .. 90 ]

The latitude of the epicenter of the search. Required if longitude is provided.

Example:latitude=52.2

longitudenumber, (float), [ -180 .. 180 ]

The longitude of the epicenter of the search. Required if latitude is provided.

Example:longitude=-6.5

radiusnumber, (float), [ 0 .. 50 ]

The search radius in kilometers. Defaults to 10km if not specified.

Example:radius=10

limitinteger, [ 0 .. 100 ]

The maximum number of points to return. Defaults to 20 if not specified.

Example:limit=20

categoriesArray of any

The categories of delivery locations to return. Accepts multiple string values.

Example:categories=locker&categories=collection_point

curl -i -X GET \
  'https://docs.scurri.com/_mock/connect/locations-api/versions/2025.1/openapi/delivery/?postcode=Y35%201X5&country=IE&latitude=52.2&longitude=-6.5&radius=10&limit=20&categories=locker%2Ccollection_point' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

A list of delivery locations for the specified service

Bodyapplication/json

delivery_locationsArray of objects(DeliveryLocation)

Response

{
  "delivery_locations": [
    { … }
  ]
}