> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Check availability of a service point

> Check whether a service point is currently available.

Service point availability can change over time.
Although we try our best to return only service points that are considered up to date, search results may still include service points that are no longer available.

The way availability is checked varies by carrier. For some carriers, this involves a live availability check with the carrier.
For others, availability is determined using our best estimate based on the information available at the time of the request.


## OpenAPI

````yaml /.openapi/v3/service-points/openapi.yaml post /service-points/{service_point_id}/check-availability
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}/check-availability:
    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.
    post:
      tags:
        - Service Points
      summary: Check availability of a service point
      description: Check whether a service point is currently available.
      operationId: sc-public-v3-servicepoints-post-check_availability
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      is_available:
                        type: boolean
                        description: >-
                          Indicates whether the service point is currently
                          available.
                        example: true
                    required:
                      - is_available
                required:
                  - data
              examples:
                Available:
                  summary: Service point is available
                  value:
                    data:
                      is_available: true
                NotAvailable:
                  summary: Service point is not available
                  value:
                    data:
                      is_available: 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:
    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
    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.
  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.

````