> ## Documentation Index > Fetch the complete documentation index at: https://sendcloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a service point > Retrieve information about a specific service point location, including opening hours and applicable carriers, based on the service point `id`. ## OpenAPI ````yaml /.openapi/v2/service-points/openapi.yaml get /service-points/{service_point_id} openapi: 3.1.0 info: title: Service points version: 2.0.0 description: >- The Service Point API allows you to retrieve service point locations, verify their availability and store them in the Sendcloud platform during the checkout process. contact: name: Sendcloud API Support url: https://www.sendcloud.dev email: contact@sendcloud.com license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://servicepoints.sendcloud.sc/api/v2 description: Sendcloud Production security: [] tags: - name: Service Points description: Endpoints related to Service Points flow paths: /service-points/{service_point_id}: parameters: - schema: type: number name: service_point_id in: path required: true description: ID of the service point get: tags: - Service Points summary: Retrieve a service point description: >- Retrieve information about a specific service point location, including opening hours and applicable carriers, based on the service point `id`. operationId: sc-public-v2-servicepoints-get-service_point_by_id parameters: - $ref: '#/components/parameters/AccessToken' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/service-point' examples: RetrieveServicePoint: summary: Retrieve a service point 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 '404': $ref: '#/components/responses/404' security: - HTTPBasicAuth: [] - OAuth2ClientCreds: [] - AccessTokenAuth: [] components: parameters: AccessToken: name: access_token in: query description: >- A JSON Web Token encoding either an “id” (user ID) or “iid” (integration ID) property. Alternatively, a public API key. schema: type: string schemas: service-point: title: ServicePoint Object description: A Sendcloud service point object. type: object example: id: 10875349 code: '217165' is_active: true shop_type: null general_shop_type: servicepoint extra_data: partner_name: PostNL sales_channel: AFHAALPUNT terminal_type: NRS retail_network_id: PNPNL-01 name: Example Parcel Shop street: Voorbeeldstraat house_number: '12' 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 properties: id: type: integer description: The unique identifier of the service point. code: type: string description: A carrier-specific identifier for the service point. is_active: type: boolean description: >- 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. shop_type: type: string nullable: true description: >- The carrier-specific shop type classification. May be `null` if the carrier does not provide this information. general_shop_type: type: string description: >- 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. nullable: true extra_data: type: object description: >- 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: type: string description: The name of the service point location. street: type: string description: The street name of the service point address. house_number: type: string description: The house number of the service point address. postal_code: type: string description: The postal code of the service point address. city: type: string description: The city where the service point is located. latitude: type: string description: The geographic latitude of the service point. longitude: type: string description: The geographic longitude of the service point. email: type: string description: The contact email address of the service point. phone: type: string description: The contact phone number of the service point. homepage: type: string description: The homepage URL of the service point. carrier: type: string example: postnl description: The code of the carrier operating this service point. country: type: string example: NL description: >- The country where the service point is located, formatted as an ISO 3166-1 alpha-2 code. formatted_opening_times: type: object description: >- 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. required: - '0' - '1' - '2' - '3' - '4' - '5' - '6' properties: '0': type: array items: type: string example: 11:00 - 18:00 '1': type: array items: type: string example: 11:00 - 18:00 '2': type: array items: type: string example: 11:00 - 18:00 '3': type: array items: type: string example: 11:00 - 18:00 '4': type: array items: type: string example: 11:00 - 18:00 '5': type: array items: type: string example: 11:00 - 18:00 '6': type: array items: type: string example: 11:00 - 18:00 open_tomorrow: type: boolean description: >- 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: type: boolean description: >- 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: type: number description: >- 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. required: - id - code - is_active - extra_data - name - street - house_number - postal_code - city - latitude - longitude - email - phone - homepage - carrier - country - formatted_opening_times - open_tomorrow - open_upcoming_week responses: '404': description: Not Found content: application/json: schema: type: object properties: error: type: object properties: code: type: integer format: int32 example: 404 description: >- The HTTP [status code](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) request: type: string example: api/v2/service-points/1 description: The user requested path message: type: string example: The requested resource could not be found description: A message providing further information about the error. securitySchemes: HTTPBasicAuth: type: http description: >- Basic Authentication using API key and secrets is currently the main authentication mechanism. scheme: basic OAuth2ClientCreds: type: oauth2 description: >- OAuth2 is a standardized protocol for authorization that allows users to share their private resources stored on one site with another site without having to provide their credentials. OAuth2 Client Credentials Grant workflow. This workflow is typically used for server-to-server interactions that require authorization to access specific resources. flows: clientCredentials: tokenUrl: https://account.sendcloud.com/oauth2/token/ scopes: api: Default OAuth scope required to access Sendcloud API. AccessTokenAuth: type: http scheme: bearer description: AccessToken ````