Retrieve a list of service points

GET {{servicePointsBaseUrl}}/service-points?access_token=<string>&country=<string>&carrier=<string>&latitude=<string>&longitude=<string>&ne_latitude=<string>&ne_longitude=<string>&sw_latitude=<string>&sw_longitude=<string>&address=<string>&city=<string>&postal_code=<string>&house_number=<string>&radius=<integer>&weight=<double>&pudo_id=<string>&shop_type=<string>

Retrieve a list of available service points and the associated service point id. 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.

Request Params

KeyDatatypeRequiredDescription
access_tokenstringA JSON Web Token encoding either an “id” (user ID) or “iid” (integration ID) property. Alternatively, a public API key.
countrystring(Required) A country ISO 2 code
carrierstringA comma-separated list of carrier codes (stringified)
latitudestringUsed as a reference point to calculate the distance of the service point to the provided location.
longitudestringUsed as a reference point to calculate the distance of the service point to the provided location.
ne_latitudestringLatitude of the northeast corner of the bounding box.
ne_longitudestringLongitude of the northeast corner of the bounding box.
sw_latitudestringLatitude of the southwest corner of the bounding box.
sw_longitudestringLongitude of the southwest corner of the bounding box.
addressstringAddress of the destination address. Can accept postal code instead of the street and the house number.
citystringCity of the destination address.
postal_codestringPostal code of the destination address. Using postal_code will return you service points located around that particular postal code.
house_numberstringHouse number of the destination address.
radiusstringRadius (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.
weightstringWeight (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_idstringDPD-specific query parameter.
shop_typestringFilters results by their shop type.

HEADERS

KeyDatatypeRequiredDescription
X-Requested-WithstringIdentifies the request as one made using JavaScript
Acceptstring

RESPONSES

status: OK

[{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extra_data&quot;:{},&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;street&quot;:&quot;\u003cstring\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cstring\u003e&quot;,&quot;longitude&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;homepage&quot;:&quot;\u003cstring\u003e&quot;,&quot;carrier&quot;:&quot;\u003cstring\u003e&quot;,&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;formatted_opening_times&quot;:{&quot;0&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;1&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;2&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;3&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;4&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;5&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;6&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;open_tomorrow&quot;:&quot;\u003cboolean\u003e&quot;,&quot;open_upcoming_week&quot;:&quot;\u003cboolean\u003e&quot;,&quot;distance&quot;:&quot;\u003cnumber\u003e&quot;,&quot;shop_type&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;extra_data&quot;:{},&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;street&quot;:&quot;\u003cstring\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cstring\u003e&quot;,&quot;longitude&quot;:&quot;\u003cstring\u003e&quot;,&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;homepage&quot;:&quot;\u003cstring\u003e&quot;,&quot;carrier&quot;:&quot;\u003cstring\u003e&quot;,&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;formatted_opening_times&quot;:{&quot;0&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;1&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;2&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;3&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;4&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;5&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;6&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;open_tomorrow&quot;:&quot;\u003cboolean\u003e&quot;,&quot;open_upcoming_week&quot;:&quot;\u003cboolean\u003e&quot;,&quot;distance&quot;:&quot;\u003cnumber\u003e&quot;,&quot;shop_type&quot;:&quot;\u003cstring\u003e&quot;}]