Skip to main content
GET
/
service-points
/
{service_point_id}
Retrieve a service point
curl --request GET \
  --url https://servicepoints.sendcloud.sc/api/v2/service-points/{service_point_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": 26,
  "code": "4c8181feec8f49fdbe67d9c9f6aaaf6f",
  "is_active": true,
  "shop_type": null,
  "general_shop_type": "unknown",
  "extra_data": {},
  "name": "DUMMY-3f1d6384391f45ce",
  "street": "Sesamstraat",
  "house_number": "40",
  "postal_code": "5699YE",
  "city": "Eindhoven",
  "latitude": "51.440400",
  "longitude": "5.475800",
  "email": "devnull@sendcloud.nl",
  "phone": "+31401234567",
  "homepage": "https://www.sendcloud.nl",
  "carrier": "postnl",
  "country": "NL",
  "formatted_opening_times": {
    "0": [
      "13:30 - 17:15"
    ],
    "1": [
      "09:00 - 12:00",
      "13:30 - 17:15"
    ],
    "2": [
      "09:00 - 12:00",
      "13:30 - 17:15"
    ],
    "3": [],
    "4": [
      "09:00 - 12:00",
      "13:30 - 17:15"
    ],
    "5": [
      "09:00 - 12:00",
      "13:30 - 17:15"
    ],
    "6": []
  },
  "open_tomorrow": true,
  "open_upcoming_week": true,
  "distance": 361
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
service_point_id
number
required

ID of the service point

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.

Response

OK

A Sendcloud service point object.

​
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.