Skip to main content
GET
/
service-points
Retrieve a list of service points
curl --request GET \
  --url https://servicepoints.sendcloud.sc/api/v2/service-points \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "id": 10875349,
    "code": "217165",
    "is_active": true,
    "shop_type": null,
    "general_shop_type": "undefined",
    "extra_data": {
      "partner_name": "PostNL",
      "sales_channel": "AFHAALPUNT",
      "terminal_type": "NRS",
      "retail_network_id": "PNPNL-01"
    },
    "name": "Media Markt Eindhoven Centrum B.V.",
    "street": "Boschdijktunnel",
    "house_number": "1",
    "postal_code": "5611AG",
    "city": "EINDHOVEN",
    "latitude": "51.441444",
    "longitude": "5.475185",
    "email": "",
    "phone": "",
    "homepage": "",
    "carrier": "postnl",
    "country": "NL",
    "formatted_opening_times": {
      "0": [
        "10:00 - 20:00"
      ],
      "1": [
        "10:00 - 20:00"
      ],
      "2": [
        "10:00 - 20:00"
      ],
      "3": [
        "10:00 - 20:00"
      ],
      "4": [
        "10:00 - 20:00"
      ],
      "5": [
        "10:00 - 18:00"
      ],
      "6": []
    },
    "open_tomorrow": true,
    "open_upcoming_week": true,
    "distance": 381
  }
]
Only service points which are applicable to the carriers you have enabled in the integration settings menu will be returned. You can filter the results based on GPS location or address in combination with a search radius.

​
Notes

  • If provided, latitude and longitude specify a reference point from which a distance will be computed for each service point, and returned with the response.
  • Some carriers impose limits for certain service point, which means that they cannot accept parcels above a certain weight range. For this reason, you can specify the weight parameter to ensure that only usable service points are returned.
  • If provided, postal_code will return a list of service points which are located exactly within the bounds of the specified postal code area.
  • The address parameter retrieves a list of service points closest to the referenced location. You can adjust the radius of the results through the ‘radius’ parameter.
  • The address parameter accepts postal codes in addition to street names.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Headers

​
X-Requested-With
string

Identifies the request as one made using JavaScript

Query Parameters

​
access_token
string

A JSON Web Token encoding either an “id” (user ID) or “iid” (integration ID) property. Alternatively, a public API key.

​
country
string
required

A country ISO 2 code

Example:

"NL"

​
carrier
string

A comma-separated list of carrier codes (stringified)

Example:

"postnl,dpd"

​
latitude
string

Used as a reference point to calculate the distance of the service point to the provided location.

​
longitude
string

Used as a reference point to calculate the distance of the service point to the provided location.

​
ne_latitude
string

Latitude of the northeast corner of the bounding box.

​
ne_longitude
string

Longitude of the northeast corner of the bounding box.

​
sw_latitude
string

Latitude of the southwest corner of the bounding box.

​
sw_longitude
string

Longitude of the southwest corner of the bounding box.

​
address
string

Address of the destination address. Can accept postal code instead of the street and the house number.

Example:

"Stadhuisplein 10"

​
city
string

City of the destination address.

Example:

"Eindhoven"

​
postal_code
string

Postal code of the destination address. Using postal_code will return you service points located around that particular postal code.

Example:

"5611 EM"

​
house_number
string

House number of the destination address.

Example:

"10"

​
radius
integer

Radius (in meter) of a bounding circle. Can be used instead of the ne_latitude, ne_longitude, sw_latitude, and sw_longitude parameters to define a bounding box. Minimum value: 100 meters. Maximum value: 50 000 meters.

Required range: 100 <= x <= 50000
​
weight
number<double>

Weight (in kg.) of the parcel to be shipped to the service points. Certain carriers impose limits for certain service points that cannot accept parcels above a certain weight limit.

​
pudo_id
string

DPD-specific query parameter.

Maximum string length: 7
​
shop_type
string

Filters results by their shop type.

​
general_shop_type
string

Filters results by general shop type. Accepts a single value (e.g., servicepoint) or a comma-separated list of values (e.g., servicepoint,locker,post_office).

Possible options:

  • servicepoint
  • locker
  • post_office
  • carrier_depot
Example:

"servicepoint"

Response

OK

​
id
integer
required
​
code
string
required
​
is_active
boolean
required

Indicates whether the service point data was recently updated via scraping within a carrier-specific expiration period. This field reflects data freshness, not operational availability. To check if a service point is operationally open, use open_tomorrow or open_upcoming_week instead.

​
extra_data
object
required

Can contain carrier specific data

​
name
string
required
​
street
string
required
​
house_number
string
required
​
postal_code
string
required
​
city
string
required
​
latitude
string
required
​
longitude
string
required
​
email
string
required
​
phone
string
required
​
homepage
string
required
​
carrier
string
required
Example:

"postnl"

​
country
string
required
Example:

"NL"

​
formatted_opening_times
object
required
​
open_tomorrow
boolean
required

Indicates whether the service point will be open tomorrow based on its operating schedule. This field is calculated from formatted_opening_times and should be used to determine operational availability.

​
open_upcoming_week
boolean
required

Indicates whether the service point will be open at least once during the next 7 days. This field is calculated from formatted_opening_times including any schedule exceptions, and should be used to determine operational availability.

​
distance
number
required

Distance between the reference point and the service point in meters.

​
shop_type
string | null
​
general_shop_type
string | null

A normalized shop type indicating the general category of the service point. Carrier-specific shop types are mapped to a fixed set of values, such as servicepoint, locker, post_office, carrier_depot, etc.