> ## 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 a single service point.

Returns a single service point.

This endpoint can be used to retrieve the latest available details for a specific service point after it has been selected or stored in a checkout or delivery flow.

The returned service point may be expired. Check `is_expired` before using the result in your flow.


## OpenAPI

````yaml /.openapi/v3/service-points/openapi.yaml get /service-points/{service_point_id}
openapi: 3.1.0
info:
  title: Service Points API
  version: 3.0.0
  description: Search service points to display and select in checkout and delivery flows.
  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://panel.sendcloud.sc/api/v3
    description: Sendcloud Production
security: []
tags:
  - name: Service Points
    description: Service Points API
paths:
  /service-points/{service_point_id}:
    parameters:
      - name: service_point_id
        in: path
        required: true
        schema:
          type: integer
          format: int64
          minimum: 1
          example: 1000001
        description: Unique Sendcloud identifier of the service point.
    get:
      tags:
        - Service Points
      summary: Retrieve a service point
      description: Retrieve a single service point.
      operationId: sc-public-v3-servicepoints-get-service_point
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ServicePointDetail'
                required:
                  - data
              examples:
                ServicePointDetail:
                  summary: A single service point
                  value:
                    data:
                      id: 1000002
                      name: Stationsplein Parcel Locker
                      carrier:
                        code: postnl
                        name: PostNL
                        logo_url: >-
                          https://cdn.sendcloud.com/global-media/postnl/img/logo.svg
                        icon_url: >-
                          https://cdn.sendcloud.com/global-media/postnl/img/icon.svg
                      carrier_service_point_id: NL-00002
                      carrier_shop_type: pakketautomaat
                      general_shop_type: locker
                      address:
                        street: Stationsplein
                        house_number: '1'
                        postal_code: 5611 AC
                        city: Eindhoven
                        country_code: NL
                      position:
                        latitude: 51.443218
                        longitude: 5.4816
                      contact:
                        email: ''
                        phone: ''
                      opening_times:
                        monday:
                          - start_time: '10:00'
                            end_time: '21:00'
                        tuesday:
                          - start_time: '10:00'
                            end_time: '21:00'
                        wednesday:
                          - start_time: '10:00'
                            end_time: '21:00'
                        thursday: null
                        friday:
                          - start_time: '10:00'
                            end_time: '21:00'
                        saturday:
                          - start_time: '10:00'
                            end_time: '21:00'
                        sunday: null
                      is_open_tomorrow: false
                      next_open_at: '2026-03-13T10:00:00+01:00'
                      is_expired: false
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
              examples:
                ServicePointNotFound:
                  summary: Service point not found
                  value:
                    errors:
                      - status: '404'
                        code: not_found
                        detail: The service point could not be found
      security:
        - HTTPBasicAuth: []
        - OAuth2ClientCreds: []
components:
  schemas:
    ServicePointDetail:
      title: Service Point
      type: object
      description: Information about a service point.
      properties:
        id:
          type: integer
          format: int64
          example: 1000001
          description: Unique Sendcloud identifier of the service point.
        name:
          type: string
          example: Stationsplein Parcel Locker
          description: Name of the service point.
        carrier:
          $ref: '#/components/schemas/ServicePointCarrier'
        carrier_service_point_id:
          type: string
          example: NL-00001
          description: Carrier-specific identifier of the service point.
        carrier_shop_type:
          type:
            - string
            - 'null'
          example: PBA
          description: |-
            Carrier-specific shop type of the service point.

            For example: `packStation` (DHL), `PBA` (PostNL), `400` (DPD).

            Can be `null` when this information is not available.
        general_shop_type:
          type:
            - string
            - 'null'
          enum:
            - servicepoint
            - locker
            - post_office
            - carrier_depot
          example: locker
          description: >-
            General shop type of the service point. Carrier-specific shop types
            vary per carrier and are mapped to a smaller set of common values.


            - `servicepoint` - Standard service point or parcel shop.

            - `locker` - Automated parcel locker.

            - `post_office` - Post office location.

            - `carrier_depot` - Carrier depot or distribution center.


            Can be `null` when the carrier-specific shop type does not map to
            one of these values. This mapping is maintained manually, so newer
            or less common carriers may not have a mapping yet.


            This list is not exhaustive and may be extended with new values in
            the future.
        address:
          $ref: '#/components/schemas/ServicePointAddress'
        position:
          $ref: '#/components/schemas/ServicePointPosition'
        contact:
          $ref: '#/components/schemas/ServicePointContact'
        opening_times:
          $ref: '#/components/schemas/OpeningTimes'
        is_open_tomorrow:
          type: boolean
          example: true
          description: >-
            Indicates whether the service point is expected to be open tomorrow
            based on its opening hours for the current week.
        next_open_at:
          type:
            - string
            - 'null'
          format: date-time
          example: '2026-03-11T09:00:00+01:00'
          description: |-
            Date and time when the service point is expected to open next.

            Can be `null` when no upcoming opening time is available.
        is_expired:
          type: boolean
          example: false
          description: >-
            Indicates whether the service point details are considered expired.


            We regularly refresh service point details based on carrier updates.

            Because update frequency and coverage vary by carrier, it is not
            always possible to guarantee that every service point is fully up to
            date.


            When `is_expired` is `true`, the service point was last refreshed
            long enough ago that we can no longer be confident the details are
            still up to date or that the service point still exists.


            This field reflects freshness only. It does not indicate whether the
            service point is currently open or available.
      required:
        - id
        - name
        - carrier
        - carrier_service_point_id
        - carrier_shop_type
        - general_shop_type
        - address
        - position
        - contact
        - opening_times
        - is_open_tomorrow
        - next_open_at
        - is_expired
    errors:
      title: Errors
      type: object
      description: A standardized format for errors in JSON:API responses.
      properties:
        errors:
          type:
            - array
            - object
          items:
            type: object
            allOf:
              - $ref: '#/components/schemas/ErrorObject'
            required:
              - status
              - code
              - detail
    ServicePointCarrier:
      title: Service Point Carrier
      type: object
      description: Information about the carrier that operates the service point.
      properties:
        code:
          type: string
          example: postnl
          description: Unique identifier of the carrier.
        name:
          type: string
          example: PostNL
          description: Name of the carrier.
        logo_url:
          type:
            - string
            - 'null'
          format: uri
          example: https://cdn.sendcloud.com/global-media/postnl/img/logo.svg
          description: URL of the carrier logo. Can be `null` when no logo is available.
        icon_url:
          type:
            - string
            - 'null'
          format: uri
          example: https://cdn.sendcloud.com/global-media/postnl/img/icon.svg
          description: >-
            URL of the carrier icon. This is usually more suitable than
            `logo_url` for compact UI elements such as map markers or list
            items. Can be `null` when no icon is available.
      required:
        - code
        - name
        - logo_url
        - icon_url
    ServicePointAddress:
      title: Service Point Address
      type: object
      description: Address of the service point.
      properties:
        street:
          type: string
          example: Stationsplein
          description: Street of the service point address.
        house_number:
          type: string
          example: '1'
          description: House number of the service point address.
        postal_code:
          type: string
          example: 5611 AC
          description: Postal code of the service point address.
        city:
          type: string
          example: Eindhoven
          description: City of the service point address.
        country_code:
          type: string
          example: NL
          description: >-
            Country code of the service point address as an ISO 3166-1 alpha-2
            code.
      required:
        - street
        - house_number
        - postal_code
        - city
        - country_code
    ServicePointPosition:
      title: Service Point Position
      type: object
      description: Geographic coordinates of the service point.
      properties:
        latitude:
          type: number
          format: double
          example: 51.443218
          description: Latitude of the service point.
        longitude:
          type: number
          format: double
          example: 5.4816
          description: Longitude of the service point.
      required:
        - latitude
        - longitude
    ServicePointContact:
      title: Service Point Contact
      type: object
      description: Contact information for the service point.
      properties:
        email:
          type: string
          example: ''
          description: >-
            Contact email address of the service point. Empty when not
            available.
        phone:
          type: string
          example: ''
          description: Contact phone number of the service point. Empty when not available.
      required:
        - email
        - phone
    OpeningTimes:
      title: Opening Times
      type: object
      description: >-
        Opening hours of the service point for the current week.


        These hours reflect the service point's actual availability this week
        and may differ from a typical week due to public holidays or other
        temporary schedule changes.
      properties:
        monday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Monday. `null` if the service point is closed that
            day.
        tuesday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Tuesday. `null` if the service point is closed
            that day.
        wednesday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Wednesday. `null` if the service point is closed
            that day.
        thursday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Thursday. `null` if the service point is closed
            that day.
        friday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Friday. `null` if the service point is closed that
            day.
        saturday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Saturday. `null` if the service point is closed
            that day.
        sunday:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OpeningTime'
              minItems: 1
            - type: 'null'
          description: >-
            Opening hours for Sunday. `null` if the service point is closed that
            day.
      required:
        - monday
        - tuesday
        - wednesday
        - thursday
        - friday
        - saturday
        - sunday
    ErrorObject:
      title: Error
      type: object
      description: Error in a JSON:API error format
      properties:
        id:
          type: string
          description: A unique identifier for the error.
        links:
          type: object
          description: >-
            A set of hyperlinks that provide additional information about the
            error.
          properties:
            about:
              type: string
              description: A URL that provides additional information about the error.
        status:
          type: string
          format: int32
          description: The HTTP status code of the error.
          minLength: 1
        code:
          type: string
          description: A unique error code for the error, in snake case format.
          minLength: 1
          enum:
            - unknown_field
            - invalid
            - forbidden
            - invalid_choice
            - min_value
            - 'null'
            - not_found
            - required
            - not_a_list
            - non_field_errors
            - authentication_failed
            - validation_error
            - parcel_announcement_error
        title:
          type: string
          description: A short, human-readable summary of the error.
          minLength: 1
        detail:
          type: string
          description: A human-readable explanation of the error.
          minLength: 1
        source:
          type: object
          description: >-
            An object that identifies the source of the error within the request
            payload.
          properties:
            pointer:
              type: string
              description: >-
                A `JSON` pointer to the location of the error within the request
                payload.
            parameter:
              type: string
              description: The name of the `query` parameter that caused the error.
            header:
              type: string
              description: The name of the `header` parameter that caused the error.
        meta:
          type: object
          description: Additional metadata about the error.
    OpeningTime:
      title: Opening Time
      type: object
      description: Opening hours for a specific time range.
      properties:
        start_time:
          type: string
          description: Start of the opening time range in 24-hour format (`HH:mm`).
          example: '09:00'
        end_time:
          type: string
          description: End of the opening time range in 24-hour format (`HH:mm`).
          example: '18:00'
      required:
        - start_time
        - end_time
  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.

````