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
}

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

The unique identifier of the service point.

code
string
required

A carrier-specific identifier for the service point.

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

Contains carrier-specific metadata about the service point. This field has no fixed structure โ€” it may contain different fields depending on the carrier, or be empty. Do not rely on any specific keys being present.

name
string
required

The name of the service point location.

street
string
required

The street name of the service point address.

house_number
string
required

The house number of the service point address.

postal_code
string
required

The postal code of the service point address.

city
string
required

The city where the service point is located.

latitude
string
required

The geographic latitude of the service point.

longitude
string
required

The geographic longitude of the service point.

email
string
required

The contact email address of the service point.

phone
string
required

The contact phone number of the service point.

homepage
string
required

The homepage URL of the service point.

carrier
string
required

The code of the carrier operating this service point.

Example:

"postnl"

country
string
required

The country where the service point is located, formatted as an ISO 3166-1 alpha-2 code.

Example:

"NL"

formatted_opening_times
object
required

The opening hours for each day of the week, keyed by day number (0 = Monday, 6 = Sunday). Each day contains an array of time range strings. An empty array indicates the service point is closed on that day.

This field is dynamically computed for the current week. It takes the regular opening hours as a base and applies any exceptions reported by the carrier (e.g. reduced hours or closures on holidays). For example, if a service point is normally open 07:00โ€“22:00 every day but has reduced hours on Christmas Eve and is closed on Christmas Day, those overrides will be reflected in the output for that week.

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.

shop_type
string | null

The carrier-specific shop type classification. May be null if the carrier does not provide this information.

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.

distance
number

Distance between the reference point and the service point in meters. Only returned on the list endpoint when latitude/longitude or address query parameters are provided.