openapi: 3.2.0
info:
  contact:
    email: x-series.api@lightspeedhq.com
    name: Lightspeed Developer Relations
    url: https://developers.retail.lightspeed.app
  description: Lightspeed Retail (X-Series) API.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developers.lightspeedhq.com/terms
  title: 2026-07 Outlet Product Taxes API
  version: 2026-07
servers:
- url: https://{domain_prefix}.retail.lightspeed.app/api/2026-07
  variables:
    domain_prefix:
      default: example
      description: Domain prefix of the store to be operated on
security:
- bearerAuth: []
tags:
- description: Outlet Product Tax operations
  name: Outlet Product Taxes
paths:
  /outlet_taxes:
    get:
      description: 'Returns a paginated list of outlet-product-tax records.


        🔒 Requires: `outlets:read` scope'
      operationId: listOutletProductTaxes
      parameters:
      - description: The ID of the outlet for which the results should be returned.
        in: query
        name: outlet_id
        schema:
          type: string
      - description: The lower limit for the version numbers to be included in the response.
        in: query
        name: after
        schema:
          format: int64
          type: integer
      - description: The upper limit for the version numbers to be included in the response.
        in: query
        name: before
        schema:
          format: int64
          type: integer
      - description: The maximum number of items to be returned in the response.
        in: query
        name: page_size
        schema:
          type: integer
      - description: Indicates whether deleted items should be included in the response.
        in: query
        name: deleted
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                - outlet_id: b1e04bd8-f019-11e3-a0f5-b8ca3a64f8f4
                  product_id: b8ca3a65-0183-11e4-fbb5-281af7f3d091
                  tax_id: b1d192bc-f019-11e3-a0f5-b8ca3a64f8f4
                  version: 2162167
                - outlet_id: b1e04bd8-f019-11e3-a0f5-b8ca3a64f8f4
                  product_id: b8ca3a65-0183-11e4-fbb5-281b151ee9a6
                  tax_id: b1d192bc-f019-11e3-a0f5-b8ca3a64f8f4
                  version: 2162183
                - outlet_id: b1e04bd8-f019-11e3-a0f5-b8ca3a64f8f4
                  product_id: b8ca3a64-f883-11e4-e0f5-15e94b089bc5
                  tax_id: b1cecdf6-f019-11e3-a0f5-b8ca3a64f8f4
                  version: 10734484
                version:
                  max: 10734484
                  min: 2162167
              schema:
                $ref: '#/components/schemas/OutletTaxCollection'
          description: ''
      summary: List outlet product taxes
      tags:
      - Outlet Product Taxes
components:
  schemas:
    OutletTaxCollection:
      properties:
        data:
          description: An array of outlet-product-tax records.
          items:
            $ref: '#/components/schemas/OutletTax'
          type: array
        version:
          $ref: '#/components/schemas/Version'
      type: object
    Version:
      description: An object containing the highest and lowest version numbers for all items of the returned collection.
      properties:
        max:
          description: Highest version number of the payload, or `null` when the result set is empty.
          format: int64
          type:
          - integer
          - 'null'
        min:
          description: Lowest version number of the payload, or `null` when the result set is empty.
          format: int64
          type:
          - integer
          - 'null'
      required:
      - max
      - min
      type: object
    OutletTax:
      properties:
        deleted_at:
          description: Deletion timestamp in UTC.
          type:
          - string
          - 'null'
        outlet_id:
          description: The ID of the outlet this record is associated with.
          format: uuid
          type: string
        product_id:
          description: The ID of the product this record is associated with.
          format: uuid
          type: string
        tax_id:
          description: The ID of the tax this record is associated with.
          format: uuid
          type: string
        version:
          description: Auto-incrementing object version number.
          format: int64
          type: integer
      required:
      - outlet_id
      - product_id
      - tax_id
      - version
      title: Outlet Product Tax
      type: object
  securitySchemes:
    bearerAuth:
      description: Bearer Token for API authentication.
      scheme: bearer
      type: http
externalDocs:
  description: List of tz database time zones
  url: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones