Squarespace Site API

openapi: 3.1.0
info:
  title: Squarespace Commerce Inventory Site API
  description: The Squarespace Commerce API provides programmatic access to the commerce features of a Squarespace merchant site. It enables developers to build integrations and applications that manage products, process orders, track inventory, access customer profiles, retrieve financial transactions, and configure webhook subscriptions. All endpoints use HTTPS and follow REST principles with standard verbs and response status codes. Authentication is handled via API keys or OAuth tokens.
  version: '1.0'
  contact:
    name: Squarespace Developer Support
    url: https://developers.squarespace.com/commerce-apis/overview
  termsOfService: https://www.squarespace.com/terms-of-service
servers:
- url: https://api.squarespace.com/1.0
  description: Production Server
security:
- bearerAuth: []
tags:
- name: Site
  description: Basic site information and metadata
paths:
  /authorization/website:
    get:
      operationId: retrieveSiteInfo
      summary: Retrieve Basic Site Information
      description: Retrieves basic information about the Squarespace website associated with the authenticated API key or OAuth token. Returns site identifier, title, and other metadata useful for verifying authentication context.
      tags:
      - Site
      responses:
        '200':
          description: Successful response with site information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SiteInfo'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    Error:
      type: object
      description: Standard error response object returned by the Squarespace API
      properties:
        type:
          type: string
          description: Machine-readable error type identifier
        subtype:
          type: string
          description: Optional more specific error subtype
        message:
          type: string
          description: Human-readable description of the error
        statusCode:
          type: integer
          description: HTTP status code associated with the error
    SiteInfo:
      type: object
      description: Basic information about a Squarespace website
      properties:
        id:
          type: string
          description: Unique identifier for the Squarespace website
        websiteTitle:
          type: string
          description: The display title of the website
        websiteUrl:
          type: string
          format: uri
          description: The public URL of the website
        timeZone:
          type: string
          description: The IANA timezone identifier configured for the website
        language:
          type: string
          description: The primary language code of the website
        createdOn:
          type: string
          format: date-time
          description: ISO 8601 UTC timestamp when the website was created
  responses:
    Unauthorized:
      description: Authentication credentials are missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The authenticated user does not have permission to access this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Authenticate using an API key or OAuth access token. Include the token in the Authorization header as "Bearer YOUR_TOKEN".
externalDocs:
  description: Squarespace Commerce API Documentation
  url: https://developers.squarespace.com/commerce-apis/overview