---
openapi: 3.0.3
info:
  title: Store API
  contact:
    name: Spree Commerce
    url: https://spreecommerce.org
    email: hello@spreecommerce.org
  description: |
    Spree Store API v3 - Customer-facing storefront API for building headless commerce experiences.

    ## Authentication

    The Store API uses two authentication methods:

    ### API Key (Required)
    All requests must include a publishable API key in the `x-spree-api-key` header.

    ### JWT Bearer Token (For authenticated customers)
    After login, include the JWT token in the `Authorization: Bearer <token>` header.

    ### Order Token (For guest checkout)
    When creating an order, a `token` is returned. Include this in the `x-spree-token` header
    for guest access to that specific order.

    ## Response Format

    All responses are JSON. List endpoints return paginated responses with `data` and `meta` keys.

    ## Error Handling

    Errors return a consistent format:
    ```json
    {
      "error": {
        "code": "record_not_found",
        "message": "Product not found"
      }
    }
    ```
  version: v3
paths:
  "/api/v3/store/auth/login":
    post:
      summary: Login
      tags:
      - Authentication
      security:
      - api_key: []
      description: |
        Authenticates a customer and returns a JWT access token + refresh token.

        The `provider` field selects the authentication method. When omitted it
        defaults to `email`, the built-in email/password login.

        To authenticate against a third-party identity provider (Auth0, Okta,
        Firebase, a custom JWT issuer, SAML, etc.), send
        `{ "provider": "<your_key>", ... }` with the fields that provider
        requires. The endpoint returns the same JWT + refresh token regardless of
        which provider authenticated the request. See
        [Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication)
        for the list of configured providers and their required fields.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const auth = await client.auth.login({
            email: 'customer@example.com',
            password: 'password123',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: login successful
          content:
            application/json:
              example:
                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImRlZmM5YWZhLTUzOTYtNDEwYy1hZDY4LTE4YTBiN2M5MmMwMyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzY4NDgyMDAwfQ.ha-8UOgpGEgYAVWjEqzhLZ9LPtI6uTlsDB3We7qbrdU
                refresh_token: CxKP3VYWQzkXqrfxTmPLB446
                user:
                  id: cust_UkLWZg9DAJ
                  email: test@example.com
                  first_name: Julie
                  last_name: Bode
                  phone:
                  accepts_email_marketing: false
                  email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                  full_name: Julie Bode
                  available_store_credit_total: '0.00'
                  display_available_store_credit_total: "$0.00"
                  addresses: []
                  default_billing_address:
                  default_shipping_address:
                  newsletter_subscriber:
                  customer_groups: []
              schema:
                "$ref": "#/components/schemas/AuthResponse"
        '401':
          description: missing API key
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - title: EmailPasswordLogin
                description: Built-in email/password authentication (default when
                  `provider` is omitted).
                type: object
                properties:
                  provider:
                    type: string
                    enum:
                    - email
                    default: email
                  email:
                    type: string
                    format: email
                    example: customer@example.com
                  password:
                    type: string
                    example: password123
                required:
                - email
                - password
              - title: ProviderLogin
                description: |
                  Provider-dispatched login. The `provider` key selects a configured
                  authentication provider; the remaining fields are forwarded to it.
                  Required fields depend on the provider — see
                  [Custom API Authentication](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication).
                type: object
                properties:
                  provider:
                    type: string
                    example: auth0
                    description: Registered provider key (anything other than `email`).
                    not:
                      enum:
                      - email
                required:
                - provider
                additionalProperties: true
  "/api/v3/store/auth/refresh":
    post:
      summary: Refresh token
      tags:
      - Authentication
      security:
      - api_key: []
      description: Exchanges a refresh token for a new access JWT and rotated refresh
        token. No Authorization header needed.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const auth = await client.auth.refresh({
            refresh_token: 'rt_xxx',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: token refreshed
          content:
            application/json:
              example:
                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjFmMzM5OGY2LTczZDgtNDdjNi1hNDk4LTUxNDc3MGUxYTUyNSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzY4NDgyMDAwfQ.Zpvl-ISrctLW34O3zJFteOf3wMDNvlymVKsbkCIfeew
                refresh_token: mWbQ77onTSsXQta8Z4SAVaTU
                user:
                  id: cust_UkLWZg9DAJ
                  email: test@example.com
                  first_name: Yuki
                  last_name: Harvey
                  phone:
                  accepts_email_marketing: false
                  email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                  full_name: Yuki Harvey
                  available_store_credit_total: '0.00'
                  display_available_store_credit_total: "$0.00"
                  addresses: []
                  default_billing_address:
                  default_shipping_address:
                  newsletter_subscriber:
                  customer_groups: []
              schema:
                "$ref": "#/components/schemas/AuthResponse"
        '401':
          description: missing or invalid refresh token
          content:
            application/json:
              example:
                error:
                  code: invalid_refresh_token
                  message: Invalid or expired refresh token
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/RefreshTokenParams"
        required: true
  "/api/v3/store/auth/logout":
    post:
      summary: Logout
      tags:
      - Authentication
      security:
      - api_key: []
      description: Revokes the submitted refresh token. The refresh token itself is
        the credential — no Authorization header is required, so a client with an
        expired access JWT can still log out.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.auth.logout({
            refresh_token: 'rt_xxx',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '204':
          description: logout without refresh token (no-op)
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/LogoutParams"
        required: true
  "/api/v3/store/password_resets":
    post:
      summary: Request a password reset
      tags:
      - Authentication
      security:
      - api_key: []
      description: Sends a password reset email if an account exists for the given
        email address. Always returns 202 Accepted to prevent email enumeration.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.passwordResets.create({
            email: 'customer@example.com',
            redirect_url: 'https://myshop.com/reset-password',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '202':
          description: email not found (same response to prevent enumeration)
          content:
            application/json:
              example:
                message: If an account exists for that email, password reset instructions
                  have been sent.
              schema:
                type: object
                properties:
                  message:
                    type: string
        '401':
          description: missing API key
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/RequestPasswordResetParams"
        required: true
  "/api/v3/store/password_resets/{token}":
    patch:
      summary: Reset password with token
      tags:
      - Authentication
      security:
      - api_key: []
      description: Resets the password using a token received via email. Returns a
        JWT token on success (auto-login).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const auth = await client.passwordResets.update('reset-token-from-email', {
            password: 'newsecurepassword',
            password_confirmation: 'newsecurepassword',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        description: Password reset token from the email
        schema:
          type: string
      responses:
        '200':
          description: password reset successful
          content:
            application/json:
              example:
                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjdlOGI2Njc5LTBjNzYtNDQ1Mi1hMWMyLWJhY2U0MWNhN2IyMCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzY4NDgyMDAwfQ.grC4diUECUp8b3p6jJBHAZp_MyiSUQwA4rdQLel_zuM
                refresh_token: JNJKeT5cELhdSfb2tWHj3ctp
                user:
                  id: cust_UkLWZg9DAJ
                  email: customer@example.com
                  first_name: Lucas
                  last_name: Stiedemann
                  phone:
                  accepts_email_marketing: false
                  email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                  full_name: Lucas Stiedemann
                  available_store_credit_total: '0.00'
                  display_available_store_credit_total: "$0.00"
                  addresses: []
                  default_billing_address:
                  default_shipping_address:
                  newsletter_subscriber:
                  customer_groups: []
              schema:
                "$ref": "#/components/schemas/AuthResponse"
        '422':
          description: password confirmation mismatch
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Password confirmation doesn't match Password
                  details:
                    password_confirmation:
                    - doesn't match Password
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '401':
          description: missing API key
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/ResetPasswordParams"
        required: true
  "/api/v3/store/carts/{cart_id}/addresses":
    parameters:
    - name: cart_id
      in: path
      required: true
      description: Cart prefixed ID
      schema:
        type: string
    get:
      summary: List addresses this cart may use
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Everything a checkout address step may offer for this cart: the buyer's own address
        book, plus the address book of the company set as the cart's `company_id` — that
        company's own sites and the ones it inherits from the companies above it. Only
        addresses in a country the cart's market sells to are listed.

        Requires a signed-in customer, unlike the rest of the cart endpoints. The response
        is the account's address books rather than the cart's own data, so a guest cart
        token is not accepted here. A guest cart has neither book and would get an empty
        list in any case.

        Each entry carries the `owner` it was filed under — the customer, or the company
        node that owns the site — so a picker can group and label them from one
        response. An inherited site names the node above, not the
        one the cart is for.

        Any address returned here is accepted as `shipping_address_id` or
        `billing_address_id` on the cart, so the picker and the cart cannot disagree.
        Curating either book stays with `/store/customers/me/addresses` and
        `/store/companies/{company_id}/addresses`.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const addresses = await client.carts.addresses.list(
            'cart_abc123',
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[address1_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `address1` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `address2` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `city` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `company` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `country_code` | One of the `CountryCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `first_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `last_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `phone` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `postal_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `state_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `address1`, `address2`, `city`, `company`, `country_code`, `created_at`, `first_name`, `id`, `last_name`, `phone`, `postal_code`, `state_code`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Address
        sortable:
        - address1
        - address2
        - city
        - company
        - country_code
        - created_at
        - first_name
        - id
        - last_name
        - phone
        - postal_code
        - state_code
        - updated_at
      responses:
        '200':
          description: addresses found
          content:
            application/json:
              example:
                data:
                - id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 384 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 385 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_EfhxLZ9ck8
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 386 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                meta:
                  page: 1
                  limit: 25
                  count: 3
                  pages: 1
                  from: 1
                  to: 3
                  in: 3
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Address"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: not authenticated
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '404':
          description: cart not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Cart not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/carts/{cart_id}/po_document":
    parameters:
    - name: cart_id
      in: path
      required: true
      description: Cart prefixed ID
      schema:
        type: string
    post:
      summary: Upload a purchase order document
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Prepares an upload for the buyer's signed purchase order document. Send the
        file's metadata, then `PUT` the bytes to `upload.url` with exactly
        `upload.headers`, and attach the file by sending the returned `signed_id` as
        `po_document_signed_id` on a cart update. Files are stored privately.
        `checksum` is the file's MD5 digest, base64-encoded. Returns 422 when the
        declared size or type is not accepted for a purchase order.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      responses:
        '201':
          description: upload target created
          content:
            application/json:
              example:
                signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--22ede2e3d9cdad77551bf7a67e01face0a96aedc
                filename: purchase-order.pdf
                content_type: application/pdf
                byte_size: 48210
                visibility: private
                expires_at: '2026-01-16T12:00:00.000Z'
                upload:
                  method: PUT
                  url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiIwc3NuNW5kM3RneWtwcWJndXdybGprZjNwbjc4IiwiY29udGVudF90eXBlIjoiYXBwbGljYXRpb24vcGRmIiwiY29udGVudF9sZW5ndGgiOjQ4MjEwLCJjaGVja3N1bSI6IjVXMjhrY2ZxcDlLMGY1djRZN2VyUkE9PSIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl90b2tlbiJ9fQ==--a14c3a39c55e67d9104f389ddda9d8126fb71040
                  headers:
                    Content-Type: application/pdf
              schema:
                "$ref": "#/components/schemas/FileUpload"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreatePoDocumentParams"
        required: true
  "/api/v3/store/carts/{cart_id}/tax_identifier":
    parameters:
    - name: cart_id
      in: path
      required: true
      description: Cart prefixed ID
      schema:
        type: string
    patch:
      summary: Set the cart tax identifier
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Sets the tax registration this cart is taxed against, overriding the one on the
        customer's profile — for a buyer paying through a different company than the one
        on their account. Send both `kind` and `value` every time. The cart's totals are
        recalculated. Returns 201 when the cart had no override yet, 200 when it replaced one.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      responses:
        '201':
          description: tax identifier set
          content:
            application/json:
              example:
                id: txi_UkLWZg9DAJ
                kind: eu_vat
                value: DE100000008
              schema:
                "$ref": "#/components/schemas/TaxIdentifier"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/TaxIdentifierParams"
        required: true
  "/api/v3/store/carts":
    get:
      summary: List active carts
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Returns all active (incomplete) carts for the authenticated user.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const carts = await client.carts.list({
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[complete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `complete`.
      - name: q[incomplete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `incomplete`.
      - name: q[partially_refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `partially_refunded`.
      - name: q[refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `refunded`.
      - name: page
        in: query
        required: false
        description: 'Page number (default: 1)'
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        description: 'Number of results per page (default: 25, max: 100)'
        schema:
          type: integer
      - name: sort
        in: query
        required: false
        description: 'Sort order. Prefix with - for descending. Values: created_at,
          -created_at, updated_at, -updated_at'
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (items, fulfillments,
          payments, discounts, billing_address, shipping_address, gift_card, payment_methods).
          Use "none" to skip associations.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., total,amount_due,item_count).
          id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `channel_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `completed_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `currency` | One of the `CurrencyCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `customer_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `delivery_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `fulfillment_status` | One of `backorder`, `canceled`, `partial`, `unfulfilled`, `fulfilled`, `delivered`, `pending`, `ready`, `shipped` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `item_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `locale` | One of the `LocaleCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `market_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `order_group_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `payment_status` | One of `none`, `authorized`, `partially_paid`, `paid`, `partially_refunded`, `refunded`, `overcharged`, `voided`, `balance_due`, `credit_owed`, `failed`, `void` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `po_number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `status` | One of `draft`, `placed`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `total_quantity` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `channel_id`, `completed_at`, `created_at`, `currency`, `customer_id`, `delivery_total`, `fulfillment_status`, `id`, `item_total`, `locale`, `market_id`, `number`, `order_group_id`, `payment_status`, `po_number`, `seller_id`, `status`, `total`, `total_quantity`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Order
        sortable:
        - channel_id
        - completed_at
        - created_at
        - currency
        - customer_id
        - delivery_total
        - fulfillment_status
        - id
        - item_total
        - locale
        - market_id
        - number
        - order_group_id
        - payment_state
        - payment_status
        - po_number
        - seller_id
        - shipment_state
        - status
        - total
        - total_quantity
        - updated_at
      responses:
        '200':
          description: carts listed
          content:
            application/json:
              example:
                data:
                - id: cart_UkLWZg9DAJ
                  market_id: mkt_UkLWZg9DAJ
                  channel_id: ch_UkLWZg9DAJ
                  preferred_stock_location_id:
                  company_id:
                  company_name:
                  po_number_required: false
                  po_document_filename:
                  po_document_byte_size:
                  number: cart_UkLWZg9DAJ
                  token: ckMf2iQ6r5adLceTPfKVH9BP
                  email:
                  customer_note:
                  po_number:
                  currency: USD
                  locale: en
                  total_quantity: 1
                  warnings: []
                  coupon_code:
                  item_total: '10.00'
                  display_item_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  delivery_total: '0.00'
                  display_delivery_total: "$0.00"
                  fee_total: '0.00'
                  display_fee_total: "$0.00"
                  gift_card_total: '0.00'
                  display_gift_card_total: "$0.00"
                  store_credit_total: '0.00'
                  display_store_credit_total: "$0.00"
                  total: '10.00'
                  display_total: "$10.00"
                  amount_due: '10.00'
                  display_amount_due: "$10.00"
                  covered_by_store_credit: false
                  payments: []
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  current_step: address
                  completed_steps: []
                  requirements:
                  - code: email_required
                    step: address
                    field: email
                    message: Email address is required
                  - code: ship_address_required
                    step: address
                    field: ship_address
                    message: Shipping address is required
                  - code: delivery_method_required
                    step: delivery
                    field: shipping_method
                    message: Select a delivery method for all fulfillments
                  - code: payment_required
                    step: payment
                    field: payment
                    message: Add a payment method
                  order_minimum:
                  order_minimum_shortfall:
                  below_order_minimum: false
                  freight_summary:
                  shipping_eq_billing_address: false
                  discounts: []
                  fees: []
                  items:
                  - id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    seller_id:
                    preorder: false
                    preorder_ships_at:
                    quantity: 1
                    currency: USD
                    name: Product 354715
                    slug: product-354715
                    options_text: ''
                    price: '10.00'
                    display_price: "$10.00"
                    total: '10.00'
                    display_total: "$10.00"
                    adjustment_total: '0.00'
                    display_adjustment_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    pre_tax_amount: '10.00'
                    display_pre_tax_amount: "$10.00"
                    discounted_amount: '10.00'
                    display_discounted_amount: "$10.00"
                    display_compare_at_amount: "$0.00"
                    compare_at_amount:
                    thumbnail_url:
                    option_values: []
                    digital_links: []
                  fulfillments: []
                  billing_address:
                  shipping_address:
                  payment_methods: []
                  gift_card:
                  market:
                    id: mkt_UkLWZg9DAJ
                    name: United States
                    currency: USD
                    default_locale: en
                    tax_inclusive: false
                    default: true
                    country_codes:
                    - US
                    country_isos:
                    - US
                    supported_locales:
                    - en
                - id: cart_gbHJdmfrXB
                  market_id: mkt_UkLWZg9DAJ
                  channel_id: ch_UkLWZg9DAJ
                  preferred_stock_location_id:
                  company_id:
                  company_name:
                  po_number_required: false
                  po_document_filename:
                  po_document_byte_size:
                  number: cart_gbHJdmfrXB
                  token: pvLw1ZWLLQNxh1uvSPUCdSmt
                  email:
                  customer_note:
                  po_number:
                  currency: USD
                  locale: en
                  total_quantity: 1
                  warnings: []
                  coupon_code:
                  item_total: '10.00'
                  display_item_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  delivery_total: '0.00'
                  display_delivery_total: "$0.00"
                  fee_total: '0.00'
                  display_fee_total: "$0.00"
                  gift_card_total: '0.00'
                  display_gift_card_total: "$0.00"
                  store_credit_total: '0.00'
                  display_store_credit_total: "$0.00"
                  total: '10.00'
                  display_total: "$10.00"
                  amount_due: '10.00'
                  display_amount_due: "$10.00"
                  covered_by_store_credit: false
                  payments: []
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  current_step: address
                  completed_steps: []
                  requirements:
                  - code: email_required
                    step: address
                    field: email
                    message: Email address is required
                  - code: ship_address_required
                    step: address
                    field: ship_address
                    message: Shipping address is required
                  - code: delivery_method_required
                    step: delivery
                    field: shipping_method
                    message: Select a delivery method for all fulfillments
                  - code: payment_required
                    step: payment
                    field: payment
                    message: Add a payment method
                  order_minimum:
                  order_minimum_shortfall:
                  below_order_minimum: false
                  freight_summary:
                  shipping_eq_billing_address: false
                  discounts: []
                  fees: []
                  items:
                  - id: li_gbHJdmfrXB
                    variant_id: variant_gbHJdmfrXB
                    seller_id:
                    preorder: false
                    preorder_ships_at:
                    quantity: 1
                    currency: USD
                    name: Product 3552171
                    slug: product-3552171
                    options_text: ''
                    price: '10.00'
                    display_price: "$10.00"
                    total: '10.00'
                    display_total: "$10.00"
                    adjustment_total: '0.00'
                    display_adjustment_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    pre_tax_amount: '10.00'
                    display_pre_tax_amount: "$10.00"
                    discounted_amount: '10.00'
                    display_discounted_amount: "$10.00"
                    display_compare_at_amount: "$0.00"
                    compare_at_amount:
                    thumbnail_url:
                    option_values: []
                    digital_links: []
                  fulfillments: []
                  billing_address:
                  shipping_address:
                  payment_methods: []
                  gift_card:
                  market:
                    id: mkt_UkLWZg9DAJ
                    name: United States
                    currency: USD
                    default_locale: en
                    tax_inclusive: false
                    default: true
                    country_codes:
                    - US
                    country_isos:
                    - US
                    supported_locales:
                    - en
                meta:
                  page: 1
                  limit: 25
                  count: 2
                  pages: 1
                  from: 1
                  to: 2
                  in: 2
                  previous:
                  next:
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    post:
      summary: Create a new cart
      tags:
      - Carts
      security:
      - api_key: []
      description: |
        Creates a new shopping cart. Can be created by guests or authenticated customers.
        Returns a `token` that must be used for guest access to the cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          // Create an empty cart
          const cart = await client.carts.create()

          // Create a cart with items
          const cartWithItems = await client.carts.create({
            items: [{ variant_id: 'variant_abc123', quantity: 2 }],
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer JWT token (optional - for authenticated customers)
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '201':
          description: cart created
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: jBrNbC8FSNyavqebdqu7e3uL
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 0
                warnings: []
                coupon_code:
                item_total: '0.00'
                display_item_total: "$0.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '0.00'
                display_total: "$0.00"
                amount_due: '0.00'
                display_amount_due: "$0.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: line_items_required
                  step: cart
                  field: line_items
                  message: Add at least one item to your cart
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateCartParams"
  "/api/v3/store/carts/{id}":
    get:
      summary: Get a cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Returns a shopping cart by prefixed ID.
        Authorize via x-spree-token header (guest) or JWT Bearer token (authenticated user).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.get('cart_abc123', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (items, fulfillments,
          payments, discounts, billing_address, shipping_address, gift_card, payment_methods).
          Use "none" to skip associations.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., total,amount_due,item_count).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: cart with out-of-stock item removed (warnings returned)
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: HnnryvFFwjfx9P6ykByF4Gg2
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 0
                warnings:
                - code: line_item_removed
                  message: Product 359307 was removed because it was sold out
                  line_item_id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                coupon_code:
                item_total: '0.00'
                display_item_total: "$0.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '17.00'
                display_fee_total: "$17.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '17.00'
                display_total: "$17.00"
                amount_due: '17.00'
                display_amount_due: "$17.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '17.00'
                display_adjustment_total: "$17.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: line_items_required
                  step: cart
                  field: line_items
                  message: Add at least one item to your cart
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees:
                - id: fee_UkLWZg9DAJ
                  label: Gift wrapping
                  kind: gift_wrap
                  line_item_id:
                  fulfillment_id:
                  amount: '5.00'
                  display_amount: "$5.00"
                - id: fee_gbHJdmfrXB
                  label: Import duty
                  kind: duty
                  line_item_id:
                  fulfillment_id:
                  amount: '12.00'
                  display_amount: "$12.00"
                items: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '404':
          description: cart not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Cart not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    patch:
      summary: Update a cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Updates cart info (email, addresses, customer note). When addresses
        change, the order state is reverted to address to ensure shipments are recalculated.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.update(
            'cart_abc123',
            {
              email: 'customer@example.com',
              shipping_address: {
                first_name: 'John',
                last_name: 'Doe',
                address1: '123 Main St',
                city: 'New York',
                postal_code: '10001',
                country_code: 'US',
                state_abbr: 'NY',
              },
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      responses:
        '200':
          description: cart updated
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: PMVmxRAiLqMivU5QgJqfpQMD
                email:
                customer_note: Leave at door
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3603263
                  slug: product-3603263
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateCartParams"
        required: true
    delete:
      summary: Delete a cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Deletes/abandons the cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.carts.delete('cart_abc123', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      responses:
        '204':
          description: cart deleted
  "/api/v3/store/carts/{id}/associate":
    patch:
      summary: Associate guest cart with authenticated user
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Associates a guest cart with the currently authenticated user.
        Requires JWT authentication and possession of the cart's token
        (x-spree-token) — the token authorizes claiming the cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.associate('cart_abc123', {
            token: '<token>',
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: true
        description: Cart token
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      responses:
        '200':
          description: cart associated successfully
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: rrGvkDXx3KcQVwLVk8XiVCVk
                email: steve@tromp.com
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: delivery
                completed_steps:
                - address
                requirements:
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3628992
                  slug: product-3628992
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                  id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 406 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                shipping_address:
                  id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 405 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '401':
          description: unauthorized - JWT required
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '403':
          description: forbidden - cart token missing or does not match
          content:
            application/json:
              example:
                error:
                  code: access_denied
                  message: You are not authorized to access this page.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/carts/{id}/complete":
    post:
      summary: Complete cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Completes the cart and finalizes the purchase. Returns an Order
        (not Cart).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const order = await client.carts.complete('cart_abc123', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      responses:
        '200':
          description: cart completed
          content:
            application/json:
              example:
                id: or_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                withdrawal_period_ends_at:
                within_withdrawal_period: true
                shipping_eq_billing_address: false
                cart_id: cart_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                company_id:
                company_name:
                po_document_filename:
                po_document_byte_size:
                number: R1001
                email: marvel@bruen.com
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                coupon_code:
                fulfillment_status: backorder
                payment_status: paid
                completed_at: '2026-01-15T12:00:00.000Z'
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '10.00'
                display_delivery_total: "$10.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '20.00'
                display_total: "$20.00"
                amount_due: '20.00'
                display_amount_due: "$20.00"
                covered_by_store_credit: false
                payments:
                - id: py_UkLWZg9DAJ
                  payment_method_id: pm_UkLWZg9DAJ
                  response_code: BGS-518d4ef9738e
                  number: R1001-P1
                  status: completed
                  amount: '20.00'
                  display_amount: "$20.00"
                  source_type: credit_card
                  source_id: card_UkLWZg9DAJ
                  source:
                    id: card_UkLWZg9DAJ
                    brand: visa
                    last4: '1111'
                    month: 12
                    year: 2027
                    name: Spree Commerce
                    default: false
                    gateway_payment_profile_id:
                  payment_method:
                    id: pm_UkLWZg9DAJ
                    name: Check 9
                    description:
                    type: check
                    session_required: false
                    source_required: false
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                discounts: []
                fees: []
                items:
                - id: li_gbHJdmfrXB
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3654794
                  slug: product-3654794
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments:
                - id: ful_gbHJdmfrXB
                  number: R1001-F1
                  tracking:
                  tracking_url:
                  pickup_point_data:
                  selected_delivery_rate_id: dr_gbHJdmfrXB
                  unpriced: false
                  cost: '10.00'
                  display_cost: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  status: unfulfilled
                  fulfillment_type: shipping
                  fulfilled_at:
                  delivered_at:
                  items:
                  - item_id: li_gbHJdmfrXB
                    variant_id: variant_UkLWZg9DAJ
                    quantity: 1
                  deliveries: []
                  delivery_method:
                    id: dm_UkLWZg9DAJ
                    name: UPS Ground 185
                    code: UPS_GROUND_203
                    estimated_transit_business_days_min:
                    estimated_transit_business_days_max:
                    digital: false
                    pickup: false
                    pickup_point: false
                  stock_location:
                    id: sloc_UkLWZg9DAJ
                    name: Deangelo Prosacco
                    address1: 1600 Pennsylvania Ave NW
                    city: Washington
                    zipcode: '20500'
                    country_code: US
                    country_name: United States
                    state_code: AL
                    state_text: AL
                    country_iso: US
                    state_abbr: AL
                    pickup_ready_in_minutes:
                    pickup_instructions:
                  delivery_rates:
                  - id: dr_gbHJdmfrXB
                    delivery_method_id: dm_UkLWZg9DAJ
                    name: UPS Ground 185
                    selected: true
                    cost: '10.00'
                    total: '10.00'
                    additional_tax_total: '0.00'
                    included_tax_total: '0.00'
                    tax_total: '0.00'
                    carrier:
                    service_level:
                    estimated_delivery_date:
                    unpriced: false
                    freight_summary:
                    display_cost: "$10.00"
                    display_total: "$10.00"
                    display_additional_tax_total: "$0.00"
                    display_included_tax_total: "$0.00"
                    display_tax_total: "$0.00"
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 185
                      code: UPS_GROUND_203
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                billing_address:
                  id: addr_uw2YK1rnl0
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 412 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                shipping_address:
                  id: addr_OIJLhNcSbf
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 411 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Order"
        '422':
          description: cannot complete
          content:
            application/json:
              example:
                error:
                  code: cart_cannot_complete
                  message: '{code: "validation_failed", errors: [{code: "email_required",
                    step: "address", field: "email", message: "Email address is required"},
                    {code: "delivery_method_required", step: "delivery", field: "delivery_method",
                    message: "Select a delivery method for all fulfillments"}, {code:
                    "payment_required", step: "payment", field: "payment", message:
                    "Add a payment method"}]}'
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/carts/{cart_id}/discount_codes":
    post:
      summary: Apply discount code
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Applies a promotion discount code to the cart. The code is matched case-insensitively.

        For gift cards, use the dedicated `POST /carts/{cart_id}/gift_cards` endpoint instead.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.discountCodes.apply('cart_abc123', 'SAVE10', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '201':
          description: real code kept pending with eligibility warning
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: x1oKZCt9usDGTWQZZQiL1XQ1
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings:
                - code: coupon_code_not_eligible
                  message: This coupon code can't be applied to orders less than $1,000,000.00.
                coupon_code: big50
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3982614
                  slug: product-3982614
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '422':
          description: invalid discount code
          content:
            application/json:
              example:
                error:
                  code: processing_error
                  message: The coupon code you entered doesn't exist. Please try again.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/ApplyDiscountCodeParams"
        required: true
  "/api/v3/store/carts/{cart_id}/discount_codes/{id}":
    delete:
      summary: Remove discount code
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Removes a previously applied discount code from the cart. The ID
        is the discount code string itself.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.discountCodes.remove('cart_abc123', 'SAVE10', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: The discount code string to remove (e.g., SAVE10)
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '200':
          description: discount code removed
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: gvr8TwNVJpxWf27uUHDj5Lj4
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3993461
                  slug: product-3993461
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '422':
          description: discount code not found on cart
          content:
            application/json:
              example:
                error:
                  code: processing_error
                  message: The coupon code you entered doesn't exist. Please try again.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/carts/{cart_id}/fulfillments/{id}":
    patch:
      summary: Select delivery rate for fulfillment
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Selects a delivery rate for a specific fulfillment and auto-advances
        checkout.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.fulfillments.update(
            'cart_abc123',
            'ful_abc123',
            {
              selected_delivery_rate_id: 'dr_abc123',
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Fulfillment ID
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '200':
          description: delivery rate selected, returns updated cart
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: KLLfFWg9T6dGonBb65hHjaZr
                email: donya@jacobsonkunze.biz
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '10.00'
                display_delivery_total: "$10.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '20.00'
                display_total: "$20.00"
                amount_due: '20.00'
                display_amount_due: "$20.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: payment
                completed_steps:
                - address
                - delivery
                requirements:
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 4018182
                  slug: product-4018182
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments:
                - id: ful_UkLWZg9DAJ
                  number: cart_UkLWZg9DAJ-F1
                  tracking:
                  tracking_url:
                  pickup_point_data:
                  selected_delivery_rate_id: dr_gbHJdmfrXB
                  unpriced: false
                  cost: '10.00'
                  display_cost: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  status: unfulfilled
                  fulfillment_type: shipping
                  fulfilled_at:
                  delivered_at:
                  items:
                  - item_id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    quantity: 1
                  deliveries: []
                  delivery_method:
                    id: dm_UkLWZg9DAJ
                    name: UPS Ground 206
                    code: UPS_GROUND_225
                    estimated_transit_business_days_min:
                    estimated_transit_business_days_max:
                    digital: false
                    pickup: false
                    pickup_point: false
                  stock_location:
                    id: sloc_UkLWZg9DAJ
                    name: Monnie O'Keefe
                    address1: 1600 Pennsylvania Ave NW
                    city: Washington
                    zipcode: '20500'
                    country_code: US
                    country_name: United States
                    state_code: AL
                    state_text: AL
                    country_iso: US
                    state_abbr: AL
                    pickup_ready_in_minutes:
                    pickup_instructions:
                  delivery_rates:
                  - id: dr_gbHJdmfrXB
                    delivery_method_id: dm_UkLWZg9DAJ
                    name: UPS Ground 206
                    selected: true
                    cost: '10.00'
                    total: '10.00'
                    additional_tax_total: '0.00'
                    included_tax_total: '0.00'
                    tax_total: '0.00'
                    carrier:
                    service_level:
                    estimated_delivery_date:
                    unpriced: false
                    freight_summary:
                    display_cost: "$10.00"
                    display_total: "$10.00"
                    display_additional_tax_total: "$0.00"
                    display_included_tax_total: "$0.00"
                    display_tax_total: "$0.00"
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 206
                      code: UPS_GROUND_225
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                billing_address:
                shipping_address:
                  id: addr_EfhxLZ9ck8
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 531 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '404':
          description: delivery rate not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Delivery rate not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateFulfillmentParams"
        required: true
  "/api/v3/store/carts/{cart_id}/gift_cards":
    post:
      summary: Apply gift card
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Applies a gift card to the cart. Gift cards are treated as a payment method, not a discount —
        the cart `total` remains unchanged while `amount_due` is reduced.

        For promotion discount codes, use the `POST /carts/{cart_id}/discount_codes` endpoint instead.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.giftCards.apply('cart_abc123', 'GC-ABCD-1234', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '201':
          description: gift card applied
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: nZjAPYSKrNaHf2ZVT6eZfNJV
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '10.00'
                display_gift_card_total: "$10.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '0.00'
                display_amount_due: "$0.00"
                covered_by_store_credit: true
                payments:
                - id: py_UkLWZg9DAJ
                  payment_method_id: pm_UkLWZg9DAJ
                  response_code: 1-SC-20260115120000000000
                  number: cart_UkLWZg9DAJ-P1
                  status: checkout
                  amount: '10.00'
                  display_amount: "$10.00"
                  source_type: store_credit
                  source_id: credit_UkLWZg9DAJ
                  source:
                    id: credit_UkLWZg9DAJ
                    amount: '10.00'
                    amount_used: '0.00'
                    amount_remaining: '10.00'
                    display_amount: "$10.00"
                    display_amount_used: "$0.00"
                    display_amount_remaining: "$10.00"
                    currency: USD
                  payment_method:
                    id: pm_UkLWZg9DAJ
                    name: Store Credit
                    description:
                    type: store_credit
                    session_required: false
                    source_required: true
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 4035702
                  slug: product-4035702
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                  id: gc_UkLWZg9DAJ
                  code: GIFTCODE1
                  status: active
                  currency: USD
                  amount: '50.00'
                  amount_used: '10.00'
                  amount_authorized: '0.00'
                  amount_remaining: '40.00'
                  display_amount: "$50.00"
                  display_amount_used: "$10.00"
                  display_amount_remaining: "$40.00"
                  expires_at:
                  redeemed_at:
                  expired: false
                  active: true
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '404':
          description: gift card not found
          content:
            application/json:
              example:
                error:
                  code: gift_card_not_found
                  message: The Gift Card was not found.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '422':
          description: gift card already redeemed
          content:
            application/json:
              example:
                error:
                  code: gift_card_already_redeemed
                  message: The Gift Card has already been redeemed.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/ApplyGiftCardParams"
        required: true
  "/api/v3/store/carts/{cart_id}/gift_cards/{id}":
    delete:
      summary: Remove gift card
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Removes a previously applied gift card from the cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.giftCards.remove('cart_abc123', 'gc_abc123', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Gift card prefixed ID (e.g., gc_abc123)
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '200':
          description: gift card removed
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: Wgq8NrLX3TUQLroJRYWFdQd5
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments:
                - id: py_UkLWZg9DAJ
                  payment_method_id: pm_UkLWZg9DAJ
                  response_code: 1-SC-20260115120000000000
                  number: cart_UkLWZg9DAJ-P1
                  status: invalid
                  amount: '10.00'
                  display_amount: "$10.00"
                  source_type: store_credit
                  source_id: credit_UkLWZg9DAJ
                  source:
                    id: credit_UkLWZg9DAJ
                    amount: '10.00'
                    amount_used: '0.00'
                    amount_remaining: '10.00'
                    display_amount: "$10.00"
                    display_amount_used: "$0.00"
                    display_amount_remaining: "$10.00"
                    currency: USD
                  payment_method:
                    id: pm_UkLWZg9DAJ
                    name: Store Credit
                    description:
                    type: store_credit
                    session_required: false
                    source_required: true
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 4079569
                  slug: product-4079569
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
  "/api/v3/store/carts/{cart_id}/items":
    post:
      summary: Add item to cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Adds a variant to the cart. Creates a new line item or increases
        quantity if variant already in cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.items.create(
            'cart_abc123',
            {
              variant_id: 'variant_abc123',
              quantity: 2,
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '201':
          description: item added with metadata
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: d12LXVnL3KtzGjXePqRawnPc
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 2
                warnings:
                - code: delivery_unavailable
                  message: Product 41063 cannot be delivered to the selected address
                  line_item_id: li_UkLWZg9DAJ
                - code: delivery_unavailable
                  message: Product 411298 cannot be delivered to the selected address
                  line_item_id: li_gbHJdmfrXB
                coupon_code:
                item_total: '29.99'
                display_item_total: "$29.99"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '29.99'
                display_total: "$29.99"
                amount_due: '29.99'
                display_amount_due: "$29.99"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 41063
                  slug: product-41063
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                - id: li_gbHJdmfrXB
                  variant_id: variant_gbHJdmfrXB
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 411298
                  slug: product-411298
                  options_text: ''
                  price: '19.99'
                  display_price: "$19.99"
                  total: '19.99'
                  display_total: "$19.99"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '19.99'
                  display_pre_tax_amount: "$19.99"
                  discounted_amount: '19.99'
                  display_discounted_amount: "$19.99"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '404':
          description: variant not found
          content:
            application/json:
              example:
                error:
                  code: variant_not_found
                  message: Variant not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '422':
          description: rejected by a store rule
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Quantity You can order at most 10 of this item.
                  details:
                    quantity:
                    - You can order at most 10 of this item.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/AddLineItemParams"
        required: true
  "/api/v3/store/carts/{cart_id}/items/{id}":
    patch:
      summary: Update line item quantity
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Updates the quantity of a line item in the cart
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.items.update(
            'cart_abc123',
            'li_abc123',
            {
              quantity: 5,
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Line item ID
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: quantity change rejected, reported in warnings
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: Yq5XuZqq7KS7y7n2dMsChnZM
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings:
                - code: purchase_limit_exceeded
                  message: Quantity You can order at most 10 of this item.
                  variant_id: variant_UkLWZg9DAJ
                  item_index: 0
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 4179165
                  slug: product-4179165
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateLineItemParams"
        required: true
    delete:
      summary: Remove line item from cart
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Removes a line item from the cart
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.items.delete('cart_abc123', 'li_abc123', {
            spreeToken: '<cart-token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: line item removed, returns updated cart
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: arTvbVzmU1krWKLbRnWDZ3cL
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 0
                warnings: []
                coupon_code:
                item_total: '0.00'
                display_item_total: "$0.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '0.00'
                display_total: "$0.00"
                amount_due: '0.00'
                display_amount_due: "$0.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: line_items_required
                  step: cart
                  field: line_items
                  message: Add at least one item to your cart
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '404':
          description: line item not found
          content:
            application/json:
              example:
                error:
                  code: line_item_not_found
                  message: Line item not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/carts/{cart_id}/payment_sessions":
    post:
      summary: Create payment session
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Creates a new payment session for the cart. Delegates to the payment
        gateway to initialize a provider-specific session (e.g. Stripe PaymentIntent,
        Adyen session, PayPal order).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.carts.paymentSessions.create(
            'cart_abc123',
            {
              payment_method_id: 'pm_abc123',
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '201':
          description: payment session created
          content:
            application/json:
              example:
                id: ps_gbHJdmfrXB
                status: pending
                currency: USD
                external_id: bogus_208a8eb2883f955fd5c07616
                external_data:
                  client_secret: bogus_secret_a8b3afe691c933c1
                customer_external_id:
                expires_at:
                amount: '10.00'
                payment_method_id: pm_UkLWZg9DAJ
                order_id: cart_UkLWZg9DAJ
                cart_id: cart_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 235
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSession"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreatePaymentSessionParams"
        required: true
  "/api/v3/store/carts/{cart_id}/payment_sessions/{id}":
    parameters:
    - name: x-spree-api-key
      in: header
      required: true
      schema:
        type: string
    - name: Authorization
      in: header
      required: false
      description: Bearer token for authenticated customers
      schema:
        type: string
    - name: cart_id
      in: path
      required: true
      description: Cart prefixed ID
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Payment session ID
      schema:
        type: string
    - name: x-spree-token
      in: header
      required: false
      description: Order token for guest access
      schema:
        type: string
    get:
      summary: Get payment session
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a single payment session with its current status and provider
        data.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.carts.paymentSessions.get('cart_abc123', 'ps_abc123', {
            spreeToken: '<cart-token>',
          })
      responses:
        '200':
          description: payment session found
          content:
            application/json:
              example:
                id: ps_UkLWZg9DAJ
                status: pending
                currency: USD
                external_id: bogus_96d0ebf0a4300304c930f3c0
                external_data:
                  client_secret: secret_123
                customer_external_id:
                expires_at:
                amount: '10.00'
                payment_method_id: pm_UkLWZg9DAJ
                order_id: cart_UkLWZg9DAJ
                cart_id: cart_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 236
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSession"
        '404':
          description: payment session not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Payment session not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    patch:
      summary: Update payment session
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Updates a payment session. Delegates to the payment gateway to
        sync changes with the provider.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.carts.paymentSessions.update(
            'cart_abc123',
            'ps_abc123',
            {
              amount: '50.00',
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters: []
      responses:
        '200':
          description: payment session updated
          content:
            application/json:
              example:
                id: ps_UkLWZg9DAJ
                status: pending
                currency: USD
                external_id: bogus_8a53bedc6c12205d0e31f231
                external_data:
                  client_secret: secret_123
                customer_external_id:
                expires_at:
                amount: '50.00'
                payment_method_id: pm_UkLWZg9DAJ
                order_id: cart_UkLWZg9DAJ
                cart_id: cart_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 238
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSession"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdatePaymentSessionParams"
        required: true
  "/api/v3/store/carts/{cart_id}/payment_sessions/{id}/complete":
    parameters:
    - name: x-spree-api-key
      in: header
      required: true
      schema:
        type: string
    - name: Authorization
      in: header
      required: false
      description: Bearer token for authenticated customers
      schema:
        type: string
    - name: cart_id
      in: path
      required: true
      description: Cart prefixed ID
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Payment session ID
      schema:
        type: string
    - name: x-spree-token
      in: header
      required: false
      description: Order token for guest access
      schema:
        type: string
    patch:
      summary: Complete payment session
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Completes a payment session by confirming the payment with the
        provider. This triggers payment capture/authorization and order completion.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.carts.paymentSessions.complete(
            'cart_abc123',
            'ps_abc123',
            {
              session_result: 'success',
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '200':
          description: payment session completed
          content:
            application/json:
              example:
                id: ps_UkLWZg9DAJ
                status: completed
                currency: USD
                external_id: bogus_f6de6a6c7dddf8f63c45a3f0
                external_data:
                  client_secret: secret_123
                customer_external_id:
                expires_at:
                amount: '10.00'
                payment_method_id: pm_UkLWZg9DAJ
                order_id: cart_UkLWZg9DAJ
                cart_id: cart_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 239
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSession"
        '404':
          description: payment session not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Payment session not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CompletePaymentSessionParams"
        required: true
  "/api/v3/store/carts/{cart_id}/payments":
    post:
      summary: Create payment
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Creates a payment for a non-session payment method (e.g. Check,
        Cash on Delivery, Bank Transfer). For payment methods that require a session
        (e.g. Stripe, PayPal), use the payment sessions endpoint instead.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const payment = await client.carts.payments.create(
            'cart_abc123',
            {
              payment_method_id: 'pm_abc123',
            },
            {
              spreeToken: '<cart-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '201':
          description: payment created
          content:
            application/json:
              example:
                id: py_UkLWZg9DAJ
                payment_method_id: pm_UkLWZg9DAJ
                response_code:
                number: cart_UkLWZg9DAJ-P1
                status: checkout
                amount: '10.00'
                display_amount: "$10.00"
                source_type:
                source_id:
                source:
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Check 10
                  description:
                  type: check
                  session_required: false
                  source_required: false
              schema:
                "$ref": "#/components/schemas/Payment"
        '422':
          description: session-based payment method
          content:
            application/json:
              example:
                error:
                  code: payment_session_required
                  message: This payment method requires a payment session. Use the
                    payment sessions endpoint instead.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreatePaymentParams"
        required: true
  "/api/v3/store/carts/{cart_id}/store_credits":
    post:
      summary: Apply store credit
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Applies store credit to the cart during checkout.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.storeCredits.apply('cart_abc123', '10.00', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID (e.g., cart_abc123)
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      - name: Idempotency-Key
        in: header
        required: false
        description: Unique key for request idempotency.
        schema:
          type: string
      responses:
        '200':
          description: store credit applied
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: acfBZtWemHae74Y3g18LQg1f
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '10.00'
                display_store_credit_total: "-$10.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '0.00'
                display_amount_due: "$0.00"
                covered_by_store_credit: true
                payments:
                - id: py_UkLWZg9DAJ
                  payment_method_id: pm_UkLWZg9DAJ
                  response_code: 1-SC-20260115120000000000
                  number: cart_UkLWZg9DAJ-P1
                  status: checkout
                  amount: '10.00'
                  display_amount: "$10.00"
                  source_type: store_credit
                  source_id: credit_UkLWZg9DAJ
                  source:
                    id: credit_UkLWZg9DAJ
                    amount: '50.00'
                    amount_used: '0.00'
                    amount_remaining: '50.00'
                    display_amount: "$50.00"
                    display_amount_used: "$0.00"
                    display_amount_remaining: "$50.00"
                    currency: USD
                  payment_method:
                    id: pm_UkLWZg9DAJ
                    name: Store Credit 5
                    description: Store Credit
                    type: store_credit
                    session_required: false
                    source_required: true
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 4829789
                  slug: product-4829789
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
        '422':
          description: no store credit available
          content:
            application/json:
              example:
                error:
                  code: processing_error
                  message: User does not have any Store Credits available
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/ApplyStoreCreditParams"
        required: true
    delete:
      summary: Remove store credit
      tags:
      - Carts
      security:
      - api_key: []
        bearer_auth: []
      description: Removes store credit from the cart.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cart = await client.carts.storeCredits.remove('cart_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: cart_id
        in: path
        required: true
        description: Cart prefixed ID
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: store credit removed
          content:
            application/json:
              example:
                id: cart_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                channel_id: ch_UkLWZg9DAJ
                preferred_stock_location_id:
                company_id:
                company_name:
                po_number_required: false
                po_document_filename:
                po_document_byte_size:
                number: cart_UkLWZg9DAJ
                token: BHWevnp2PQxC1jSWU3ZFLejT
                email:
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                warnings: []
                coupon_code:
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '0.00'
                display_delivery_total: "$0.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '10.00'
                display_total: "$10.00"
                amount_due: '10.00'
                display_amount_due: "$10.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                current_step: address
                completed_steps: []
                requirements:
                - code: email_required
                  step: address
                  field: email
                  message: Email address is required
                - code: delivery_method_required
                  step: delivery
                  field: shipping_method
                  message: Select a delivery method for all fulfillments
                - code: payment_required
                  step: payment
                  field: payment
                  message: Add a payment method
                order_minimum:
                order_minimum_shortfall:
                below_order_minimum: false
                freight_summary:
                shipping_eq_billing_address: false
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 484179
                  slug: product-484179
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments: []
                billing_address:
                shipping_address:
                payment_methods: []
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Cart"
  "/api/v3/store/channel":
    get:
      summary: Get the current channel
      tags:
      - Channel
      security:
      - api_key: []
      description: Returns the channel this request resolved to (key binding → X-Spree-Channel
        header → store default), including the resolved storefront access posture.
        Reachable before authentication so gated storefronts can render a sign-in
        wall.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const channel = await client.channel.get()

          if (channel.storefront_access === 'login_required') {
            // render a sign-in wall before any catalog UI
          }
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: X-Spree-Channel
        in: header
        required: false
        description: Channel code or prefixed ID to resolve. When the API key is channel-bound,
          a value naming a different channel is rejected with 422 channel_mismatch;
          a value matching the bound channel is accepted.
        schema:
          type: string
      responses:
        '200':
          description: channel found
          content:
            application/json:
              example:
                id: ch_gbHJdmfrXB
                name: Wholesale
                code: wholesale
                active: true
                default: false
                storefront_access: login_required
                guest_checkout: false
              schema:
                "$ref": "#/components/schemas/Channel"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/account/companies":
    get:
      summary: List my company memberships
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Returns the authenticated customer's company memberships, each with the node it
        is held on and the path of nodes above it. Standing covers the node and every
        node below it, so a membership on a parent authorizes buying for its divisions.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          // The buyer's memberships, each carrying its node and the path above it.
          const { data: memberships } = await client.account.companies({ token: '<token>' })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[created_at_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: CompanyMembership
        sortable:
        - created_at
        - id
        - updated_at
      responses:
        '200':
          description: memberships listed
          content:
            application/json:
              example:
                data:
                - id: cmem_UkLWZg9DAJ
                  company_id: comp_UkLWZg9DAJ
                  customer_id: cust_UkLWZg9DAJ
                  email: pasty.koepp@farrell.name
                  company:
                    id: comp_UkLWZg9DAJ
                    name: Acme Industrial
                    kind: company
                    po_number_required: false
                    parent_id:
                    ancestors: []
        '401':
          description: not authenticated
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
  "/api/v3/store/companies/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    get:
      summary: Get a company node
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Returns one node of the buyer's organization. Requires standing — a membership on
        the node or on one of its ancestors; any other node is not found rather than
        refused, so its existence is not disclosed.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const company = await client.companies.get('comp_86Rf07xd4z', { token: '<token>' })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: company found
          content:
            application/json:
              example:
                id: comp_UkLWZg9DAJ
                name: Acme Industrial
                kind: company
                po_number_required: false
                parent_id:
                ancestors: []
        '404':
          description: no standing over this node
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Company not found
    patch:
      summary: Update a company node
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: Renames the node. Structure — the parent and the kind — is managed
        by the merchant, not by buyers.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: company updated
          content:
            application/json:
              example:
                id: comp_UkLWZg9DAJ
                name: Acme Industrial Group
                kind: company
                po_number_required: false
                parent_id:
                ancestors: []
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateCompanyParams"
        required: true
  "/api/v3/store/companies/{company_id}/members":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    get:
      summary: List company members
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: The people with standing over this node. Within a company every
        member may read and manage the directory.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[created_at_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: CompanyMembership
        sortable:
        - created_at
        - id
        - updated_at
      responses:
        '200':
          description: members listed
          content:
            application/json:
              example:
                data:
                - id: cmem_UkLWZg9DAJ
                  company_id: comp_UkLWZg9DAJ
                  customer_id: cust_UkLWZg9DAJ
                  email: su_kuvalis@ward.biz
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
    post:
      summary: Add a member by email
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Invites a person to the node by email (a `cinv_...` id) and sends the invite email.
        This is an invitation even when the email already belongs to a customer: they join
        by accepting the emailed token, which proves they own the address and agree to join.
        The response is the same either way, so it does not reveal whether the email has an
        account.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          // Always an emailed invitation (cinv_…), even for an existing customer.
          const invitation = await client.companies.members.create(
            'comp_86Rf07xd4z',
            { customer_email: 'colleague@acme.test' },
            { token: '<token>' },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: invitation sent
          content:
            application/json:
              example:
                id: cinv_UkLWZg9DAJ
                email: colleague@acme.test
                expires_at: '2026-02-14T12:00:00.000Z'
                company_id: comp_UkLWZg9DAJ
                status: pending
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/AddCompanyMemberParams"
        required: true
  "/api/v3/store/companies/{company_id}/invitations":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    get:
      summary: List pending company invitations
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: The invitations to this node that nobody has accepted or revoked
        yet. Requires standing over the node.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[email_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `email` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `email`, `id`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: CompanyInvitation
        sortable:
        - created_at
        - email
        - id
        - updated_at
      responses:
        '200':
          description: invitations listed
          content:
            application/json:
              example:
                data:
                - id: cinv_UkLWZg9DAJ
                  email: colleague@acme.test
                  expires_at: '2026-02-14T12:00:00.000Z'
                  company_id: comp_UkLWZg9DAJ
                  status: pending
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/CompanyInvitation"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
  "/api/v3/store/companies/{company_id}/addresses":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    get:
      summary: List the company address book
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: The labeled ship-to and bill-to sites this node owns. A node with
        no default of its own falls back to its nearest ancestor when prefilling checkout.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[address1_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `address1` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `address2` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `city` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `company` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `country_code` | One of the `CountryCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `first_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `last_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `phone` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `postal_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `state_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `address1`, `address2`, `city`, `company`, `country_code`, `created_at`, `first_name`, `id`, `last_name`, `phone`, `postal_code`, `state_code`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Address
        sortable:
        - address1
        - address2
        - city
        - company
        - country_code
        - created_at
        - first_name
        - id
        - last_name
        - phone
        - postal_code
        - state_code
        - updated_at
      responses:
        '200':
          description: addresses listed
          content:
            application/json:
              example:
                data:
                - id: addr_EfhxLZ9ck8
                  label: Headquarters
                  first_name:
                  last_name:
                  full_name: ''
                  address1: 441 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: comp_UkLWZg9DAJ
                    type: company
                    name: Acme Industrial
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
    post:
      summary: Add an address book entry
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: 'Adds a labeled site to the node. Pass `default_billing: true`
        or `default_shipping: true` to make it the default of that kind.'
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: address book entry created
          content:
            application/json:
              example:
                id: addr_VqXmZF31wY
                label: Northern Warehouse
                first_name: Ada
                last_name: Lovelace
                full_name: Ada Lovelace
                address1: 350 Fifth Avenue
                address2:
                postal_code: '10118'
                city: New York
                phone: "+12125551234"
                company: Acme Industrial
                country_name: United States
                country_code: US
                state_text: NY
                state_code: NY
                quick_checkout: false
                is_default_billing: false
                is_default_shipping: true
                state_abbr: NY
                country_iso: US
                state_name: New York
                owner:
                  id: comp_UkLWZg9DAJ
                  type: company
                  name: Acme Industrial
              schema:
                "$ref": "#/components/schemas/Address"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CompanyAddressCreateParams"
        required: true
  "/api/v3/store/companies/{company_id}/addresses/{id}":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Address ID (addr_...)
      schema:
        type: string
    patch:
      summary: Update an address book entry
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: Renames a site or moves the default ship-to or bill-to flag to
        it. Only one entry per node holds each default.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: address book entry updated
          content:
            application/json:
              example:
                id: addr_EfhxLZ9ck8
                label: Northern Warehouse
                first_name:
                last_name:
                full_name: ''
                address1: 447 Lovely Street
                address2: Northwest
                postal_code: '10118'
                city: New York
                phone: 555-555-0199
                company: Company
                country_name: United States
                country_code: US
                state_text: NY
                state_code: NY
                quick_checkout: false
                is_default_billing: false
                is_default_shipping: true
                state_abbr: NY
                country_iso: US
                state_name: New York
                owner:
                  id: comp_UkLWZg9DAJ
                  type: company
                  name: Acme Industrial
              schema:
                "$ref": "#/components/schemas/Address"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CompanyAddressUpdateParams"
        required: true
    delete:
      summary: Remove an address book entry
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: Takes the site out of the address book. Orders already placed to
        it keep their own copy of the address.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '204':
          description: address book entry removed
  "/api/v3/store/companies/{company_id}/invitations/{id}":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Invitation ID (cinv_...)
      schema:
        type: string
    delete:
      summary: Revoke an invitation
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: Withdraws a pending invitation, spending its token. Any member
        with standing over the node may revoke.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '204':
          description: invitation revoked
  "/api/v3/store/companies/{company_id}/orders":
    parameters:
    - name: company_id
      in: path
      required: true
      description: Company node ID (comp_...)
      schema:
        type: string
    get:
      summary: List the company purchases
      tags:
      - Companies
      security:
      - api_key: []
        bearer_auth: []
      description: Completed orders placed for this node and every node below it,
        so a parent sees what its divisions bought.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[complete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `complete`.
      - name: q[incomplete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `incomplete`.
      - name: q[partially_refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `partially_refunded`.
      - name: q[refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `refunded`.
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `channel_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `completed_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `currency` | One of the `CurrencyCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `customer_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `delivery_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `fulfillment_status` | One of `backorder`, `canceled`, `partial`, `unfulfilled`, `fulfilled`, `delivered`, `pending`, `ready`, `shipped` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `item_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `locale` | One of the `LocaleCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `market_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `order_group_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `payment_status` | One of `none`, `authorized`, `partially_paid`, `paid`, `partially_refunded`, `refunded`, `overcharged`, `voided`, `balance_due`, `credit_owed`, `failed`, `void` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `po_number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `status` | One of `draft`, `placed`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `total_quantity` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `channel_id`, `completed_at`, `created_at`, `currency`, `customer_id`, `delivery_total`, `fulfillment_status`, `id`, `item_total`, `locale`, `market_id`, `number`, `order_group_id`, `payment_status`, `po_number`, `seller_id`, `status`, `total`, `total_quantity`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Order
        sortable:
        - channel_id
        - completed_at
        - created_at
        - currency
        - customer_id
        - delivery_total
        - fulfillment_status
        - id
        - item_total
        - locale
        - market_id
        - number
        - order_group_id
        - payment_state
        - payment_status
        - po_number
        - seller_id
        - shipment_state
        - status
        - total
        - total_quantity
        - updated_at
      responses:
        '200':
          description: orders listed
          content:
            application/json:
              example:
                data:
                - id: or_UkLWZg9DAJ
                  market_id: mkt_UkLWZg9DAJ
                  withdrawal_period_ends_at:
                  within_withdrawal_period: true
                  shipping_eq_billing_address: false
                  cart_id:
                  channel_id: ch_UkLWZg9DAJ
                  company_id: comp_UkLWZg9DAJ
                  company_name: Acme Industrial
                  po_document_filename:
                  po_document_byte_size:
                  number: R1001
                  email: chanell_langosh@schamberger.info
                  customer_note:
                  po_number:
                  currency: USD
                  locale: en
                  total_quantity: 1
                  coupon_code:
                  fulfillment_status:
                  payment_status:
                  completed_at: '2026-01-15T12:00:00.000Z'
                  item_total: '10.00'
                  display_item_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  delivery_total: '100.00'
                  display_delivery_total: "$100.00"
                  fee_total: '0.00'
                  display_fee_total: "$0.00"
                  gift_card_total: '0.00'
                  display_gift_card_total: "$0.00"
                  store_credit_total: '0.00'
                  display_store_credit_total: "$0.00"
                  total: '110.00'
                  display_total: "$110.00"
                  amount_due: '110.00'
                  display_amount_due: "$110.00"
                  covered_by_store_credit: false
                  payments: []
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  discounts: []
                  fees: []
                  items:
                  - id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    seller_id:
                    preorder: false
                    preorder_ships_at:
                    quantity: 1
                    currency: USD
                    name: Product 3845649
                    slug: product-3845649
                    options_text: ''
                    price: '10.00'
                    display_price: "$10.00"
                    total: '10.00'
                    display_total: "$10.00"
                    adjustment_total: '0.00'
                    display_adjustment_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    pre_tax_amount: '10.00'
                    display_pre_tax_amount: "$10.00"
                    discounted_amount: '10.00'
                    display_discounted_amount: "$10.00"
                    display_compare_at_amount: "$0.00"
                    compare_at_amount:
                    thumbnail_url:
                    option_values: []
                  fulfillments:
                  - id: ful_UkLWZg9DAJ
                    number: R1001-F1
                    tracking: U10000
                    tracking_url:
                    pickup_point_data:
                    selected_delivery_rate_id: dr_gbHJdmfrXB
                    unpriced: false
                    cost: '100.00'
                    display_cost: "$100.00"
                    total: '100.00'
                    display_total: "$100.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    tax_total: '0.00'
                    display_tax_total: "$0.00"
                    status: unfulfilled
                    fulfillment_type: shipping
                    fulfilled_at:
                    delivered_at:
                    items:
                    - item_id: li_UkLWZg9DAJ
                      variant_id: variant_UkLWZg9DAJ
                      quantity: 1
                    deliveries:
                    - id: dlv_UkLWZg9DAJ
                      tracking_number: U10000
                      carrier:
                      carrier_name:
                      service:
                      status: pending
                      tracking_url:
                      estimated_delivery_at:
                      delivered_at:
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 189
                      code: UPS_GROUND_207
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                    stock_location:
                      id: sloc_UkLWZg9DAJ
                      name: Kali Pacocha
                      address1: 1600 Pennsylvania Ave NW
                      city: Washington
                      zipcode: '20500'
                      country_code: US
                      country_name: United States
                      state_code: AL
                      state_text: AL
                      country_iso: US
                      state_abbr: AL
                      pickup_ready_in_minutes:
                      pickup_instructions:
                    delivery_rates:
                    - id: dr_gbHJdmfrXB
                      delivery_method_id: dm_UkLWZg9DAJ
                      name: UPS Ground 189
                      selected: true
                      cost: '10.00'
                      total: '10.00'
                      additional_tax_total: '0.00'
                      included_tax_total: '0.00'
                      tax_total: '0.00'
                      carrier:
                      service_level:
                      estimated_delivery_date:
                      unpriced: false
                      freight_summary:
                      display_cost: "$10.00"
                      display_total: "$10.00"
                      display_additional_tax_total: "$0.00"
                      display_included_tax_total: "$0.00"
                      display_tax_total: "$0.00"
                      delivery_method:
                        id: dm_UkLWZg9DAJ
                        name: UPS Ground 189
                        code: UPS_GROUND_207
                        estimated_transit_business_days_min:
                        estimated_transit_business_days_max:
                        digital: false
                        pickup: false
                        pickup_point: false
                  billing_address:
                    id: addr_EfhxLZ9ck8
                    label:
                    first_name: John
                    last_name: Doe
                    full_name: John Doe
                    address1: 455 Lovely Street
                    address2: Northwest
                    postal_code: '10118'
                    city: New York
                    phone: 555-555-0199
                    company: Company
                    country_name: United States
                    country_code: US
                    state_text: NY
                    state_code: NY
                    quick_checkout: false
                    is_default_billing: false
                    is_default_shipping: false
                    state_abbr: NY
                    country_iso: US
                    state_name: New York
                    owner:
                  shipping_address:
                    id: addr_VqXmZF31wY
                    label:
                    first_name: John
                    last_name: Doe
                    full_name: John Doe
                    address1: 456 Lovely Street
                    address2: Northwest
                    postal_code: '10118'
                    city: New York
                    phone: 555-555-0199
                    company: Company
                    country_name: United States
                    country_code: US
                    state_text: NY
                    state_code: NY
                    quick_checkout: false
                    is_default_billing: false
                    is_default_shipping: false
                    state_abbr: NY
                    country_iso: US
                    state_name: New York
                    owner:
                  gift_card:
                  market:
                    id: mkt_UkLWZg9DAJ
                    name: United States
                    currency: USD
                    default_locale: en
                    tax_inclusive: false
                    default: true
                    country_codes:
                    - US
                    country_isos:
                    - US
                    supported_locales:
                    - en
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
  "/api/v3/store/company_invitations/{token}":
    parameters:
    - name: token
      in: path
      required: true
      description: Plaintext invitation token from the invite email
      schema:
        type: string
    get:
      summary: Look up an invitation
      tags:
      - Companies
      security:
      - api_key: []
      description: |
        Shows what is being joined, so the acceptance page can render before the invitee
        has an account. Deliberately unauthenticated — the token from the email is the
        credential. Spent, revoked and expired tokens are not found.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: invitation found
          content:
            application/json:
              example:
                id: cinv_UkLWZg9DAJ
                email: new@acme.test
                expires_at: '2026-02-14T12:00:00.000Z'
                company_id: comp_UkLWZg9DAJ
                status: pending
                company_name: Acme Industrial
                store_name: Spree Test Store
        '404':
          description: token spent, revoked or expired
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Company invitation not found
  "/api/v3/store/company_invitations/{token}/accept":
    parameters:
    - name: token
      in: path
      required: true
      description: Plaintext invitation token from the invite email
      schema:
        type: string
    post:
      summary: Accept an invitation
      tags:
      - Companies
      security:
      - api_key: []
      description: |
        Turns the invitation into a membership. Send a registration payload to create the
        account — it is always created with the invited email — or call it authenticated as
        the customer who owns that email to bind the invitation to the existing account.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          // Unauthenticated: the token from the invite email is the credential, and the
          // registration payload creates the account with the invited address.
          const membership = await client.companyInvitations.accept('<invitation-token>', {
            first_name: 'Ada',
            password: 'a-strong-password',
            password_confirmation: 'a-strong-password',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: membership created
          content:
            application/json:
              example:
                id: cmem_UkLWZg9DAJ
                company_id: comp_UkLWZg9DAJ
                customer_id: cust_UkLWZg9DAJ
                email: new@acme.test
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/AcceptCompanyInvitationParams"
        required: true
  "/api/v3/store/customers/me/addresses":
    get:
      summary: List customer addresses
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns all addresses in the customer address book
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const addresses = await client.customer.addresses.list(
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[address1_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `address1` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `address2` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `city` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `company` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `country_code` | One of the `CountryCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `first_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `last_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `phone` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `postal_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `state_code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `address1`, `address2`, `city`, `company`, `country_code`, `created_at`, `first_name`, `id`, `last_name`, `phone`, `postal_code`, `state_code`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Address
        sortable:
        - address1
        - address2
        - city
        - company
        - country_code
        - created_at
        - first_name
        - id
        - last_name
        - phone
        - postal_code
        - state_code
        - updated_at
      responses:
        '200':
          description: addresses found
          content:
            application/json:
              example:
                data:
                - id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 357 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 358 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_EfhxLZ9ck8
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 359 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                meta:
                  page: 1
                  limit: 25
                  count: 3
                  pages: 1
                  from: 1
                  to: 3
                  in: 3
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Address"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    post:
      summary: Create an address
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Adds a new address to the customer address book
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const address = await client.customer.addresses.create(
            {
              first_name: 'John',
              last_name: 'Doe',
              address1: '123 Main St',
              city: 'New York',
              postal_code: '10001',
              country_code: 'US',
              state_abbr: 'NY',
              phone: '+1 555 123 4567',
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: address created
          content:
            application/json:
              example:
                id: addr_VqXmZF31wY
                label:
                first_name: John
                last_name: Doe
                full_name: John Doe
                address1: 123 Main St
                address2:
                postal_code: '10001'
                city: New York
                phone: "+1 555 123 4567"
                company:
                country_name: United States
                country_code: US
                state_text: NY
                state_code: NY
                quick_checkout: false
                is_default_billing: false
                is_default_shipping: false
                state_abbr: NY
                country_iso: US
                state_name: New York
                owner:
                  id: cust_UkLWZg9DAJ
                  type: customer
                  name:
              schema:
                "$ref": "#/components/schemas/Address"
        '422':
          description: validation error
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: First Name can't be blank, Last Name can't be blank, Address
                    can't be blank, City can't be blank, Country can't be blank, and
                    Zip Code can't be blank
                  details:
                    first_name:
                    - can't be blank
                    last_name:
                    - can't be blank
                    address1:
                    - can't be blank
                    city:
                    - can't be blank
                    country:
                    - can't be blank
                    postal_code:
                    - can't be blank
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/AddressCreateParams"
        required: true
  "/api/v3/store/customers/me/addresses/{id}":
    get:
      summary: Get an address
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const address = await client.customer.addresses.get('addr_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: address found
          content:
            application/json:
              example:
                id: addr_EfhxLZ9ck8
                label:
                first_name: John
                last_name: Doe
                full_name: John Doe
                address1: 371 Lovely Street
                address2: Northwest
                postal_code: '10118'
                city: New York
                phone: 555-555-0199
                company: Company
                country_name: United States
                country_code: US
                state_text: NY
                state_code: NY
                quick_checkout: false
                is_default_billing: false
                is_default_shipping: false
                state_abbr: NY
                country_iso: US
                state_name: New York
                owner:
                  id: cust_UkLWZg9DAJ
                  type: customer
                  name:
              schema:
                "$ref": "#/components/schemas/Address"
        '404':
          description: address not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Address not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    patch:
      summary: Update an address
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const address = await client.customer.addresses.update(
            'addr_abc123',
            {
              city: 'Los Angeles',
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: address updated
          content:
            application/json:
              example:
                id: addr_EfhxLZ9ck8
                label:
                first_name: John
                last_name: Doe
                full_name: John Doe
                address1: 377 Lovely Street
                address2: Northwest
                postal_code: '10118'
                city: Los Angeles
                phone: 555-555-0199
                company: Company
                country_name: United States
                country_code: US
                state_text: NY
                state_code: NY
                quick_checkout: false
                is_default_billing: false
                is_default_shipping: false
                state_abbr: NY
                country_iso: US
                state_name: New York
                owner:
                  id: cust_UkLWZg9DAJ
                  type: customer
                  name:
              schema:
                "$ref": "#/components/schemas/Address"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/AddressUpdateParams"
        required: true
    delete:
      summary: Delete an address
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.customer.addresses.delete('addr_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: address deleted
        '404':
          description: address not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Address not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/credit_cards":
    get:
      summary: List saved credit cards
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns the authenticated customer's saved credit cards for the
        current store's payment methods
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const cards = await client.customer.creditCards.list(
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `name`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: CreditCard
        sortable:
        - created_at
        - id
        - name
        - updated_at
      responses:
        '200':
          description: credit cards found
          content:
            application/json:
              example:
                data:
                - id: card_UkLWZg9DAJ
                  brand: visa
                  last4: '1111'
                  month: 12
                  year: 2027
                  name: Spree Commerce
                  default: false
                  gateway_payment_profile_id:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/CreditCard"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/credit_cards/{id}":
    get:
      summary: Get a credit card
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a saved credit card by its ID
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const card = await client.customer.creditCards.get('card_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: credit card found
          content:
            application/json:
              example:
                id: card_UkLWZg9DAJ
                brand: visa
                last4: '1111'
                month: 12
                year: 2027
                name: Spree Commerce
                default: false
                gateway_payment_profile_id:
              schema:
                "$ref": "#/components/schemas/CreditCard"
        '404':
          description: credit card not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Credit card not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    delete:
      summary: Delete a credit card
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Removes a saved credit card from the customer account
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.customer.creditCards.delete('card_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: credit card deleted
        '404':
          description: credit card not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Credit card not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/orders":
    get:
      summary: List orders
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a paginated list of completed orders for the authenticated
        customer.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const orders = await client.customer.orders.list(
            {
              completed_at_gt: '2026-01-01',
              sort: '-completed_at',
            },
            { token: '<token>' },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[complete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `complete`.
      - name: q[incomplete]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `incomplete`.
      - name: q[partially_refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `partially_refunded`.
      - name: q[refunded]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `refunded`.
      - name: page
        in: query
        required: false
        description: 'Page number (default: 1)'
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        description: 'Number of results per page (default: 25, max: 100)'
        schema:
          type: integer
      - name: sort
        in: query
        required: false
        description: 'Sort order. Prefix with - for descending. Values: completed_at,
          -completed_at, total, -total, number, -number'
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (items, fulfillments,
          payments, discounts, billing_address, shipping_address, gift_card). Use
          "none" to skip associations.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., total,amount_due,item_count).
          id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `channel_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `completed_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `currency` | One of the `CurrencyCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `customer_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `delivery_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `fulfillment_status` | One of `backorder`, `canceled`, `partial`, `unfulfilled`, `fulfilled`, `delivered`, `pending`, `ready`, `shipped` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `item_total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `locale` | One of the `LocaleCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `market_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `order_group_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `payment_status` | One of `none`, `authorized`, `partially_paid`, `paid`, `partially_refunded`, `refunded`, `overcharged`, `voided`, `balance_due`, `credit_owed`, `failed`, `void` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `po_number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `status` | One of `draft`, `placed`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `total` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `total_quantity` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `channel_id`, `completed_at`, `created_at`, `currency`, `customer_id`, `delivery_total`, `fulfillment_status`, `id`, `item_total`, `locale`, `market_id`, `number`, `order_group_id`, `payment_status`, `po_number`, `seller_id`, `status`, `total`, `total_quantity`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Order
        sortable:
        - channel_id
        - completed_at
        - created_at
        - currency
        - customer_id
        - delivery_total
        - fulfillment_status
        - id
        - item_total
        - locale
        - market_id
        - number
        - order_group_id
        - payment_state
        - payment_status
        - po_number
        - seller_id
        - shipment_state
        - status
        - total
        - total_quantity
        - updated_at
      responses:
        '200':
          description: orders listed
          content:
            application/json:
              example:
                data:
                - id: or_UkLWZg9DAJ
                  market_id: mkt_UkLWZg9DAJ
                  withdrawal_period_ends_at:
                  within_withdrawal_period: true
                  shipping_eq_billing_address: false
                  cart_id:
                  channel_id: ch_UkLWZg9DAJ
                  company_id:
                  company_name:
                  po_document_filename:
                  po_document_byte_size:
                  number: R1001
                  email: idella.ratke@runolfsdottir.us
                  customer_note:
                  po_number:
                  currency: USD
                  locale: en
                  total_quantity: 1
                  coupon_code:
                  fulfillment_status:
                  payment_status:
                  completed_at: '2026-01-15T12:00:00.000Z'
                  item_total: '10.00'
                  display_item_total: "$10.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  delivery_total: '100.00'
                  display_delivery_total: "$100.00"
                  fee_total: '0.00'
                  display_fee_total: "$0.00"
                  gift_card_total: '0.00'
                  display_gift_card_total: "$0.00"
                  store_credit_total: '0.00'
                  display_store_credit_total: "$0.00"
                  total: '110.00'
                  display_total: "$110.00"
                  amount_due: '110.00'
                  display_amount_due: "$110.00"
                  covered_by_store_credit: false
                  payments: []
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  discounts: []
                  fees: []
                  items:
                  - id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    seller_id:
                    preorder: false
                    preorder_ships_at:
                    quantity: 1
                    currency: USD
                    name: Product 3855270
                    slug: product-3855270
                    options_text: ''
                    price: '10.00'
                    display_price: "$10.00"
                    total: '10.00'
                    display_total: "$10.00"
                    adjustment_total: '0.00'
                    display_adjustment_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    pre_tax_amount: '10.00'
                    display_pre_tax_amount: "$10.00"
                    discounted_amount: '10.00'
                    display_discounted_amount: "$10.00"
                    display_compare_at_amount: "$0.00"
                    compare_at_amount:
                    thumbnail_url:
                    option_values: []
                    digital_links: []
                  fulfillments:
                  - id: ful_UkLWZg9DAJ
                    number: R1001-F1
                    tracking: U10000
                    tracking_url:
                    pickup_point_data:
                    selected_delivery_rate_id: dr_gbHJdmfrXB
                    unpriced: false
                    cost: '100.00'
                    display_cost: "$100.00"
                    total: '100.00'
                    display_total: "$100.00"
                    discount_total: '0.00'
                    display_discount_total: "$0.00"
                    additional_tax_total: '0.00'
                    display_additional_tax_total: "$0.00"
                    included_tax_total: '0.00'
                    display_included_tax_total: "$0.00"
                    tax_total: '0.00'
                    display_tax_total: "$0.00"
                    status: unfulfilled
                    fulfillment_type: shipping
                    fulfilled_at:
                    delivered_at:
                    items:
                    - item_id: li_UkLWZg9DAJ
                      variant_id: variant_UkLWZg9DAJ
                      quantity: 1
                    deliveries:
                    - id: dlv_UkLWZg9DAJ
                      tracking_number: U10000
                      carrier:
                      carrier_name:
                      service:
                      status: pending
                      tracking_url:
                      estimated_delivery_at:
                      delivered_at:
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 198
                      code: UPS_GROUND_216
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                    stock_location:
                      id: sloc_UkLWZg9DAJ
                      name: Macy Goyette
                      address1: 1600 Pennsylvania Ave NW
                      city: Washington
                      zipcode: '20500'
                      country_code: US
                      country_name: United States
                      state_code: AL
                      state_text: AL
                      country_iso: US
                      state_abbr: AL
                      pickup_ready_in_minutes:
                      pickup_instructions:
                    delivery_rates:
                    - id: dr_gbHJdmfrXB
                      delivery_method_id: dm_UkLWZg9DAJ
                      name: UPS Ground 198
                      selected: true
                      cost: '10.00'
                      total: '10.00'
                      additional_tax_total: '0.00'
                      included_tax_total: '0.00'
                      tax_total: '0.00'
                      carrier:
                      service_level:
                      estimated_delivery_date:
                      unpriced: false
                      freight_summary:
                      display_cost: "$10.00"
                      display_total: "$10.00"
                      display_additional_tax_total: "$0.00"
                      display_included_tax_total: "$0.00"
                      display_tax_total: "$0.00"
                      delivery_method:
                        id: dm_UkLWZg9DAJ
                        name: UPS Ground 198
                        code: UPS_GROUND_216
                        estimated_transit_business_days_min:
                        estimated_transit_business_days_max:
                        digital: false
                        pickup: false
                        pickup_point: false
                  billing_address:
                    id: addr_EfhxLZ9ck8
                    label:
                    first_name: John
                    last_name: Doe
                    full_name: John Doe
                    address1: 471 Lovely Street
                    address2: Northwest
                    postal_code: '10118'
                    city: New York
                    phone: 555-555-0199
                    company: Company
                    country_name: United States
                    country_code: US
                    state_text: NY
                    state_code: NY
                    quick_checkout: false
                    is_default_billing: false
                    is_default_shipping: false
                    state_abbr: NY
                    country_iso: US
                    state_name: New York
                    owner:
                  shipping_address:
                    id: addr_VqXmZF31wY
                    label:
                    first_name: John
                    last_name: Doe
                    full_name: John Doe
                    address1: 472 Lovely Street
                    address2: Northwest
                    postal_code: '10118'
                    city: New York
                    phone: 555-555-0199
                    company: Company
                    country_name: United States
                    country_code: US
                    state_text: NY
                    state_code: NY
                    quick_checkout: false
                    is_default_billing: false
                    is_default_shipping: false
                    state_abbr: NY
                    country_iso: US
                    state_name: New York
                    owner:
                  gift_card:
                  market:
                    id: mkt_UkLWZg9DAJ
                    name: United States
                    currency: USD
                    default_locale: en
                    tax_inclusive: false
                    default: true
                    country_codes:
                    - US
                    country_isos:
                    - US
                    supported_locales:
                    - en
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Order"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/orders/{id}":
    get:
      summary: Get an order
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a single completed order for the authenticated customer.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const order = await client.customer.orders.get(
            'or_abc123',
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Order prefixed ID
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (items, fulfillments,
          payments, discounts, billing_address, shipping_address, gift_card). Use
          "none" to skip associations.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., total,amount_due,item_count).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: order found
          content:
            application/json:
              example:
                id: or_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                withdrawal_period_ends_at:
                within_withdrawal_period: true
                shipping_eq_billing_address: false
                cart_id:
                channel_id: ch_UkLWZg9DAJ
                company_id:
                company_name:
                po_document_filename:
                po_document_byte_size:
                number: R1001
                email: whitney_homenick@leschwhite.co.uk
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                coupon_code:
                fulfillment_status:
                payment_status:
                completed_at: '2026-01-15T12:00:00.000Z'
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '100.00'
                display_delivery_total: "$100.00"
                fee_total: '0.00'
                display_fee_total: "$0.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '110.00'
                display_total: "$110.00"
                amount_due: '110.00'
                display_amount_due: "$110.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '0.00'
                display_adjustment_total: "$0.00"
                discounts: []
                fees: []
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 3875633
                  slug: product-3875633
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments:
                - id: ful_UkLWZg9DAJ
                  number: R1001-F1
                  tracking: U10000
                  tracking_url:
                  pickup_point_data:
                  selected_delivery_rate_id: dr_gbHJdmfrXB
                  unpriced: false
                  cost: '100.00'
                  display_cost: "$100.00"
                  total: '100.00'
                  display_total: "$100.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  status: unfulfilled
                  fulfillment_type: shipping
                  fulfilled_at:
                  delivered_at:
                  items:
                  - item_id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    quantity: 1
                  deliveries:
                  - id: dlv_UkLWZg9DAJ
                    tracking_number: U10000
                    carrier:
                    carrier_name:
                    service:
                    status: pending
                    tracking_url:
                    estimated_delivery_at:
                    delivered_at:
                  delivery_method:
                    id: dm_UkLWZg9DAJ
                    name: UPS Ground 200
                    code: UPS_GROUND_218
                    estimated_transit_business_days_min:
                    estimated_transit_business_days_max:
                    digital: false
                    pickup: false
                    pickup_point: false
                  stock_location:
                    id: sloc_UkLWZg9DAJ
                    name: Sunny Bernier
                    address1: 1600 Pennsylvania Ave NW
                    city: Washington
                    zipcode: '20500'
                    country_code: US
                    country_name: United States
                    state_code: AL
                    state_text: AL
                    country_iso: US
                    state_abbr: AL
                    pickup_ready_in_minutes:
                    pickup_instructions:
                  delivery_rates:
                  - id: dr_gbHJdmfrXB
                    delivery_method_id: dm_UkLWZg9DAJ
                    name: UPS Ground 200
                    selected: true
                    cost: '10.00'
                    total: '10.00'
                    additional_tax_total: '0.00'
                    included_tax_total: '0.00'
                    tax_total: '0.00'
                    carrier:
                    service_level:
                    estimated_delivery_date:
                    unpriced: false
                    freight_summary:
                    display_cost: "$10.00"
                    display_total: "$10.00"
                    display_additional_tax_total: "$0.00"
                    display_included_tax_total: "$0.00"
                    display_tax_total: "$0.00"
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 200
                      code: UPS_GROUND_218
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                billing_address:
                  id: addr_EfhxLZ9ck8
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 477 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                shipping_address:
                  id: addr_VqXmZF31wY
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 478 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Order"
        '404':
          description: order belongs to another user
          content:
            application/json:
              example:
                error:
                  code: order_not_found
                  message: Order not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers":
    post:
      summary: Register a new customer
      tags:
      - Customers
      security:
      - api_key: []
      description: Creates a new customer account and returns a JWT token
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const auth = await client.customers.create({
            email: 'newuser@example.com',
            password: 'password123',
            password_confirmation: 'password123',
            first_name: 'John',
            last_name: 'Doe',
            phone: '+1234567890',
            accepts_email_marketing: true,
            metadata: { source: 'storefront' },
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: registration successful
          content:
            application/json:
              example:
                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjY0OWM2NTkzLTBhZWQtNDA5Ny1hYTI3LThhMjVmYTU4OGI3OSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzY4NDgyMDAwfQ.llCt1j8kVryteixNYywlzA1x8CGqCNBaKiT3-ihDrsE
                refresh_token: mLm6vdSzLUgPhw8SCzDiagfL
                user:
                  id: cust_UkLWZg9DAJ
                  email: newuser@example.com
                  first_name: John
                  last_name: Doe
                  phone: "+1234567890"
                  accepts_email_marketing: true
                  email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                  full_name: John Doe
                  available_store_credit_total: '0.00'
                  display_available_store_credit_total: "$0.00"
                  addresses: []
                  default_billing_address:
                  default_shipping_address:
                  newsletter_subscriber:
                    id: sub_UkLWZg9DAJ
                    email: newuser@example.com
                    created_at: '2026-01-15T12:00:00.000Z'
                    updated_at: '2026-01-15T12:00:00.000Z'
                    verified: true
                    verified_at: '2026-01-15T12:00:00Z'
                    customer_id:
                  customer_groups: []
              schema:
                "$ref": "#/components/schemas/AuthResponse"
        '422':
          description: email already taken
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Email has already been taken
                  details:
                    email:
                    - has already been taken
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/RegisterParams"
        required: true
  "/api/v3/store/customers/me":
    get:
      summary: Get current customer profile
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns the profile of the currently authenticated customer
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const customer = await client.customer.get({
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        description: Bearer JWT token
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: profile found
          content:
            application/json:
              example:
                id: cust_UkLWZg9DAJ
                email: rochell@schoen.name
                first_name: Felix
                last_name: Rowe
                phone: 555-555-0199
                accepts_email_marketing: false
                email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                full_name: Felix Rowe
                available_store_credit_total: '0.00'
                display_available_store_credit_total: "$0.00"
                addresses:
                - id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 483 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 484 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                default_billing_address:
                  id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 484 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                default_shipping_address:
                  id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 483 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                newsletter_subscriber:
                customer_groups: []
              schema:
                "$ref": "#/components/schemas/Customer"
        '401':
          description: unauthorized - invalid token
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    patch:
      summary: Update current customer profile
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Updates the profile of the currently authenticated customer
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const customer = await client.customer.update(
            {
              first_name: 'John',
              last_name: 'Doe',
              metadata: { preferred_contact: 'email' },
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: profile updated
          content:
            application/json:
              example:
                id: cust_UkLWZg9DAJ
                email: tabitha@ziemebogisich.info
                first_name: Updated
                last_name: Name
                phone: 555-555-0199
                accepts_email_marketing: false
                email_marketing_consent_updated_at: '2026-01-15T12:00:00Z'
                full_name: Updated Name
                available_store_credit_total: '0.00'
                display_available_store_credit_total: "$0.00"
                addresses:
                - id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 485 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                - id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 486 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                default_billing_address:
                  id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 486 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: true
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                default_shipping_address:
                  id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 485 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: true
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                    id: cust_UkLWZg9DAJ
                    type: customer
                    name:
                newsletter_subscriber:
                customer_groups: []
              schema:
                "$ref": "#/components/schemas/Customer"
        '422':
          description: validation error
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Email can't be blank
                  details:
                    email:
                    - can't be blank
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateCustomerParams"
        required: true
  "/api/v3/store/customers/me/data_requests":
    get:
      summary: List data requests
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns the authenticated customer's GDPR data requests, most recent
        first
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[access]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `access`.
      - name: q[erasure]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `erasure`.
      - name: q[in_progress]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `in_progress`.
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `completed_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `email` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `kind` | One of `access`, `erasure` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `requested_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `status` | One of `awaiting_confirmation`, `pending`, `processing`, `completed`, `failed`, `lapsed` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `completed_at`, `created_at`, `email`, `id`, `kind`, `number`, `requested_at`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: DataRequest
        sortable:
        - completed_at
        - created_at
        - email
        - id
        - kind
        - number
        - requested_at
        - status
        - updated_at
      responses:
        '200':
          description: data requests found
          content:
            application/json:
              example:
                data:
                - id: dsr_UkLWZg9DAJ
                  number: DSR1001
                  kind: access
                  status: pending
                  requested_at: '2026-01-15T12:00:00Z'
                  completed_at:
                  expires_at:
                  download_url:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/DataRequest"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
    post:
      summary: Open a data request
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Opens a GDPR request for a copy of the customer's personal data (`access`)
        or its erasure (`erasure`). Nothing happens until the request is confirmed
        from the link emailed to the account's address: the response is the request
        awaiting confirmation, and the link opens `redirect_url` with the
        confirmation token appended. The work then happens in the background.

        An erasure request requires the account password. A request of the same
        kind that is still in flight is returned instead of starting a second one,
        and a request still awaiting confirmation sends the email again.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '202':
          description: request accepted
          content:
            application/json:
              example:
                id: dsr_UkLWZg9DAJ
                number: DSR1001
                kind: access
                status: awaiting_confirmation
                requested_at: '2026-01-15T12:00:00Z'
                completed_at:
                expires_at:
                download_url:
              schema:
                "$ref": "#/components/schemas/DataRequest"
        '422':
          description: erasure without the account password
          content:
            application/json:
              example:
                error:
                  code: current_password_invalid
                  message: Current password is invalid or missing
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateDataRequestParams"
  "/api/v3/store/customers/me/data_requests/{id}":
    get:
      summary: Get a data request
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: 'Returns one of the customer''s own data requests. The download
        link is never shown here: it goes only to the holder of the emailed confirmation
        token'
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: data request found
          content:
            application/json:
              example:
                id: dsr_UkLWZg9DAJ
                number: DSR1001
                kind: access
                status: pending
                requested_at: '2026-01-15T12:00:00Z'
                completed_at:
                expires_at:
                download_url:
              schema:
                "$ref": "#/components/schemas/DataRequest"
        '404':
          description: not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Data request not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/data_requests/{token}":
    get:
      summary: Get a data request by its confirmation token
      tags:
      - Customers
      security:
      - api_key: []
      description: |
        Returns the data request the emailed confirmation token belongs to, with a
        download link once the export is ready. Needs no signed-in session, because
        the link may be opened on a device that was never signed in.

        The token stays readable after the 24-hour confirmation window, and the
        response carries the request's saved `status`. A request that is
        `awaiting_confirmation` can be confirmed only within that window: a later
        confirmation attempt returns `422` and marks the request `lapsed`. `404`
        means the token is unknown, or was voided when the customer's data was
        erased.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: data request found
          content:
            application/json:
              example:
                id: dsr_UkLWZg9DAJ
                number: DSR1001
                kind: access
                status: pending
                requested_at: '2026-01-15T12:00:00Z'
                completed_at:
                expires_at:
                download_url:
              schema:
                "$ref": "#/components/schemas/DataRequest"
        '404':
          description: token unknown or voided
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: This confirmation link has expired or is no longer valid
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/data_requests/{token}/confirmation":
    post:
      summary: Confirm a data request
      tags:
      - Customers
      security:
      - api_key: []
      description: |
        Confirms a data request with the token from the confirmation email, and
        starts the work. Call it when the person presses a button on the page the
        link opens, never when the page loads: some mail scanners open links and
        run the page's scripts. Confirming again returns the request as it stands.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: data request confirmed
          content:
            application/json:
              example:
                id: dsr_UkLWZg9DAJ
                number: DSR1001
                kind: access
                status: pending
                requested_at: '2026-01-15T12:00:00Z'
                completed_at:
                expires_at:
                download_url:
              schema:
                "$ref": "#/components/schemas/DataRequest"
        '422':
          description: token not recognised, or the request has lapsed
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: This confirmation link has expired or is no longer valid
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/gift_cards":
    get:
      summary: List gift cards
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns all gift cards for the authenticated customer
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const giftCards = await client.customer.giftCards.list(
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of code (partial, case-insensitive).
      - name: q[active]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `active`.
      - name: q[expired]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `expired`.
      - name: q[partially_redeemed]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `partially_redeemed`.
      - name: q[redeemed]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `redeemed`.
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[code_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `code` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_by_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `currency` | One of the `CurrencyCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `customer_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `expires_at` | Date | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `gift_card_batch_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `state` | One of `active`, `partially_redeemed`, `redeemed`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `status` | One of `active`, `partially_redeemed`, `redeemed`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `code`, `created_at`, `created_by_id`, `currency`, `customer_id`, `expires_at`, `gift_card_batch_id`, `id`, `state`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: GiftCard
        sortable:
        - code
        - created_at
        - created_by_id
        - currency
        - customer_id
        - expires_at
        - gift_card_batch_id
        - id
        - state
        - status
        - updated_at
      responses:
        '200':
          description: gift cards found
          content:
            application/json:
              example:
                data:
                - id: gc_UkLWZg9DAJ
                  code: 1A288BF2DA45E295
                  status: active
                  currency: USD
                  amount: '10.00'
                  amount_used: '0.00'
                  amount_authorized: '0.00'
                  amount_remaining: '10.00'
                  display_amount: "$10.00"
                  display_amount_used: "$0.00"
                  display_amount_remaining: "$10.00"
                  expires_at:
                  redeemed_at:
                  expired: false
                  active: true
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/GiftCard"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/gift_cards/{id}":
    get:
      summary: Get a gift card
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a gift card by its ID
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const giftCard = await client.customer.giftCards.get('gc_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: gift card found
          content:
            application/json:
              example:
                id: gc_UkLWZg9DAJ
                code: B7180B830F0E5992
                status: active
                currency: USD
                amount: '10.00'
                amount_used: '0.00'
                amount_authorized: '0.00'
                amount_remaining: '10.00'
                display_amount: "$10.00"
                display_amount_used: "$0.00"
                display_amount_remaining: "$10.00"
                expires_at:
                redeemed_at:
                expired: false
                active: true
              schema:
                "$ref": "#/components/schemas/GiftCard"
        '404':
          description: gift card not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Gift card not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/payment_setup_sessions":
    post:
      summary: Create payment setup session
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Creates a new payment setup session for saving a payment method
        for future use. Delegates to the payment gateway to initialize a provider-specific
        setup flow (e.g. Stripe SetupIntent, Adyen zero-auth tokenization).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.customer.paymentSetupSessions.create(
            {
              payment_method_id: 'pm_abc123',
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: payment setup session created
          content:
            application/json:
              example:
                id: pss_gbHJdmfrXB
                status: pending
                external_id: bogus_seti_b0f840e3d99ea3a536ef5be0
                external_client_secret: bogus_seti_secret_8fa01173ccc21ceb
                external_data: {}
                payment_method_id: pm_UkLWZg9DAJ
                payment_source_id:
                payment_source_type:
                customer_id: cust_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 241
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSetupSession"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '404':
          description: payment method not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Payment method not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreatePaymentSetupSessionParams"
        required: true
  "/api/v3/store/customers/me/payment_setup_sessions/{id}":
    parameters:
    - name: x-spree-api-key
      in: header
      required: true
      schema:
        type: string
    - name: Authorization
      in: header
      required: true
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Payment setup session ID
      schema:
        type: string
    get:
      summary: Get payment setup session
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns a payment setup session with its current status and provider
        data.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.customer.paymentSetupSessions.get('pss_abc123', {
            token: '<token>',
          })
      responses:
        '200':
          description: payment setup session found
          content:
            application/json:
              example:
                id: pss_UkLWZg9DAJ
                status: pending
                external_id: seti_test_469ea499603a54b5a5f4b192
                external_client_secret: seti_secret_ee50fe0dfcb78f21eabebb03
                external_data:
                  client_secret: secret_123
                payment_method_id: pm_UkLWZg9DAJ
                payment_source_id:
                payment_source_type:
                customer_id: cust_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 244
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSetupSession"
        '404':
          description: payment setup session not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Payment setup session not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/payment_setup_sessions/{id}/complete":
    parameters:
    - name: x-spree-api-key
      in: header
      required: true
      schema:
        type: string
    - name: Authorization
      in: header
      required: true
      schema:
        type: string
    - name: id
      in: path
      required: true
      description: Payment setup session ID
      schema:
        type: string
    patch:
      summary: Complete payment setup session
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Completes a payment setup session by confirming the setup with
        the provider, resulting in a saved payment method.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const session = await client.customer.paymentSetupSessions.complete(
            'pss_abc123',
            {},
            {
              token: '<token>',
            },
          )
      parameters: []
      responses:
        '200':
          description: payment setup session completed
          content:
            application/json:
              example:
                id: pss_UkLWZg9DAJ
                status: completed
                external_id: seti_test_d9e0e43453e8ba9aff74d4b9
                external_client_secret: seti_secret_73ff06ddd3b1edb4c9b6db1c
                external_data:
                  client_secret: secret_123
                payment_method_id: pm_UkLWZg9DAJ
                payment_source_id: card_UkLWZg9DAJ
                payment_source_type: credit_card
                customer_id: cust_UkLWZg9DAJ
                payment_method:
                  id: pm_UkLWZg9DAJ
                  name: Credit Card 246
                  description:
                  type: bogus
                  session_required: true
                  source_required: true
              schema:
                "$ref": "#/components/schemas/PaymentSetupSession"
        '404':
          description: payment setup session not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Payment setup session not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CompletePaymentSetupSessionParams"
  "/api/v3/store/customers/me/store_credits":
    get:
      summary: List store credits
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      description: Returns store credits for the authenticated customer, filtered
        by current store and currency. Supports Ransack filtering.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const credits = await client.customer.storeCredits.list(
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q[from_gift_card]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `from_gift_card`.
      - name: q[outstanding]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `outstanding`.
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., amount,currency).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[amount_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `amount` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `currency` | One of the `CurrencyCode` codes | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `customer_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `amount`, `created_at`, `currency`, `customer_id`, `id`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: StoreCredit
        sortable:
        - amount
        - created_at
        - currency
        - customer_id
        - id
        - updated_at
      responses:
        '200':
          description: store credits found
          content:
            application/json:
              example:
                data:
                - id: credit_UkLWZg9DAJ
                  amount: '100.00'
                  amount_used: '0.00'
                  amount_remaining: '100.00'
                  display_amount: "$100.00"
                  display_amount_used: "$0.00"
                  display_amount_remaining: "$100.00"
                  currency: USD
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/StoreCredit"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/customers/me/store_credits/{id}":
    get:
      summary: Get a store credit
      tags:
      - Customers
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const credit = await client.customer.storeCredits.get('credit_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., amount,currency).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: store credit found
          content:
            application/json:
              example:
                id: credit_UkLWZg9DAJ
                amount: '100.00'
                amount_used: '0.00'
                amount_remaining: '100.00'
                display_amount: "$100.00"
                display_amount_used: "$0.00"
                display_amount_remaining: "$100.00"
                currency: USD
              schema:
                "$ref": "#/components/schemas/StoreCredit"
        '404':
          description: store credit not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Store credit not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/delivery_methods":
    get:
      summary: List delivery methods
      tags:
      - Delivery
      security:
      - api_key: []
      description: Storefront-visible delivery methods. Filter by fulfillment_type
        to discover pickup options.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const { data: pickupMethods } = await client.deliveryMethods.list({
            fulfillment_type: 'pickup',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of name (partial, case-insensitive).
      - name: fulfillment_type
        in: query
        required: false
        description: 'Filter: shipping, digital, pickup'
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `available_to_sellers` | True or false | `eq` `not_eq` `in` `not_in` `true` `false` `null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `storefront_visible` | True or false | `eq` `not_eq` `in` `not_in` `true` `false` `null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `available_to_sellers`, `created_at`, `id`, `name`, `seller_id`, `storefront_visible`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: DeliveryMethod
        sortable:
        - available_to_sellers
        - created_at
        - id
        - name
        - seller_id
        - storefront_visible
        - updated_at
      responses:
        '200':
          description: delivery methods found
          content:
            application/json:
              example:
                data:
                - id: dm_gbHJdmfrXB
                  name: Store pickup
                  code: PICKUP_1
                  estimated_transit_business_days_min:
                  estimated_transit_business_days_max:
                  digital: false
                  pickup: true
                  pickup_point: false
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
  "/api/v3/store/delivery_methods/{id}/pickup_locations":
    get:
      summary: List pickup locations
      tags:
      - Delivery
      security:
      - api_key: []
      description: Pickup-enabled stock locations for a pickup delivery method. Pass
        cart_id to keep only locations that can fulfill the whole cart from local
        stock.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const { data: pickupLocations } = await client.deliveryMethods.pickupLocations('dm_abc123', {
            cart_id: 'cart_abc123',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Delivery method prefixed ID
        schema:
          type: string
      - name: cart_id
        in: query
        required: false
        description: Cart prefixed ID for availability filtering
        schema:
          type: string
      responses:
        '200':
          description: pickup locations found
          content:
            application/json:
              example:
                data:
                - id: sloc_UkLWZg9DAJ
                  name: Downtown
                  address1: 1600 Pennsylvania Ave NW
                  city: Washington
                  zipcode: '20500'
                  country_code: US
                  country_name: United States
                  state_code: AL
                  state_text: AL
                  country_iso: US
                  state_abbr: AL
                  pickup_ready_in_minutes:
                  pickup_instructions:
  "/api/v3/store/customers/me/digital_links":
    get:
      summary: List my digital links
      tags:
      - Digital Links
      security:
      - api_key: []
        bearer_auth: []
      description: The signed-in customer's downloads in this store, newest first.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[created_at_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: DigitalLink
        sortable:
        - created_at
        - id
        - updated_at
      responses:
        '200':
          description: digital links listed
          content:
            application/json:
              example:
                data:
                - id: dl_UkLWZg9DAJ
                  access_counter: 0
                  filename: thinking-cat.jpg
                  content_type: image/jpeg
                  download_url: "/api/v3/store/digital_links/PyFLkSrH72mE2GaBLUeZnXXF"
                  expires_at: '2026-01-22T12:00:00Z'
                  authorizable: true
                  expired: false
                  access_limit_exceeded: false
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/DigitalLink"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
  "/api/v3/store/digital_links/{token}":
    get:
      summary: Download a digital product
      tags:
      - Digital Links
      description: |
        Downloads a digital product file using the digital link token.
        The token is provided via the `download_url` field on digital links
        returned with order line items. No API key or authentication required —
        the token itself grants access.

        Responds with a redirect to a short-lived download URL; follow it to
        fetch the file. Each download increments the access counter. Downloads
        may be limited by the asset's own settings, falling back to the store's
        (number of downloads and/or time-based expiration).
      parameters:
      - name: token
        in: path
        required: true
        description: Digital link token
        schema:
          type: string
      responses:
        '302':
          description: redirect to the file download
        '403':
          description: download link expired or limit exceeded
          content:
            application/json:
              example:
                error:
                  code: digital_link_expired
                  message: Download link expired or invalid
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '404':
          description: digital link not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Digital link not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/countries":
    get:
      summary: List countries
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns countries available in the store. Use ?expand=market to
        include market details (currency, locale, tax_inclusive).
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const countries = await client.countries.list()
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: countries found
          content:
            application/json:
              example:
                data:
                - iso: DE
                  iso3: DEU
                  name: Germany
                  states_required: false
                  zipcode_required: true
                - iso: US
                  iso3: USA
                  name: United States
                  states_required: true
                  zipcode_required: true
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Country"
                required:
                - data
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/countries/{iso}":
    get:
      summary: Get a country
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns a single country by ISO code. Supports ?expand=states for
        address forms and ?expand=market for market details.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const country = await client.countries.get('US')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: iso
        in: path
        required: true
        description: Country ISO 3166-1 alpha-2 code (e.g., "US", "DE")
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: country found
          content:
            application/json:
              example:
                iso: US
                iso3: USA
                name: United States
                states_required: true
                zipcode_required: true
              schema:
                type: object
                properties:
                  iso:
                    type: string
                  iso3:
                    type: string
                  name:
                    type: string
                  states_required:
                    type: boolean
                  zipcode_required:
                    type: boolean
                required:
                - iso
                - iso3
                - name
                - states_required
                - zipcode_required
        '404':
          description: country not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: record not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/currencies":
    get:
      summary: List supported currencies
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns currencies supported by the store (derived from markets)
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const currencies = await client.currencies.list()
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: currencies found
          content:
            application/json:
              example:
                data:
                - iso_code: USD
                  name: United States Dollar
                  symbol: "$"
                  decimal_places: 2
                - iso_code: EUR
                  name: Euro
                  symbol: "€"
                  decimal_places: 2
                - iso_code: GBP
                  name: British Pound
                  symbol: "£"
                  decimal_places: 2
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Currency"
                required:
                - data
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/locales":
    get:
      summary: List supported locales
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns locales supported by the store (derived from markets)
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const locales = await client.locales.list()
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: locales found
          content:
            application/json:
              example:
                data:
                - code: de
                  name: Deutsch
                  default: false
                  rtl: false
                - code: en
                  name: English
                  default: true
                  rtl: false
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Locale"
                required:
                - data
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/markets":
    get:
      summary: List markets
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns all markets for the current store with their countries,
        currency, locales, and tax configuration.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const markets = await client.markets.list()
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: markets found
          content:
            application/json:
              example:
                data:
                - id: mkt_UkLWZg9DAJ
                  name: North America
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
                  - es
                  countries:
                  - iso: US
                    iso3: USA
                    name: United States
                    states_required: true
                    zipcode_required: true
                - id: mkt_gbHJdmfrXB
                  name: Europe
                  currency: EUR
                  default_locale: de
                  tax_inclusive: true
                  default: false
                  country_codes:
                  - DE
                  - FR
                  country_isos:
                  - DE
                  - FR
                  supported_locales:
                  - de
                  - en
                  - fr
                  countries:
                  - iso: FR
                    iso3: FRA
                    name: France
                    states_required: false
                    zipcode_required: true
                  - iso: DE
                    iso3: DEU
                    name: Germany
                    states_required: false
                    zipcode_required: true
              schema:
                type: object
                properties:
                  data:
                    type: array
                required:
                - data
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/markets/{id}":
    get:
      summary: Get a market
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns a single market by prefixed ID with its countries, currency,
        locales, and tax configuration.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const market = await client.markets.get('mkt_xxx')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Market prefixed ID (e.g., "mkt_k5nR8xLq")
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: market found
          content:
            application/json:
              example:
                id: mkt_gbHJdmfrXB
                name: Europe
                currency: EUR
                default_locale: de
                tax_inclusive: true
                default: false
                country_codes:
                - DE
                - FR
                country_isos:
                - DE
                - FR
                supported_locales:
                - de
                - en
                - fr
                countries:
                - iso: FR
                  iso3: FRA
                  name: France
                  states_required: false
                  zipcode_required: true
                - iso: DE
                  iso3: DEU
                  name: Germany
                  states_required: false
                  zipcode_required: true
              schema:
                type: object
        '404':
          description: market not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Market not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/markets/resolve":
    get:
      summary: Resolve market by country
      tags:
      - Markets
      security:
      - api_key: []
      description: Determine which market applies for a given country ISO code. Useful
        for auto-selecting the correct currency and locale when a customer's location
        is known.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const market = await client.markets.resolve('DE')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: country
        in: query
        required: true
        description: Country ISO 3166-1 alpha-2 code (e.g., "DE", "US")
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: market resolved
          content:
            application/json:
              example:
                id: mkt_gbHJdmfrXB
                name: Europe
                currency: EUR
                default_locale: de
                tax_inclusive: true
                default: false
                country_codes:
                - DE
                - FR
                country_isos:
                - DE
                - FR
                supported_locales:
                - de
                - en
                - fr
                countries:
                - iso: DE
                  iso3: DEU
                  name: Deutschland
                  states_required: false
                  zipcode_required: true
                - iso: FR
                  iso3: FRA
                  name: Frankreich
                  states_required: false
                  zipcode_required: true
              schema:
                type: object
        '404':
          description: no market for country
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: record not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/markets/{market_id}/countries":
    get:
      summary: List countries in a market
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns countries belonging to a specific market. Use this for
        address form country dropdowns during checkout.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const countries = await client.markets.countries.list('mkt_xxx')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: market_id
        in: path
        required: true
        description: Market prefixed ID
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: countries found
          content:
            application/json:
              example:
                data:
                - iso: FR
                  iso3: FRA
                  name: France
                  states_required: false
                  zipcode_required: true
                - iso: DE
                  iso3: DEU
                  name: Germany
                  states_required: false
                  zipcode_required: true
              schema:
                type: object
                properties:
                  data:
                    type: array
                required:
                - data
  "/api/v3/store/markets/{market_id}/countries/{id}":
    get:
      summary: Get a country in a market
      tags:
      - Markets
      security:
      - api_key: []
      description: Returns a single country by ISO code within a market. Supports
        ?expand=states for address forms.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const country = await client.markets.countries.get('mkt_xxx', 'DE')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: market_id
        in: path
        required: true
        description: Market prefixed ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Country ISO 3166-1 alpha-2 code (e.g., "DE")
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: country found
          content:
            application/json:
              example:
                iso: US
                iso3: USA
                name: United States
                states_required: true
                zipcode_required: true
              schema:
                type: object
        '404':
          description: country not in market
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: record not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/newsletter_subscribers":
    post:
      summary: Subscribe to the newsletter
      tags:
      - Newsletter Subscribers
      security:
      - api_key: []
      description: |
        Subscribes an email address to the newsletter for the current store.

        Behavior:

        - If the email is already verified for this store, the existing subscription is returned unchanged.
        - If the request is unauthenticated (guest), the subscription is created in an unverified state
          and two events are published: `newsletter_subscriber.subscription_requested` (carrying the
          `verification_token` and the validated `redirect_url`, intended for headless storefronts that
          want to send the confirmation email themselves via a webhook handler) and the legacy
          `newsletter_subscriber.subscribed` lifecycle event (which the bundled `spree_emails` package
          listens to and uses to send a default confirmation email). The confirmation link should point
          at `redirect_url?token=<verification_token>` and call `POST /newsletter_subscribers/verify`
          when the user clicks it.
        - If the request is authenticated via JWT and the customer's email matches the subscribed email,
          the subscription is auto-verified and no events are fired — the JWT already proves email
          ownership, so no confirmation email is needed.

        The optional `redirect_url` is where the verification token should land on the storefront. The
        server does not return a validation error when the URL is outside the store's
        [Allowed Origins](/developer/core-concepts/allowed-origins); instead, the URL is silently
        omitted from the webhook payload (secure-by-default). When no allow-list is configured on the
        store, the URL is also omitted. Callers therefore receive the same 201 regardless, and the
        webhook handler should fall back to the store's storefront URL when `redirect_url` is missing
        from the payload.

        Newsletter consent is preserved across registration: if a guest subscribes and later registers
        with the same email, the existing subscriber record is reused.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const subscriber = await client.newsletterSubscribers.create({
            email: 'subscriber@example.com',
            redirect_url: 'https://your-store.com/newsletter/confirm',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Optional Bearer JWT — when present, links the subscription to
          that customer
        schema:
          type: string
      responses:
        '201':
          description: auto-verified when JWT matches subscribed email
          content:
            application/json:
              example:
                id: sub_UkLWZg9DAJ
                email: phung.sawayn@carterfunk.ca
                created_at: '2026-01-15T12:00:00.000Z'
                updated_at: '2026-01-15T12:00:00.000Z'
                verified: true
                verified_at: '2026-01-15T12:00:00Z'
                customer_id: cust_UkLWZg9DAJ
              schema:
                "$ref": "#/components/schemas/NewsletterSubscriber"
        '422':
          description: invalid email format
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Email is invalid
                  details:
                    email:
                    - is invalid
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateNewsletterSubscriberParams"
        required: true
  "/api/v3/store/newsletter_subscribers/verify":
    post:
      summary: Verify a newsletter subscription
      tags:
      - Newsletter Subscribers
      security:
      - api_key: []
      description: |
        Confirms a pending newsletter subscription using the verification token sent by email.

        After successful verification:
        - The subscriber record is marked verified.
        - If the subscription is associated with a customer, that customer's `accepts_email_marketing`
          flag is set to `true`.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const subscriber = await client.newsletterSubscribers.verify({
            token: 'abc123def456',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: subscription verified
          content:
            application/json:
              example:
                id: sub_UkLWZg9DAJ
                email: pending@example.com
                created_at: '2026-01-15T12:00:00.000Z'
                updated_at: '2026-01-15T12:00:00.000Z'
                verified: true
                verified_at: '2026-01-15T12:00:00Z'
                customer_id:
              schema:
                "$ref": "#/components/schemas/NewsletterSubscriber"
        '422':
          description: missing token
          content:
            application/json:
              example:
                error:
                  code: parameter_missing
                  message: token is required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/VerifyNewsletterSubscriberParams"
        required: true
  "/api/v3/store/newsletter_subscribers/{id}":
    parameters:
    - name: id
      in: path
      description: Newsletter subscriber prefix id (sub_*)
      required: true
      schema:
        type: string
    delete:
      summary: Unsubscribe from the newsletter
      tags:
      - Newsletter Subscribers
      security:
      - api_key: []
      description: |
        Destroys the newsletter subscription, firing the `newsletter_subscriber.deleted`
        lifecycle event. Two authorization paths are accepted:

        - **Unsubscribe token** in the `?token=` query param — bearer delivered to the
          subscriber by email (the link in an unsubscribe message). The token is
          cryptographically signed and is cross-checked against the `:id` in the URL —
          tampering with either is rejected. To request such an email be sent, call the
          collection action `POST /newsletter_subscribers/request_unsubscribe` with the
          subscriber's email in the body.
        - **JWT bearer** for the logged-in customer who owns the subscription. No `token`
          query param is needed in this path.

        All failure modes return a generic `invalid_token` 422.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Optional Bearer JWT — alternative to the `token` query param
        schema:
          type: string
      - name: token
        in: query
        required: false
        description: Unsubscribe token delivered to the subscriber by email (e.g.
          the link in an unsubscribe message).
        schema:
          type: string
      responses:
        '204':
          description: unsubscribed via JWT (owner)
        '422':
          description: JWT-authenticated, subscriber on a different store
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Newsletter unsubscribe token is invalid or has expired.
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/newsletter_subscribers/request_unsubscribe":
    post:
      summary: Request an unsubscribe token
      tags:
      - Newsletter Subscribers
      security:
      - api_key: []
      description: |
        Publishes a `newsletter_subscriber.unsubscribe_requested` event carrying an unsubscribe token in the payload.
        Always returns 202 Accepted to prevent email enumeration.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '202':
          description: returns accepted even when email is missing
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/RequestNewsletterUnsubscribeParams"
  "/api/v3/store/orders/{order_id}/claims":
    parameters:
    - name: order_id
      in: path
      required: true
      description: Order prefixed ID
      schema:
        type: string
    get:
      summary: List claims
      tags:
      - Orders
      security:
      - api_key: []
        bearer_auth: []
      description: The damage or missing-item claims opened on one of the customer's
        orders, newest first. Accessible via JWT or the order token header for guests.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of number (partial, case-insensitive).
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `status` | One of `open`, `approved`, `resolved`, `denied`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `number`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Claim
        sortable:
        - created_at
        - id
        - number
        - status
        - updated_at
      responses:
        '200':
          description: claims listed
          content:
            application/json:
              example:
                data:
                - id: claim_UkLWZg9DAJ
                  number: CLM1001
                  status: open
                  resolution:
                  order_id: or_UkLWZg9DAJ
                  reason_id:
                  refund_total: '10.00'
                  display_refund_total: "$10.00"
                  approved_at:
                  resolved_at:
                  denied_at:
                  canceled_at:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Claim"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
    post:
      summary: Open a claim
      tags:
      - Orders
      security:
      - api_key: []
        bearer_auth: []
      description: Reports a damaged, missing or wrong item on one of the customer's
        orders. Approving, denying and resolving it are the merchant's. Accessible
        via JWT or the order token header for guests.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '201':
          description: claim opened
          content:
            application/json:
              example:
                id: claim_gbHJdmfrXB
                number: CLM1002
                status: open
                resolution:
                order_id: or_gbHJdmfrXB
                reason_id: clr_UkLWZg9DAJ
                refund_total: '0.00'
                display_refund_total: "$0.00"
                approved_at:
                resolved_at:
                denied_at:
                canceled_at:
              schema:
                "$ref": "#/components/schemas/Claim"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateClaimParams"
        required: true
  "/api/v3/store/orders/{id}":
    get:
      summary: Get an order
      tags:
      - Orders
      security:
      - api_key: []
        bearer_auth: []
      description: |
        Returns a completed purchase. Accessible via JWT (authenticated users) or order token header (guests).

        Resolves three kinds of id: the order's own (`or_…`), the id of the cart it was placed from, and the
        id of an order group (`ogrp_…`). The cart's id is the handle a storefront keeps through checkout, so
        a confirmation page can ask what its cart became without having learned a new one.

        A checkout that reached several sellers divided into one order per seller, and the cart moved up to
        the group holding them — so that handle, and the group's own id, answer with the **order group**,
        with the per-seller orders nested inside it. Every other lookup answers with an **order**. The two
        are told apart by the id prefix (`ogrp_` vs `or_`), or by the presence of `orders`.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const order = await client.orders.get(
            'or_abc123',
            {},
            {
              spreeToken: '<order-token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Prefixed ID of the order, of the cart it was placed from, or
          of its order group
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (items, fulfillments,
          payments, discounts, billing_address, shipping_address, gift_card). Use
          "none" to skip associations.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., total,amount_due,item_count).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: order found (guest via order token)
          content:
            application/json:
              example:
                id: or_UkLWZg9DAJ
                market_id: mkt_UkLWZg9DAJ
                withdrawal_period_ends_at:
                within_withdrawal_period: true
                shipping_eq_billing_address: false
                cart_id:
                channel_id: ch_UkLWZg9DAJ
                company_id:
                company_name:
                po_document_filename:
                po_document_byte_size:
                number: R1001
                email: guest@example.com
                customer_note:
                po_number:
                currency: USD
                locale: en
                total_quantity: 1
                coupon_code:
                fulfillment_status:
                payment_status:
                completed_at: '2026-01-15T12:00:00.000Z'
                item_total: '10.00'
                display_item_total: "$10.00"
                discount_total: '0.00'
                display_discount_total: "$0.00"
                tax_total: '0.00'
                display_tax_total: "$0.00"
                included_tax_total: '0.00'
                display_included_tax_total: "$0.00"
                additional_tax_total: '0.00'
                display_additional_tax_total: "$0.00"
                delivery_total: '100.00'
                display_delivery_total: "$100.00"
                fee_total: '12.00'
                display_fee_total: "$12.00"
                gift_card_total: '0.00'
                display_gift_card_total: "$0.00"
                store_credit_total: '0.00'
                display_store_credit_total: "$0.00"
                total: '122.00'
                display_total: "$122.00"
                amount_due: '122.00'
                display_amount_due: "$122.00"
                covered_by_store_credit: false
                payments: []
                adjustment_total: '12.00'
                display_adjustment_total: "$12.00"
                discounts: []
                fees:
                - id: fee_UkLWZg9DAJ
                  label: Import duty
                  kind: duty
                  line_item_id:
                  fulfillment_id:
                  amount: '12.00'
                  display_amount: "$12.00"
                items:
                - id: li_UkLWZg9DAJ
                  variant_id: variant_UkLWZg9DAJ
                  seller_id:
                  preorder: false
                  preorder_ships_at:
                  quantity: 1
                  currency: USD
                  name: Product 421496
                  slug: product-421496
                  options_text: ''
                  price: '10.00'
                  display_price: "$10.00"
                  total: '10.00'
                  display_total: "$10.00"
                  adjustment_total: '0.00'
                  display_adjustment_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  pre_tax_amount: '10.00'
                  display_pre_tax_amount: "$10.00"
                  discounted_amount: '10.00'
                  display_discounted_amount: "$10.00"
                  display_compare_at_amount: "$0.00"
                  compare_at_amount:
                  thumbnail_url:
                  option_values: []
                  digital_links: []
                fulfillments:
                - id: ful_UkLWZg9DAJ
                  number: R1001-F1
                  tracking: U10000
                  tracking_url:
                  pickup_point_data:
                  selected_delivery_rate_id: dr_gbHJdmfrXB
                  unpriced: false
                  cost: '100.00'
                  display_cost: "$100.00"
                  total: '100.00'
                  display_total: "$100.00"
                  discount_total: '0.00'
                  display_discount_total: "$0.00"
                  additional_tax_total: '0.00'
                  display_additional_tax_total: "$0.00"
                  included_tax_total: '0.00'
                  display_included_tax_total: "$0.00"
                  tax_total: '0.00'
                  display_tax_total: "$0.00"
                  status: unfulfilled
                  fulfillment_type: shipping
                  fulfilled_at:
                  delivered_at:
                  items:
                  - item_id: li_UkLWZg9DAJ
                    variant_id: variant_UkLWZg9DAJ
                    quantity: 1
                  deliveries:
                  - id: dlv_UkLWZg9DAJ
                    tracking_number: U10000
                    carrier:
                    carrier_name:
                    service:
                    status: pending
                    tracking_url:
                    estimated_delivery_at:
                    delivered_at:
                  delivery_method:
                    id: dm_UkLWZg9DAJ
                    name: UPS Ground 220
                    code: UPS_GROUND_239
                    estimated_transit_business_days_min:
                    estimated_transit_business_days_max:
                    digital: false
                    pickup: false
                    pickup_point: false
                  stock_location:
                    id: sloc_UkLWZg9DAJ
                    name: Thomasine Armstrong
                    address1: 1600 Pennsylvania Ave NW
                    city: Washington
                    zipcode: '20500'
                    country_code: US
                    country_name: United States
                    state_code: AL
                    state_text: AL
                    country_iso: US
                    state_abbr: AL
                    pickup_ready_in_minutes:
                    pickup_instructions:
                  delivery_rates:
                  - id: dr_gbHJdmfrXB
                    delivery_method_id: dm_UkLWZg9DAJ
                    name: UPS Ground 220
                    selected: true
                    cost: '10.00'
                    total: '10.00'
                    additional_tax_total: '0.00'
                    included_tax_total: '0.00'
                    tax_total: '0.00'
                    carrier:
                    service_level:
                    estimated_delivery_date:
                    unpriced: false
                    freight_summary:
                    display_cost: "$10.00"
                    display_total: "$10.00"
                    display_additional_tax_total: "$0.00"
                    display_included_tax_total: "$0.00"
                    display_tax_total: "$0.00"
                    delivery_method:
                      id: dm_UkLWZg9DAJ
                      name: UPS Ground 220
                      code: UPS_GROUND_239
                      estimated_transit_business_days_min:
                      estimated_transit_business_days_max:
                      digital: false
                      pickup: false
                      pickup_point: false
                billing_address:
                  id: addr_UkLWZg9DAJ
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 587 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                shipping_address:
                  id: addr_gbHJdmfrXB
                  label:
                  first_name: John
                  last_name: Doe
                  full_name: John Doe
                  address1: 588 Lovely Street
                  address2: Northwest
                  postal_code: '10118'
                  city: New York
                  phone: 555-555-0199
                  company: Company
                  country_name: United States
                  country_code: US
                  state_text: NY
                  state_code: NY
                  quick_checkout: false
                  is_default_billing: false
                  is_default_shipping: false
                  state_abbr: NY
                  country_iso: US
                  state_name: New York
                  owner:
                gift_card:
                market:
                  id: mkt_UkLWZg9DAJ
                  name: United States
                  currency: USD
                  default_locale: en
                  tax_inclusive: false
                  default: true
                  country_codes:
                  - US
                  country_isos:
                  - US
                  supported_locales:
                  - en
              schema:
                "$ref": "#/components/schemas/Order"
        '404':
          description: incomplete order not accessible
          content:
            application/json:
              example:
                error:
                  code: order_not_found
                  message: Order not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/orders/{order_id}/returns":
    parameters:
    - name: order_id
      in: path
      required: true
      description: Order prefixed ID
      schema:
        type: string
    get:
      summary: List returns
      tags:
      - Orders
      security:
      - api_key: []
        bearer_auth: []
      description: The returns opened on one of the customer's orders, newest first.
        Accessible via JWT or the order token header for guests.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of number (partial, case-insensitive).
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[number_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `number` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `status` | One of `requested`, `approved`, `received`, `refunded`, `canceled` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `number`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Return
        sortable:
        - created_at
        - id
        - number
        - status
        - updated_at
      responses:
        '200':
          description: returns listed
          content:
            application/json:
              example:
                data:
                - id: ret_UkLWZg9DAJ
                  number: RET1001
                  status: requested
                  order_id: or_UkLWZg9DAJ
                  reason_id:
                  refund_total: '10.00'
                  display_refund_total: "$10.00"
                  refund_tax_total: '0.00'
                  display_refund_tax_total: "$0.00"
                  approved_at:
                  received_at:
                  refunded_at:
                  canceled_at:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Return"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
    post:
      summary: Open a return
      tags:
      - Orders
      security:
      - api_key: []
        bearer_auth: []
      description: Opens a return for shipped units of one of the customer's orders.
        Approving, receiving and refunding it are the merchant's. Accessible via JWT
        or the order token header for guests.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: false
        description: Bearer token for authenticated customers
        schema:
          type: string
      - name: x-spree-token
        in: header
        required: false
        description: Order token for guest access
        schema:
          type: string
      responses:
        '201':
          description: return opened
          content:
            application/json:
              example:
                id: ret_gbHJdmfrXB
                number: RET1002
                status: requested
                order_id: or_gbHJdmfrXB
                reason_id: rar_UkLWZg9DAJ
                refund_total: '10.00'
                display_refund_total: "$10.00"
                refund_tax_total: '0.00'
                display_refund_tax_total: "$0.00"
                approved_at:
                received_at:
                refunded_at:
                canceled_at:
              schema:
                "$ref": "#/components/schemas/Return"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateReturnParams"
        required: true
  "/api/v3/store/policies":
    get:
      summary: List store policies
      tags:
      - Policies
      security:
      - api_key: []
      description: |
        Returns all policies for the current store (e.g., return policy, privacy policy, terms of service).
        Policies are managed in Spree Admin and contain rich text content.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const policies = await client.policies.list()
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of name (partial, case-insensitive).
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `owner_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `owner_type` | Type | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `name`, `owner_id`, `owner_type`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Policy
        sortable:
        - created_at
        - id
        - name
        - owner_id
        - owner_type
        - updated_at
      responses:
        '200':
          description: policies listed
          content:
            application/json:
              example:
                data:
                - id: pol_gbHJdmfrXB
                  name: Privacy Policy
                  slug: privacy-policy
                  body: ''
                  body_html: ''
                  updated_at: '2026-11-10T13:27:20.350Z'
                - id: pol_OIJLhNcSbf
                  name: Privacy Policy
                  slug: privacy-policy-f4e5666d-52c2-4d89-aec5-cc55d69c7174
                  body: We respect your privacy.
                  body_html: We respect your privacy.
                  updated_at: '2026-01-15T12:00:00.000Z'
                - id: pol_uw2YK1rnl0
                  name: Return Policy
                  slug: return-policy
                  body: You can return items within 30 days.
                  body_html: You can return items within 30 days.
                  updated_at: '2026-01-15T12:00:00.000Z'
                - id: pol_EfhxLZ9ck8
                  name: Returns Policy
                  slug: returns-policy
                  body: ''
                  body_html: ''
                  updated_at: '2026-11-10T13:27:20.359Z'
                - id: pol_VqXmZF31wY
                  name: Shipping Policy
                  slug: shipping-policy
                  body: ''
                  body_html: ''
                  updated_at: '2026-11-10T13:27:20.367Z'
                - id: pol_UkLWZg9DAJ
                  name: Terms of Service
                  slug: terms-of-service
                  body: ''
                  body_html: ''
                  updated_at: '2026-11-10T13:27:20.335Z'
                meta:
                  page: 1
                  limit: 25
                  count: 6
                  pages: 1
                  from: 1
                  to: 6
                  in: 6
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Policy"
                required:
                - data
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/policies/{id}":
    get:
      summary: Get a policy
      tags:
      - Policies
      security:
      - api_key: []
      description: Returns a single policy by slug or prefixed ID. Includes the full
        rich text body.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const policy = await client.policies.get('return-policy')
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Policy slug (e.g., return-policy) or prefixed ID (e.g., pol_abc123)
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include. id is always included.
        schema:
          type: string
      responses:
        '200':
          description: policy found
          content:
            application/json:
              example:
                id: pol_uw2YK1rnl0
                name: Return Policy
                slug: return-policy
                body: You can return items within 30 days.
                body_html: You can return items within 30 days.
                updated_at: '2026-01-15T12:00:00.000Z'
              schema:
                "$ref": "#/components/schemas/Policy"
        '404':
          description: policy not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Policy not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/categories":
    get:
      summary: List categories
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a paginated list of categories for the current store
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const categories = await client.categories.list({
            page: 1,
            limit: 25,
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of name and pretty name (partial, case-insensitive).
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `automatic` | True or false | `eq` `not_eq` `in` `not_in` `true` `false` `null` |
          | `children_count` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `depth` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `parent_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `permalink` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `position` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `pretty_name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `products_count` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `automatic`, `children_count`, `created_at`, `depth`, `id`, `name`, `parent_id`, `permalink`, `position`, `pretty_name`, `products_count`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Category
        sortable:
        - automatic
        - children_count
        - created_at
        - depth
        - id
        - name
        - parent_id
        - permalink
        - position
        - pretty_name
        - products_count
        - updated_at
      responses:
        '200':
          description: categories found
          content:
            application/json:
              example:
                data:
                - id: ctg_UkLWZg9DAJ
                  name: Catalog
                  permalink: catalog
                  position: 0
                  depth: 0
                  meta_title:
                  meta_description:
                  meta_keywords:
                  children_count: 1
                  parent_id:
                  description: ''
                  description_html: ''
                  image_url:
                  square_image_url:
                  is_root: true
                  is_child: false
                  is_leaf: false
                - id: ctg_gbHJdmfrXB
                  name: category_4
                  permalink: catalog/category-4
                  position: 0
                  depth: 1
                  meta_title:
                  meta_description:
                  meta_keywords:
                  children_count: 1
                  parent_id: ctg_UkLWZg9DAJ
                  description: ''
                  description_html: ''
                  image_url:
                  square_image_url:
                  is_root: false
                  is_child: true
                  is_leaf: false
                - id: ctg_EfhxLZ9ck8
                  name: category_5
                  permalink: catalog/category-4/category-5
                  position: 0
                  depth: 2
                  meta_title:
                  meta_description:
                  meta_keywords:
                  children_count: 0
                  parent_id: ctg_gbHJdmfrXB
                  description: ''
                  description_html: ''
                  image_url:
                  square_image_url:
                  is_root: false
                  is_child: true
                  is_leaf: true
                meta:
                  page: 1
                  limit: 25
                  count: 3
                  pages: 1
                  from: 1
                  to: 3
                  in: 3
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Category"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/categories/{id}":
    get:
      summary: Get a category
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a single category by permalink or prefix ID
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const category = await client.categories.get('categories/clothing/shirts', {
            expand: ['children'],
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Category permalink (e.g., clothing/shirts) or prefix ID (e.g.,
          ctg_abc123)
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Expand associations (children, parent, ancestors, custom_fields)
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: category found by prefix ID
          content:
            application/json:
              example:
                id: ctg_gbHJdmfrXB
                name: category_13
                permalink: catalog/category-13
                position: 0
                depth: 1
                meta_title:
                meta_description:
                meta_keywords:
                children_count: 1
                parent_id: ctg_UkLWZg9DAJ
                description: ''
                description_html: ''
                image_url:
                square_image_url:
                is_root: false
                is_child: true
                is_leaf: false
              schema:
                "$ref": "#/components/schemas/Category"
        '404':
          description: category from other store not accessible
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Category not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/collections":
    get:
      summary: List collections
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a paginated list of collections for the current store.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of name (partial, case-insensitive).
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,permalink).
          id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `automatic` | True or false | `eq` `not_eq` `in` `not_in` `true` `false` `null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `permalink` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `position` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `products_count` | Number | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `sort_order` | One of `manual`, `best_selling`, `price asc`, `price desc`, `available_on desc`, `available_on asc`, `name asc`, `name desc` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `automatic`, `created_at`, `id`, `name`, `permalink`, `position`, `products_count`, `sort_order`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Collection
        sortable:
        - automatic
        - created_at
        - id
        - name
        - permalink
        - position
        - products_count
        - sort_order
        - updated_at
      responses:
        '200':
          description: collections found
          content:
            application/json:
              example:
                data:
                - id: coll_UkLWZg9DAJ
                  name: Summer Sale
                  permalink: summer-sale
                  position: 1
                  sort_order: manual
                  meta_title:
                  meta_description:
                  meta_keywords:
                  products_count: 1
                  description: ''
                  description_html: ''
                  image_url:
                  square_image_url:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Collection"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/collections/{id}":
    get:
      summary: Get a collection
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a single collection by permalink or prefix ID.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Collection permalink (e.g., summer-sale) or prefix ID (e.g.,
          coll_abc123)
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Expand associations (custom_fields)
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include. id is always included.
        schema:
          type: string
      responses:
        '200':
          description: collection found by prefix ID
          content:
            application/json:
              example:
                id: coll_UkLWZg9DAJ
                name: Summer Sale
                permalink: summer-sale
                position: 1
                sort_order: manual
                meta_title:
                meta_description:
                meta_keywords:
                products_count: 1
                description: ''
                description_html: ''
                image_url:
                square_image_url:
              schema:
                "$ref": "#/components/schemas/Collection"
        '404':
          description: collection from other store not accessible
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Collection not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/collections/{collection_id}/products":
    get:
      summary: List collection products
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Products in the collection. Defaults to the collection's own sort
        order and accepts the same filters, sort, and pagination as the products endpoint.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: collection_id
        in: path
        required: true
        description: Collection permalink or prefix ID
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches product name or variant SKU (partial, case-insensitive),
          and the store's searchable custom fields.
      - name: q[ascend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `ascend_by_price`.
      - name: q[descend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `descend_by_price`.
      - name: q[in_categories][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Applies `in_categories` to the given value.
      - name: q[in_category]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_category` to the given value.
      - name: q[in_collection]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_collection` to the given value.
      - name: q[in_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `in_stock`.
      - name: q[in_taxon]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_taxon` to the given value.
      - name: q[not_discontinued]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `not_discontinued`.
      - name: q[out_of_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `out_of_stock`.
      - name: q[price_between][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: number
          minItems: 2
          maxItems: 2
        description: Applies `price_between` to the given value.
      - name: q[price_gte]
        in: query
        required: false
        schema:
          type: number
        description: Applies `price_gte` to the given value.
      - name: q[price_lte]
        in: query
        required: false
        schema:
          type: number
        description: Applies `price_lte` to the given value.
      - name: q[search_by_name]
        in: query
        required: false
        schema:
          type: string
        description: Applies `search_by_name` to the given value.
      - name: q[with_option_value_ids][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Applies `with_option_value_ids` to the given value.
      - name: sort
        in: query
        required: false
        description: Sort order (e.g., price, -price). Defaults to the collection's
          sort_order.
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `available_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `description` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `discontinue_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `price` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `slug` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `status` | One of `draft`, `active`, `archived`, `proposed`, `rejected` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          <Accordion title="Filters through associations">

          Prefix an associated record's attribute with the association, as in `q[categories_id_eq]`. The same predicates apply.

          | Prefix | Attributes |
          |---|---|
          | `categories_` | `automatic`, `children_count`, `created_at`, `depth`, `id`, `name`, `parent_id`, `permalink`, `position`, `pretty_name`, `products_count`, `updated_at` |
          | `collections_` | `automatic`, `created_at`, `id`, `name`, `permalink`, `position`, `products_count`, `sort_order`, `updated_at` |
          | `tags_` | `created_at`, `id`, `name`, `updated_at` |

          </Accordion>

          Also filters and sorts on the store's searchable custom fields, as `q[cf_<namespace>_<key>_<predicate>]` and `sort=cf_<namespace>_<key>`.

          **Sort by:** `available_on`, `best_selling`, `created_at`, `description`, `discontinue_on`, `id`, `manual`, `name`, `price`, `seller_id`, `slug`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Product
        sortable:
        - available_on
        - best_selling
        - created_at
        - description
        - discontinue_on
        - id
        - manual
        - name
        - price
        - seller_id
        - slug
        - status
        - updated_at
        custom_fields: true
      responses:
        '200':
          description: products found
          content:
            application/json:
              example:
                data:
                - id: prod_UkLWZg9DAJ
                  name: Product 3836979
                  slug: product-3836979
                  meta_title:
                  meta_description:
                  meta_keywords:
                  variant_count: 1
                  available_on:
                  preorder_ships_at:
                  purchasable: true
                  preorder: false
                  in_stock: false
                  backorderable: true
                  available: true
                  description: Accusantium ex dicta error nemo ipsa vel eaque porro.
                    Laborum ipsam molestias iure aspernatur quos dolorem. Quia libero
                    odio nesciunt debitis eaque.
                  description_html: Accusantium ex dicta error nemo ipsa vel eaque
                    porro. Laborum ipsam molestias iure aspernatur quos dolorem. Quia
                    libero odio nesciunt debitis eaque.
                  default_variant_id: variant_UkLWZg9DAJ
                  buy_box_variant_id: variant_UkLWZg9DAJ
                  thumbnail_url:
                  tags: []
                  price:
                    id: price_UkLWZg9DAJ
                    currency: USD
                    amount: '19.99'
                    compare_at_amount:
                    amount_in_cents: 1999
                    compare_at_amount_in_cents:
                    display_amount: "$19.99"
                    display_compare_at_amount:
                    price_list_id:
                  original_price:
                  seller_id:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Product"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
  "/api/v3/store/products":
    get:
      summary: List products
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a paginated list of active products for the current store
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const products = await client.products.list({
            page: 1,
            limit: 25,
            sort: 'price',
            search: 'shirt',
            price_gte: '20',
            price_lte: '100',
            with_option_value_ids: ['optval_abc', 'optval_def'],
            expand: ['variants', 'media'],
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        description: Publishable API key
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches product name or variant SKU (partial, case-insensitive),
          and the store's searchable custom fields.
      - name: q[ascend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `ascend_by_price`.
      - name: q[descend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `descend_by_price`.
      - name: q[in_categories][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Category prefixed IDs; matches products in any of them, including
          descendants.
      - name: q[in_category]
        in: query
        required: false
        schema:
          type: string
        description: A category's prefixed ID; includes products in its descendants.
      - name: q[in_collection]
        in: query
        required: false
        schema:
          type: string
        description: A collection's prefixed ID.
      - name: q[in_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` for products available to buy.
      - name: q[in_taxon]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_taxon` to the given value.
      - name: q[not_discontinued]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `not_discontinued`.
      - name: q[out_of_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` for products that are sold out.
      - name: q[price_between][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: number
          minItems: 2
          maxItems: 2
        description: Lowest and highest price, in the current currency.
      - name: q[price_gte]
        in: query
        required: false
        schema:
          type: number
        description: Lowest price, in the current currency.
      - name: q[price_lte]
        in: query
        required: false
        schema:
          type: number
        description: Highest price, in the current currency.
      - name: q[search_by_name]
        in: query
        required: false
        schema:
          type: string
        description: Applies `search_by_name` to the given value.
      - name: q[with_option_value_ids][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Option value IDs (`optval_…`); matches products with any of them.
      - name: page
        in: query
        required: false
        description: 'Page number (default: 1)'
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        description: 'Number of items per page (default: 25, max: 100)'
        schema:
          type: integer
      - name: sort
        in: query
        required: false
        description: 'Sort order. Prefix with - for descending. Values: price, -price,
          best_selling, name, -name, -available_on, available_on'
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (variants, media, categories,
          option_types, seller, seller.policies)
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `available_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `description` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `discontinue_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `price` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `slug` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `status` | One of `draft`, `active`, `archived`, `proposed`, `rejected` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          <Accordion title="Filters through associations">

          Prefix an associated record's attribute with the association, as in `q[categories_id_eq]`. The same predicates apply.

          | Prefix | Attributes |
          |---|---|
          | `categories_` | `automatic`, `children_count`, `created_at`, `depth`, `id`, `name`, `parent_id`, `permalink`, `position`, `pretty_name`, `products_count`, `updated_at` |
          | `collections_` | `automatic`, `created_at`, `id`, `name`, `permalink`, `position`, `products_count`, `sort_order`, `updated_at` |
          | `tags_` | `created_at`, `id`, `name`, `updated_at` |

          </Accordion>

          Also filters and sorts on the store's searchable custom fields, as `q[cf_<namespace>_<key>_<predicate>]` and `sort=cf_<namespace>_<key>`.

          **Sort by:** `available_on`, `best_selling`, `created_at`, `description`, `discontinue_on`, `id`, `manual`, `name`, `price`, `seller_id`, `slug`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Product
        sortable:
        - available_on
        - best_selling
        - created_at
        - description
        - discontinue_on
        - id
        - manual
        - name
        - price
        - seller_id
        - slug
        - status
        - updated_at
        custom_fields: true
      responses:
        '200':
          description: products found
          content:
            application/json:
              example:
                data:
                - id: prod_UkLWZg9DAJ
                  name: Product 4319085
                  slug: product-4319085
                  meta_title:
                  meta_description:
                  meta_keywords:
                  variant_count: 2
                  available_on:
                  preorder_ships_at:
                  purchasable: true
                  preorder: false
                  in_stock: false
                  backorderable: true
                  available: true
                  description: A comfortable cotton t-shirt.
                  description_html: "<p>A <strong>comfortable</strong> cotton t-shirt.</p>"
                  default_variant_id: variant_UkLWZg9DAJ
                  buy_box_variant_id: variant_UkLWZg9DAJ
                  thumbnail_url:
                  tags: []
                  price:
                    id: price_UkLWZg9DAJ
                    currency: USD
                    amount: '19.99'
                    compare_at_amount:
                    amount_in_cents: 1999
                    compare_at_amount_in_cents:
                    display_amount: "$19.99"
                    display_compare_at_amount:
                    price_list_id:
                  original_price:
                  seller_id:
                - id: prod_gbHJdmfrXB
                  name: Product 4328209
                  slug: product-4328209
                  meta_title:
                  meta_description:
                  meta_keywords:
                  variant_count: 1
                  available_on:
                  preorder_ships_at:
                  purchasable: true
                  preorder: false
                  in_stock: false
                  backorderable: true
                  available: true
                  description: Quasi nostrum error iste autem recusandae consequuntur
                    consectetur. Dolorem ea officia rerum a. Asperiores et occaecati
                    laudantium deserunt modi reiciendis rem. Iste soluta tempora odit
                    voluptate cupiditate. Architecto nostrum aliquid est odit minima
                    repudiandae. Doloribus quos est in illum. Occaecati vero soluta
                    asperiores aliquam odio accusamus incidunt. Officia magnam fugiat
                    sint optio ipsa. Deserunt reiciendis aliquid architecto occaecati
                    rem maxime vero doloremque. Recusandae ipsum natus eius assumenda.
                  description_html: |-
                    Quasi nostrum error iste autem recusandae consequuntur consectetur. Dolorem ea officia rerum a. Asperiores et occaecati laudantium deserunt modi reiciendis rem. Iste soluta tempora odit voluptate cupiditate. Architecto nostrum aliquid est odit minima repudiandae.
                    Doloribus quos est in illum. Occaecati vero soluta asperiores aliquam odio accusamus incidunt. Officia magnam fugiat sint optio ipsa. Deserunt reiciendis aliquid architecto occaecati rem maxime vero doloremque. Recusandae ipsum natus eius assumenda.
                  default_variant_id: variant_EfhxLZ9ck8
                  buy_box_variant_id: variant_EfhxLZ9ck8
                  thumbnail_url:
                  tags: []
                  price:
                    id: price_EfhxLZ9ck8
                    currency: USD
                    amount: '19.99'
                    compare_at_amount:
                    amount_in_cents: 1999
                    compare_at_amount_in_cents:
                    display_amount: "$19.99"
                    display_compare_at_amount:
                    price_list_id:
                  original_price:
                  seller_id:
                meta:
                  page: 1
                  limit: 25
                  count: 2
                  pages: 1
                  from: 1
                  to: 2
                  in: 2
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Product"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
                required:
                - data
                - meta
        '401':
          description: unauthorized - invalid or missing API key
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/products/{id}":
    get:
      summary: Get a product
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: Returns a single product by slug or prefix ID
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const product = await client.products.get('spree-tote', {
            expand: ['variants', 'media'],
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        description: Publishable API key
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Product slug (e.g., spree-tote) or prefix ID (e.g., product_abc123)
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (variants, media, categories,
          option_types, prior_price, seller, seller.policies). On a marketplace, `seller`
          embeds the seller public profile and `seller.policies` adds their published
          legal documents; `seller_id` is present without either.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: product without prior_price expanded does not include field
          content:
            application/json:
              example:
                id: prod_UkLWZg9DAJ
                name: Product 4596885
                slug: product-4596885
                meta_title:
                meta_description:
                meta_keywords:
                variant_count: 2
                available_on:
                preorder_ships_at:
                purchasable: true
                preorder: false
                in_stock: false
                backorderable: true
                available: true
                description: A comfortable cotton t-shirt.
                description_html: "<p>A <strong>comfortable</strong> cotton t-shirt.</p>"
                default_variant_id: variant_UkLWZg9DAJ
                buy_box_variant_id: variant_UkLWZg9DAJ
                thumbnail_url:
                tags: []
                price:
                  id: price_UkLWZg9DAJ
                  currency: USD
                  amount: '19.99'
                  compare_at_amount:
                  amount_in_cents: 1999
                  compare_at_amount_in_cents:
                  display_amount: "$19.99"
                  display_compare_at_amount:
                  price_list_id:
                original_price:
                seller_id:
                prior_price:
                  id: _AXs1igzRC6
                  currency: USD
                  amount: '9.99'
                  amount_in_cents: 999
                  display_amount: "$9.99"
                  recorded_at: '2025-12-31T12:00:00Z'
              schema:
                "$ref": "#/components/schemas/Product"
        '404':
          description: draft product not visible
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Product not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/products/filters":
    get:
      summary: Get product filters
      tags:
      - Product Catalog
      security:
      - api_key: []
      description: |
        Returns available filters for products with their options and counts.
        Use this endpoint to build filter UIs for product listing pages.

        The filters are context-aware - when a category_id is provided, only filters
        relevant to products in that category are returned.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const filters = await client.products.filters({
            category_id: 'ctg_abc123',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        description: Publishable API key
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches product name or variant SKU (partial, case-insensitive),
          and the store's searchable custom fields.
      - name: q[ascend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `ascend_by_price`.
      - name: q[descend_by_price]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `descend_by_price`.
      - name: q[in_categories][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Applies `in_categories` to the given value.
      - name: q[in_category]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_category` to the given value.
      - name: q[in_collection]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_collection` to the given value.
      - name: q[in_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `in_stock`.
      - name: q[in_taxon]
        in: query
        required: false
        schema:
          type: string
        description: Applies `in_taxon` to the given value.
      - name: q[not_discontinued]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `not_discontinued`.
      - name: q[out_of_stock]
        in: query
        required: false
        schema:
          type: boolean
        description: Set to `true` to apply `out_of_stock`.
      - name: q[price_between][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: number
          minItems: 2
          maxItems: 2
        description: Applies `price_between` to the given value.
      - name: q[price_gte]
        in: query
        required: false
        schema:
          type: number
        description: Applies `price_gte` to the given value.
      - name: q[price_lte]
        in: query
        required: false
        schema:
          type: number
        description: Applies `price_lte` to the given value.
      - name: q[search_by_name]
        in: query
        required: false
        schema:
          type: string
        description: Applies `search_by_name` to the given value.
      - name: q[with_option_value_ids][]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
        description: Applies `with_option_value_ids` to the given value.
      - name: category_id
        in: query
        required: false
        description: Scope filters to products in this category (prefix ID)
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `available_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `description` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `discontinue_on` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `price` | Amount | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `seller_id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `slug` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `status` | One of `draft`, `active`, `archived`, `proposed`, `rejected` | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          <Accordion title="Filters through associations">

          Prefix an associated record's attribute with the association, as in `q[categories_id_eq]`. The same predicates apply.

          | Prefix | Attributes |
          |---|---|
          | `categories_` | `automatic`, `children_count`, `created_at`, `depth`, `id`, `name`, `parent_id`, `permalink`, `position`, `pretty_name`, `products_count`, `updated_at` |
          | `collections_` | `automatic`, `created_at`, `id`, `name`, `permalink`, `position`, `products_count`, `sort_order`, `updated_at` |
          | `tags_` | `created_at`, `id`, `name`, `updated_at` |

          </Accordion>

          Also filters and sorts on the store's searchable custom fields, as `q[cf_<namespace>_<key>_<predicate>]` and `sort=cf_<namespace>_<key>`.

          **Sort by:** `available_on`, `best_selling`, `created_at`, `description`, `discontinue_on`, `id`, `manual`, `name`, `price`, `seller_id`, `slug`, `status`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Product
        sortable:
        - available_on
        - best_selling
        - created_at
        - description
        - discontinue_on
        - id
        - manual
        - name
        - price
        - seller_id
        - slug
        - status
        - updated_at
        custom_fields: true
      responses:
        '200':
          description: filters scoped to category
          content:
            application/json:
              example:
                id:
                default_sort: manual
                total_count: 2
                filters:
                - id: price
                  type: price_range
                  min: '19.99'
                  max: '19.99'
                  currency: USD
                - id: availability
                  type: availability
                  options:
                  - id: in_stock
                    count: 2
                  - id: out_of_stock
                    count: 0
                - id: opt_UkLWZg9DAJ
                  type: option
                  name: size
                  label: Size
                  kind: dropdown
                  options:
                  - id: optval_UkLWZg9DAJ
                    name: small
                    label: S
                    position: 1
                    color_code:
                    image_url:
                    count: 1
                - id: categories
                  type: category
                  options:
                  - id: ctg_gbHJdmfrXB
                    name: Shirts
                    permalink: category-35/shirts
                    count: 2
                sort_options:
                - id: manual
                  label:
                - id: best_selling
                  label:
                - id: price
                  label:
                - id: "-price"
                  label:
                - id: "-available_on"
                  label:
                - id: available_on
                  label:
                - id: name
                  label:
                - id: "-name"
                  label:
              schema:
                type: object
                properties:
                  filters:
                    type: array
                    description: Available filters (price_range, availability, option,
                      category)
                    items:
                      type: object
                  sort_options:
                    type: array
                    description: Available sort options
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                      required:
                      - id
                  default_sort:
                    type: string
                    description: Default sort option ID
                  total_count:
                    type: integer
                    description: Total products matching current filters
                required:
                - filters
                - sort_options
                - default_sort
                - total_count
        '401':
          description: unauthorized - invalid or missing API key
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/sellers":
    get:
      summary: List sellers
      tags:
      - Sellers
      security:
      - api_key: []
      description: |
        Returns the sellers on this marketplace that a shopper can currently
        buy from. A seller still onboarding, suspended, or away on holiday is
        not listed — showing them would advertise a seller whose products
        cannot be bought.

        The payload is the seller's public profile only. Nothing about how the
        marketplace runs them — status, payout schedule, tax handling, contact
        addresses — is exposed here.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: q[search]
        in: query
        required: false
        schema:
          type: string
        description: Matches any of name (partial, case-insensitive).
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (`policies`, `custom_fields`).
          A seller's policies are their own published legal documents; `custom_fields`
          returns only fields marked storefront visible.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include. id is always included.
        schema:
          type: string
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `name`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Seller
        sortable:
        - created_at
        - id
        - name
        - updated_at
      responses:
        '200':
          description: sellers found
          content:
            application/json:
              example:
                data:
                - id: sel_UkLWZg9DAJ
                  name: Sparks Audio
                  slug: sparks-audio
                  about: ''
                  about_html: ''
                  logo_url:
                  square_logo_url:
                  cover_photo_url:
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Seller"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/sellers/{id}":
    get:
      summary: Get a seller
      tags:
      - Sellers
      security:
      - api_key: []
      description: |
        Returns a single seller's public profile, by slug or prefixed ID, so a
        storefront can route `/sellers/sparks-audio` without holding an id.

        A seller who cannot currently sell returns 404 rather than a profile.
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Seller slug (e.g., sparks-audio) or prefixed ID (e.g., sel_abc123)
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (`policies`, `custom_fields`).
          A seller's policies are their own published legal documents; `custom_fields`
          returns only fields marked storefront visible.
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include. id is always included.
        schema:
          type: string
      responses:
        '200':
          description: seller found by slug
          content:
            application/json:
              example:
                id: sel_UkLWZg9DAJ
                name: Sparks Audio
                slug: sparks-audio
                about: ''
                about_html: ''
                logo_url:
                square_logo_url:
                cover_photo_url:
                custom_fields:
                - id: cf_UkLWZg9DAJ
                  label: Navigation position
                  field_type: number
                  key: merchandising.navigation_position
                  value: '10.0'
              schema:
                "$ref": "#/components/schemas/Seller"
        '404':
          description: seller not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Seller not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/store":
    get:
      summary: Get the current store
      tags:
      - Store
      security:
      - api_key: []
      description: Returns the current store's name, default SEO metadata, logo, social
        accounts and customer support email, so a storefront can render its page metadata
        and structured data. Translated fields use the requested locale; one without
        a translation falls back to the store's default locale.
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const store = await client.store.get()

          const title = store.seo_title ?? store.name
          const description = store.meta_description
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: x-spree-locale
        in: header
        required: false
        description: Locale for translated values, e.g. `de`. Defaults to the store
          locale.
        schema:
          type: string
      responses:
        '200':
          description: store found
          content:
            application/json:
              example:
                id: store_UkLWZg9DAJ
                name: Spree Test Store
                seo_title:
                meta_description: Sample store description.
                meta_keywords:
                facebook: spreecommerce
                twitter: spreecommerce
                instagram: spreecommerce
                customer_support_email: support@example.com
                logo_url:
              schema:
                "$ref": "#/components/schemas/Store"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: invalid_token
                  message: Valid API key required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
  "/api/v3/store/wishlists":
    get:
      summary: List wishlists
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      description: Returns all wishlists for the authenticated customer
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const wishlists = await client.wishlists.list(
            {},
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      - name: q
        in: query
        required: false
        style: deepObject
        explode: true
        schema:
          type: object
          additionalProperties: true
        description: Attribute filters, as `q[<attribute>_<predicate>]=value`. See
          Filters above for the list.
      x-mint:
        content: |-
          ## Filters

          Filter with `q[<attribute>_<predicate>]=value`, for example `q[name_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).

          | Attribute | Kind | Predicates |
          |---|---|---|
          | `created_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |
          | `id` | Prefixed ID | `eq` `not_eq` `in` `not_in` `null` `not_null` |
          | `name` | Text | `eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank` |
          | `updated_at` | Date and time | `eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null` |

          **Sort by:** `created_at`, `id`, `name`, `updated_at`. Prefix a field with `-` to sort descending.
      x-spree-filters:
        table: Wishlist
        sortable:
        - created_at
        - id
        - name
        - updated_at
      responses:
        '200':
          description: wishlists found
          content:
            application/json:
              example:
                data:
                - id: wl_UkLWZg9DAJ
                  name: My Wishlist
                  token: Po2FxovL4CYgapsDQCvBKmwP
                  is_default: false
                  is_private: true
                meta:
                  page: 1
                  limit: 25
                  count: 1
                  pages: 1
                  from: 1
                  to: 1
                  in: 1
                  previous:
                  next:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      "$ref": "#/components/schemas/Wishlist"
                  meta:
                    "$ref": "#/components/schemas/PaginationMeta"
        '401':
          description: unauthorized
          content:
            application/json:
              example:
                error:
                  code: authentication_required
                  message: Authentication required
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    post:
      summary: Create a wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      description: Creates a new wishlist for the customer
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const wishlist = await client.wishlists.create(
            {
              name: 'Birthday Ideas',
              is_private: true,
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: wishlist created
          content:
            application/json:
              example:
                id: wl_gbHJdmfrXB
                name: Birthday Ideas
                token: 9QwEwKPqhv9b6g6vN3mSu4Pm
                is_default: false
                is_private: true
              schema:
                "$ref": "#/components/schemas/Wishlist"
        '422':
          description: validation error
          content:
            application/json:
              example:
                error:
                  code: validation_error
                  message: Name can't be blank
                  details:
                    name:
                    - can't be blank
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateWishlistParams"
        required: true
  "/api/v3/store/wishlists/{id}":
    get:
      summary: Get a wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const wishlist = await client.wishlists.get(
            'wl_abc123',
            {
              expand: ['items.product'],
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: expand
        in: query
        required: false
        description: Comma-separated associations to expand (eg items.product to get
          wishlist items with associated products)
        schema:
          type: string
      - name: fields
        in: query
        required: false
        description: Comma-separated list of fields to include (e.g., name,slug,price).
          id is always included.
        schema:
          type: string
      responses:
        '200':
          description: wishlist found
          content:
            application/json:
              example:
                id: wl_UkLWZg9DAJ
                name: My Wishlist
                token: MScw7Kpbgn8BpAxVkttfKab8
                is_default: false
                is_private: true
              schema:
                "$ref": "#/components/schemas/Wishlist"
        '404':
          description: wishlist not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Wishlist not found
              schema:
                "$ref": "#/components/schemas/ErrorResponse"
    patch:
      summary: Update a wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const wishlist = await client.wishlists.update(
            'wl_abc123',
            {
              name: 'Updated Name',
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: wishlist updated
          content:
            application/json:
              example:
                id: wl_UkLWZg9DAJ
                name: Updated Name
                token: AMc2ph626mbJo7u5VjvVs9CA
                is_default: false
                is_private: true
              schema:
                "$ref": "#/components/schemas/Wishlist"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateWishlistParams"
        required: true
    delete:
      summary: Delete a wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.wishlists.delete('wl_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: wishlist deleted
  "/api/v3/store/wishlists/{wishlist_id}/items":
    post:
      summary: Add item to wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      description: Adds a variant to the wishlist
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          const item = await client.wishlists.items.create(
            'wl_abc123',
            {
              variant_id: 'variant_abc123',
              quantity: 1,
            },
            {
              token: '<token>',
            },
          )
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: wishlist_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: item added
          content:
            application/json:
              example:
                id: wi_gbHJdmfrXB
                variant_id: variant_gbHJdmfrXB
                product_id: prod_gbHJdmfrXB
                wishlist_id: wl_UkLWZg9DAJ
                quantity: 1
                variant:
                  id: variant_gbHJdmfrXB
                  product_id: prod_gbHJdmfrXB
                  sku: SKU-594
                  options_text: ''
                  track_inventory: true
                  media_count: 0
                  preorder_ships_at:
                  thumbnail_url:
                  purchasable: true
                  in_stock: false
                  backorderable: true
                  preorder: false
                  weight: 0.0
                  height:
                  width:
                  depth:
                  weight_unit: lb
                  dimensions_unit: in
                  minimum_order_quantity: 1
                  order_multiple: 1
                  purchase_unit: unit
                  units_per_carton:
                  price:
                    id: price_gbHJdmfrXB
                    currency: USD
                    amount: '19.99'
                    compare_at_amount:
                    amount_in_cents: 1999
                    compare_at_amount_in_cents:
                    display_amount: "$19.99"
                    display_compare_at_amount:
                    price_list_id:
                  original_price:
                  seller_id:
                  option_values: []
              schema:
                "$ref": "#/components/schemas/WishlistItem"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/CreateWishlistItemParams"
        required: true
  "/api/v3/store/wishlists/{wishlist_id}/items/{id}":
    patch:
      summary: Update a wishlist item
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      description: Changes the quantity of a wishlist item, or moves it to another
        variant
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: wishlist_id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: item updated
          content:
            application/json:
              example:
                id: wi_UkLWZg9DAJ
                variant_id: variant_UkLWZg9DAJ
                product_id: prod_UkLWZg9DAJ
                wishlist_id: wl_UkLWZg9DAJ
                quantity: 2
                variant:
                  id: variant_UkLWZg9DAJ
                  product_id: prod_UkLWZg9DAJ
                  sku: SKU-595
                  options_text: ''
                  track_inventory: true
                  media_count: 0
                  preorder_ships_at:
                  thumbnail_url:
                  purchasable: true
                  in_stock: false
                  backorderable: true
                  preorder: false
                  weight: 0.0
                  height:
                  width:
                  depth:
                  weight_unit: lb
                  dimensions_unit: in
                  minimum_order_quantity: 1
                  order_multiple: 1
                  purchase_unit: unit
                  units_per_carton:
                  price:
                    id: price_UkLWZg9DAJ
                    currency: USD
                    amount: '19.99'
                    compare_at_amount:
                    amount_in_cents: 1999
                    compare_at_amount_in_cents:
                    display_amount: "$19.99"
                    display_compare_at_amount:
                    price_list_id:
                  original_price:
                  seller_id:
                  option_values: []
              schema:
                "$ref": "#/components/schemas/WishlistItem"
      requestBody:
        content:
          application/json:
            schema:
              "$ref": "#/components/schemas/UpdateWishlistItemParams"
        required: true
    delete:
      summary: Remove item from wishlist
      tags:
      - Wishlists
      security:
      - api_key: []
        bearer_auth: []
      x-codeSamples:
      - lang: javascript
        label: Spree SDK
        source: |-
          import { createClient } from '@spree/sdk'

          const client = createClient({
            baseUrl: 'https://your-store.com',
            publishableKey: '<api-key>',
          })

          await client.wishlists.items.delete('wl_abc123', 'wi_abc123', {
            token: '<token>',
          })
      parameters:
      - name: x-spree-api-key
        in: header
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
      - name: wishlist_id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: item removed
        '404':
          description: item not found
          content:
            application/json:
              example:
                error:
                  code: record_not_found
                  message: Wishlist item not found
servers:
- url: http://{defaultHost}
  variables:
    defaultHost:
      default: localhost:3000
tags:
- name: Authentication
  description: Customer authentication (login, logout, token refresh)
- name: Carts
  description: Shopping cart management
- name: Channel
- name: Companies
- name: Customers
  description: Customer account, addresses, saved payment methods, and order history
- name: Delivery
- name: Digital Links
  description: Digital product downloads
- name: Markets
  description: Markets, countries, currencies, and locales
- name: Newsletter Subscribers
  description: Guest and customer newsletter subscriptions (double opt-in)
- name: Orders
  description: Order lookup
- name: Policies
  description: Store policies (return policy, privacy policy, terms of service)
- name: Product Catalog
  description: Products and categories
- name: Sellers
- name: Store
  description: The current store's name and default SEO metadata
- name: Wishlists
  description: Customer wishlists
components:
  securitySchemes:
    api_key:
      type: apiKey
      name: x-spree-api-key
      in: header
      description: Publishable API key for store access
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token for authenticated customers
  schemas:
    PaginationMeta:
      type: object
      properties:
        page:
          type: integer
          example: 1
        limit:
          type: integer
          example: 25
        count:
          type: integer
          example: 100
          description: Total number of records
        pages:
          type: integer
          example: 4
          description: Total number of pages
        from:
          type: integer
          example: 1
          description: Index of first record on this page
        to:
          type: integer
          example: 25
          description: Index of last record on this page
        in:
          type: integer
          example: 25
          description: Number of records on this page
        previous:
          type: integer
          nullable: true
          example:
          description: Previous page number
        next:
          type: integer
          nullable: true
          example: 2
          description: Next page number
      required:
      - page
      - limit
      - count
      - pages
      - from
      - to
      - in
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: record_not_found
            message:
              type: string
              example: Record not found
            details:
              type: object
              description: Field-specific validation errors
              nullable: true
              example:
                name:
                - is too short
                - is required
                email:
                - is invalid
          required:
          - code
          - message
      required:
      - error
      example:
        error:
          code: validation_error
          message: Validation failed
          details:
            name:
            - is too short
            email:
            - is invalid
    AuthResponse:
      type: object
      properties:
        token:
          type: string
          description: JWT access token
        refresh_token:
          type: string
          description: Refresh token for obtaining new access tokens
        user:
          "$ref": "#/components/schemas/Customer"
      required:
      - token
      - refresh_token
      - user
    PermissionRule:
      type: object
      description: A single permission rule (CanCanCan rule). Rules are applied in
        order, last-matching-wins.
      properties:
        allow:
          type: boolean
          description: true for `can`, false for `cannot`
        actions:
          type: array
          items:
            type: string
          description: Action names, e.g. ["read", "update"] or ["manage"]
        subjects:
          type: array
          items:
            type: string
          description: Subject short names, e.g. ["product"] or ["all"]
        has_conditions:
          type: boolean
          description: True if the server-side rule has per-record conditions. The
            SPA shows the action optimistically and handles 403 from the API.
      required:
      - allow
      - actions
      - subjects
      - has_conditions
    ImportSchemaField:
      type: object
      description: A canonical column of an import type, including per-store custom
        field columns
      properties:
        name:
          type: string
          description: Canonical field name used in mappings
          example: slug
        label:
          type: string
          description: Human-readable label
          example: Slug
        required:
          type: boolean
          description: Whether the field must be mapped before processing
      required:
      - name
      - label
      - required
    CheckoutRequirement:
      type: object
      properties:
        step:
          type: string
          description: Checkout step this requirement belongs to
          example: payment
        field:
          type: string
          description: Field that needs to be satisfied
          example: payment
        message:
          type: string
          description: Human-readable requirement message
          example: Add a payment method
      required:
      - step
      - field
      - message
    CartWarning:
      type: object
      description: A warning about a cart issue (e.g., item removed due to stock change)
      properties:
        code:
          type: string
          description: Machine-readable warning code
          example: line_item_removed
        message:
          type: string
          description: Human-readable warning message
          example: Blue T-Shirt was removed because it was sold out
        line_item_id:
          type: string
          nullable: true
          description: Prefixed line item ID (when applicable)
          example: li_abc123
        variant_id:
          type: string
          nullable: true
          description: Prefixed variant ID (when applicable)
          example: variant_abc123
        item_index:
          type: integer
          nullable: true
          description: Position in the submitted items array, for warnings raised
            while applying a batch of item changes
          example: 1
      required:
      - code
      - message
    FulfillmentManifestItem:
      type: object
      description: An item within a fulfillment — which line item and how many units
        are in this fulfillment
      properties:
        item_id:
          type: string
          description: Line item ID
          example: li_abc123
        variant_id:
          type: string
          description: Variant ID
          example: variant_abc123
        quantity:
          type: integer
          description: Quantity in this fulfillment
          example: 2
      required:
      - item_id
      - variant_id
      - quantity
    AdminUserRoleAssignment:
      type: object
      description: A role assignment for the current store on a staff member
      properties:
        id:
          type: string
          description: Prefixed role ID
          example: role_abc123
        name:
          type: string
          description: Role name
          example: admin
      required:
      - id
      - name
    AdminUserStore:
      type: object
      description: A store the staff member can access through a role assignment
      properties:
        id:
          type: string
          description: Prefixed store ID
          example: store_abc123
        name:
          type: string
          description: Store name
          example: My Store
        code:
          type: string
          description: Store code
          example: my-store
      required:
      - id
      - name
      - code
    PreferenceSchema:
      type: object
      description: 'The JSON Schema (draft 2020-12) of a type''s `preferences`: one
        property per setting, with `format` (`money`, `currency`, `iso-country`, `prefixed-id`,
        …), `enum`, `default`, `x-spree-secret` for a secret and `x-spree-prefix`
        for an id list. Unknown keys are refused.'
      additionalProperties: true
      example:
        type: object
        properties:
          amount:
            type: string
            format: money
            default: '0.0'
        additionalProperties: false
    PromotionActionLineItem:
      type: object
      description: One row in a `create_line_items` action — the variant added to
        the order and how many
      properties:
        variant_id:
          type: string
          example: variant_abc123
        quantity:
          type: integer
          example: 1
      required:
      - variant_id
      - quantity
    AddressOwner:
      type: object
      properties:
        id:
          type: string
        type:
          anyOf:
          - type: string
            enum:
            - customer
            - company
            - seller
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        name:
          type: string
          nullable: true
      required:
      - id
      - type
      - name
      x-typelizer: true
    Address:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
          nullable: true
        first_name:
          type: string
          nullable: true
        last_name:
          type: string
          nullable: true
        full_name:
          type: string
        address1:
          type: string
          nullable: true
        address2:
          type: string
          nullable: true
        postal_code:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        phone:
          type: string
          nullable: true
        company:
          type: string
          nullable: true
        country_name:
          type: string
        country_code:
          type: string
          enum:
          - AD
          - AE
          - AF
          - AG
          - AI
          - AL
          - AM
          - AO
          - AR
          - AS
          - AT
          - AU
          - AW
          - AZ
          - BA
          - BB
          - BD
          - BE
          - BF
          - BG
          - BH
          - BI
          - BJ
          - BL
          - BM
          - BN
          - BO
          - BQ
          - BR
          - BS
          - BT
          - BW
          - BY
          - BZ
          - CA
          - CC
          - CD
          - CF
          - CG
          - CH
          - CI
          - CK
          - CL
          - CM
          - CN
          - CO
          - CR
          - CU
          - CV
          - CW
          - CX
          - CY
          - CZ
          - DE
          - DJ
          - DK
          - DM
          - DO
          - DZ
          - EC
          - EE
          - EG
          - ER
          - ES
          - ET
          - FI
          - FJ
          - FK
          - FM
          - FO
          - FR
          - GA
          - GB
          - GD
          - GE
          - GF
          - GG
          - GH
          - GI
          - GL
          - GM
          - GN
          - GP
          - GQ
          - GR
          - GT
          - GU
          - GW
          - GY
          - HK
          - HN
          - HR
          - HT
          - HU
          - ID
          - IE
          - IL
          - IM
          - IN
          - IQ
          - IR
          - IS
          - IT
          - JE
          - JM
          - JO
          - JP
          - KE
          - KG
          - KH
          - KI
          - KM
          - KN
          - KP
          - KR
          - KW
          - KY
          - KZ
          - LA
          - LB
          - LC
          - LI
          - LK
          - LR
          - LS
          - LT
          - LU
          - LV
          - LY
          - MA
          - MC
          - MD
          - ME
          - MF
          - MG
          - MH
          - MK
          - ML
          - MM
          - MN
          - MO
          - MP
          - MQ
          - MR
          - MS
          - MT
          - MU
          - MV
          - MW
          - MX
          - MY
          - MZ
          - NA
          - NC
          - NE
          - NF
          - NG
          - NI
          - NL
          - 'NO'
          - NP
          - NR
          - NU
          - NZ
          - OM
          - PA
          - PE
          - PF
          - PG
          - PH
          - PK
          - PL
          - PM
          - PN
          - PR
          - PS
          - PT
          - PW
          - PY
          - QA
          - RE
          - RO
          - RS
          - RU
          - RW
          - SA
          - SB
          - SC
          - SD
          - SE
          - SG
          - SH
          - SI
          - SJ
          - SK
          - SL
          - SM
          - SN
          - SO
          - SR
          - SS
          - ST
          - SV
          - SX
          - SY
          - SZ
          - TC
          - TD
          - TG
          - TH
          - TJ
          - TK
          - TL
          - TM
          - TN
          - TO
          - TR
          - TT
          - TV
          - TW
          - TZ
          - UA
          - UG
          - US
          - UY
          - UZ
          - VA
          - VC
          - VE
          - VG
          - VI
          - VN
          - VU
          - WF
          - WS
          - YE
          - YT
          - ZA
          - ZM
          - ZW
        state_text:
          type: string
          nullable: true
        state_code:
          type: string
          nullable: true
        quick_checkout:
          type: boolean
        is_default_billing:
          type: boolean
        is_default_shipping:
          type: boolean
        state_abbr:
          type: string
          nullable: true
          deprecated: true
        country_iso:
          type: string
          deprecated: true
        state_name:
          type: string
          nullable: true
        owner:
          allOf:
          - "$ref": "#/components/schemas/AddressOwner"
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - label
      - first_name
      - last_name
      - full_name
      - address1
      - address2
      - postal_code
      - city
      - phone
      - company
      - country_name
      - country_code
      - state_text
      - state_code
      - quick_checkout
      - is_default_billing
      - is_default_shipping
      - state_abbr
      - country_iso
      - state_name
      - owner
      x-typelizer: true
    AppliedPromotion:
      type: object
      properties:
        id:
          type: string
        promotion_id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
      required:
      - id
      - promotion_id
      - name
      - description
      - code
      - amount
      - display_amount
      x-typelizer: true
    Base:
      type: object
      properties:
        id:
          type: string
      required:
      - id
      x-typelizer: true
    Cart:
      type: object
      properties:
        id:
          type: string
        market_id:
          type: string
          nullable: true
        channel_id:
          type: string
          nullable: true
        preferred_stock_location_id:
          type: string
          nullable: true
        company_id:
          type: string
          nullable: true
        company_name:
          type: string
          nullable: true
        po_number_required:
          type: boolean
        po_document_filename:
          type: string
          nullable: true
        po_document_byte_size:
          type: number
          nullable: true
        number:
          type: string
          deprecated: true
        token:
          type: string
        email:
          type: string
          nullable: true
        customer_note:
          type: string
          nullable: true
        po_number:
          type: string
          nullable: true
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        locale:
          type: string
          nullable: true
          enum:
          - aa
          - ab
          - ae
          - af
          - ak
          - am
          - an
          - ar
          - as
          - av
          - ay
          - az
          - ba
          - be
          - bg
          - bh
          - bi
          - bm
          - bn
          - bo
          - br
          - bs
          - ca
          - ce
          - ch
          - co
          - cr
          - cs
          - cu
          - cv
          - cy
          - da
          - de
          - de-AT
          - de-CH
          - dv
          - dz
          - ee
          - el
          - en
          - en-AU
          - en-CA
          - en-GB
          - en-IN
          - en-NZ
          - en-US
          - eo
          - es
          - es-419
          - es-CL
          - es-EC
          - es-MX
          - et
          - eu
          - fa
          - ff
          - fi
          - fj
          - fo
          - fr
          - fr-CA
          - fy
          - ga
          - gd
          - gl
          - gn
          - gu
          - gv
          - ha
          - he
          - hi
          - ho
          - hr
          - ht
          - hu
          - hy
          - hz
          - ia
          - id
          - ie
          - ig
          - ii
          - ik
          - io
          - is
          - it
          - iu
          - ja
          - jv
          - ka
          - kg
          - ki
          - kj
          - kk
          - kl
          - km
          - kn
          - ko
          - kr
          - ks
          - ku
          - kv
          - kw
          - ky
          - la
          - lb
          - lg
          - li
          - ln
          - lo
          - lt
          - lu
          - lv
          - mg
          - mh
          - mi
          - mk
          - ml
          - mn
          - mr
          - ms
          - mt
          - my
          - na
          - nb
          - nd
          - ne
          - ng
          - nl
          - nn
          - 'no'
          - nr
          - nv
          - ny
          - oc
          - oj
          - om
          - or
          - os
          - pa
          - pi
          - pl
          - ps
          - pt
          - pt-BR
          - pt-PT
          - qu
          - rm
          - rn
          - ro
          - ru
          - rw
          - sa
          - sc
          - sd
          - se
          - sg
          - si
          - sk
          - sl
          - sl-SI
          - sm
          - sn
          - so
          - sq
          - sr
          - ss
          - st
          - su
          - sv
          - sw
          - ta
          - te
          - tg
          - th
          - ti
          - tk
          - tl
          - tn
          - to
          - tr
          - ts
          - tt
          - tw
          - ty
          - ug
          - uk
          - ur
          - uz
          - ve
          - vi
          - vo
          - wa
          - wo
          - xh
          - yi
          - yo
          - za
          - zh-CN
          - zh-HK
          - zh-TW
          - zu
        total_quantity:
          type: number
        warnings:
          type: array
          items:
            "$ref": "#/components/schemas/CartWarning"
        coupon_code:
          type: string
          nullable: true
        item_total:
          type: string
          nullable: true
          description: 'The line items: each price times its quantity, before discounts,
            fees and delivery.'
        display_item_total:
          type: string
          nullable: true
          description: "`item_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        discount_total:
          type: string
          nullable: true
          description: What promotions take off, as a negative amount. Manual discounts
            are not included.
        display_discount_total:
          type: string
          nullable: true
          description: "`discount_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        tax_total:
          type: string
          nullable: true
          description: All tax, both included in prices and added on top.
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
          description: Tax already included in the prices, as in a store whose prices
            are tax-inclusive.
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        additional_tax_total:
          type: string
          nullable: true
          description: Tax added on top of the prices.
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        delivery_total:
          type: string
          nullable: true
          description: What delivery costs, before delivery discounts.
        display_delivery_total:
          type: string
          nullable: true
          description: "`delivery_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        fee_total:
          type: string
          nullable: true
          description: Every fee charged, such as handling or a customs duty.
        display_fee_total:
          type: string
          nullable: true
          description: "`fee_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        gift_card_total:
          type: string
          nullable: true
          description: What a gift card pays.
        display_gift_card_total:
          type: string
          nullable: true
          description: "`gift_card_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        store_credit_total:
          type: string
          nullable: true
          description: What store credit pays, apart from gift cards.
        display_store_credit_total:
          type: string
          nullable: true
          description: "`store_credit_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        total:
          type: string
          nullable: true
          description: 'What the customer pays in all: items, delivery, fees and added
            tax, less discounts.'
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        amount_due:
          type: string
          nullable: true
          description: What is left to pay after payments and store credit.
        display_amount_due:
          type: string
          nullable: true
          description: "`amount_due` formatted with its currency symbol in the request's
            language."
          deprecated: true
        covered_by_store_credit:
          type: boolean
        payments:
          type: array
          items:
            "$ref": "#/components/schemas/Payment"
        adjustment_total:
          type: string
          nullable: true
          description: Every discount, fee and added tax together, as one amount.
        display_adjustment_total:
          type: string
          nullable: true
          description: "`adjustment_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        current_step:
          type: string
        completed_steps:
          type: array
          items:
            type: string
        requirements:
          type: array
          items:
            "$ref": "#/components/schemas/CheckoutRequirement"
        order_minimum:
          type: string
          nullable: true
        order_minimum_shortfall:
          type: string
          nullable: true
        below_order_minimum:
          type: boolean
          nullable: true
        freight_summary:
          allOf:
          - "$ref": "#/components/schemas/FreightSummary"
          nullable: true
        shipping_eq_billing_address:
          type: boolean
        discounts:
          type: array
          items:
            "$ref": "#/components/schemas/AppliedPromotion"
        fees:
          type: array
          items:
            "$ref": "#/components/schemas/Fee"
        items:
          type: array
          items:
            "$ref": "#/components/schemas/LineItem"
        fulfillments:
          type: array
          items:
            "$ref": "#/components/schemas/Fulfillment"
        billing_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        shipping_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        payment_methods:
          type: array
          items:
            "$ref": "#/components/schemas/PaymentMethod"
        gift_card:
          allOf:
          - "$ref": "#/components/schemas/GiftCard"
          nullable: true
        market:
          allOf:
          - "$ref": "#/components/schemas/Market"
          nullable: true
      required:
      - id
      - market_id
      - channel_id
      - preferred_stock_location_id
      - company_id
      - company_name
      - po_number_required
      - po_document_filename
      - po_document_byte_size
      - number
      - token
      - email
      - customer_note
      - po_number
      - currency
      - locale
      - total_quantity
      - warnings
      - coupon_code
      - item_total
      - display_item_total
      - discount_total
      - display_discount_total
      - tax_total
      - display_tax_total
      - included_tax_total
      - display_included_tax_total
      - additional_tax_total
      - display_additional_tax_total
      - delivery_total
      - display_delivery_total
      - fee_total
      - display_fee_total
      - gift_card_total
      - display_gift_card_total
      - store_credit_total
      - display_store_credit_total
      - total
      - display_total
      - amount_due
      - display_amount_due
      - covered_by_store_credit
      - payments
      - adjustment_total
      - display_adjustment_total
      - current_step
      - completed_steps
      - requirements
      - order_minimum
      - order_minimum_shortfall
      - below_order_minimum
      - freight_summary
      - shipping_eq_billing_address
      - discounts
      - fees
      - items
      - fulfillments
      - billing_address
      - shipping_address
      - payment_methods
      - gift_card
      - market
      x-typelizer: true
    Category:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        permalink:
          type: string
        position:
          type: number
        depth:
          type: number
        meta_title:
          type: string
          nullable: true
        meta_description:
          type: string
          nullable: true
        meta_keywords:
          type: string
          nullable: true
        children_count:
          type: number
        parent_id:
          type: string
          nullable: true
        description:
          type: string
        description_html:
          type: string
        image_url:
          type: string
          nullable: true
        square_image_url:
          type: string
          nullable: true
        is_root:
          type: boolean
        is_child:
          type: boolean
        is_leaf:
          type: boolean
        parent:
          "$ref": "#/components/schemas/Category"
        children:
          type: array
          items:
            "$ref": "#/components/schemas/Category"
        ancestors:
          type: array
          items:
            "$ref": "#/components/schemas/Category"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - permalink
      - position
      - depth
      - meta_title
      - meta_description
      - meta_keywords
      - children_count
      - parent_id
      - description
      - description_html
      - image_url
      - square_image_url
      - is_root
      - is_child
      - is_leaf
      x-typelizer: true
    Channel:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        code:
          type: string
        active:
          type: boolean
        default:
          type: boolean
        storefront_access:
          type: string
        guest_checkout:
          type: boolean
      required:
      - id
      - name
      - code
      - active
      - default
      - storefront_access
      - guest_checkout
      x-typelizer: true
    ClaimLineItem:
      type: object
      properties:
        id:
          type: string
        quantity:
          type: number
        send_replacement:
          type: boolean
        description:
          type: string
          nullable: true
        refund_amount:
          type: string
          nullable: true
        paid_amount:
          type: string
          nullable: true
        pre_tax_amount:
          type: string
          nullable: true
        included_tax_total:
          type: string
          nullable: true
        additional_tax_total:
          type: string
          nullable: true
        tax_total:
          type: string
          nullable: true
        display_refund_amount:
          type: string
          nullable: true
          description: "`refund_amount` formatted with its currency symbol in the
            request's language."
          deprecated: true
        variant_id:
          type: string
          nullable: true
        replacement_variant_id:
          type: string
          nullable: true
        line_item_id:
          type: string
          nullable: true
        variant:
          "$ref": "#/components/schemas/Variant"
      required:
      - id
      - quantity
      - send_replacement
      - description
      - refund_amount
      - paid_amount
      - pre_tax_amount
      - included_tax_total
      - additional_tax_total
      - tax_total
      - display_refund_amount
      - variant_id
      - replacement_variant_id
      - line_item_id
      x-typelizer: true
    ClaimReason:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        active:
          type: boolean
      required:
      - id
      - name
      - active
      x-typelizer: true
    Claim:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - open
            - approved
            - resolved
            - denied
            - canceled
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        resolution:
          type: string
          nullable: true
          enum:
          - refund
          - replacement
          - refund_and_replacement
        order_id:
          type: string
          nullable: true
        reason_id:
          type: string
          nullable: true
        refund_total:
          type: string
          nullable: true
        display_refund_total:
          type: string
          nullable: true
          description: "`refund_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        approved_at:
          type: string
          nullable: true
        resolved_at:
          type: string
          nullable: true
        denied_at:
          type: string
          nullable: true
        canceled_at:
          type: string
          nullable: true
        reason:
          "$ref": "#/components/schemas/ClaimReason"
        claim_line_items:
          type: array
          items:
            "$ref": "#/components/schemas/ClaimLineItem"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - number
      - status
      - resolution
      - order_id
      - reason_id
      - refund_total
      - display_refund_total
      - approved_at
      - resolved_at
      - denied_at
      - canceled_at
      x-typelizer: true
    Collection:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        permalink:
          type: string
        position:
          type: number
        sort_order:
          type: string
          enum:
          - manual
          - best_selling
          - price asc
          - price desc
          - available_on desc
          - available_on asc
          - name asc
          - name desc
        meta_title:
          type: string
          nullable: true
        meta_description:
          type: string
          nullable: true
        meta_keywords:
          type: string
          nullable: true
        products_count:
          type: number
        description:
          type: string
        description_html:
          type: string
        image_url:
          type: string
          nullable: true
        square_image_url:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - permalink
      - position
      - sort_order
      - meta_title
      - meta_description
      - meta_keywords
      - products_count
      - description
      - description_html
      - image_url
      - square_image_url
      x-typelizer: true
    CompanyInvitation:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        expires_at:
          type: string
          nullable: true
        company_id:
          type: string
        status:
          type: string
          enum:
          - pending
          - accepted
          - revoked
          - expired
      required:
      - id
      - email
      - expires_at
      - company_id
      - status
      x-typelizer: true
    CompanyMembership:
      type: object
      properties:
        id:
          type: string
        company_id:
          type: string
        customer_id:
          type: string
        email:
          type: string
          nullable: true
      required:
      - id
      - company_id
      - customer_id
      - email
      x-typelizer: true
    Company:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        kind:
          type: string
          enum:
          - company
          - division
        po_number_required:
          type: boolean
        parent_id:
          type: string
          nullable: true
        ancestors:
          type: array
          items:
            type: object
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - kind
      - po_number_required
      - parent_id
      - ancestors
      x-typelizer: true
    Country:
      type: object
      properties:
        iso:
          type: string
          enum:
          - AD
          - AE
          - AF
          - AG
          - AI
          - AL
          - AM
          - AO
          - AR
          - AS
          - AT
          - AU
          - AW
          - AZ
          - BA
          - BB
          - BD
          - BE
          - BF
          - BG
          - BH
          - BI
          - BJ
          - BL
          - BM
          - BN
          - BO
          - BQ
          - BR
          - BS
          - BT
          - BW
          - BY
          - BZ
          - CA
          - CC
          - CD
          - CF
          - CG
          - CH
          - CI
          - CK
          - CL
          - CM
          - CN
          - CO
          - CR
          - CU
          - CV
          - CW
          - CX
          - CY
          - CZ
          - DE
          - DJ
          - DK
          - DM
          - DO
          - DZ
          - EC
          - EE
          - EG
          - ER
          - ES
          - ET
          - FI
          - FJ
          - FK
          - FM
          - FO
          - FR
          - GA
          - GB
          - GD
          - GE
          - GF
          - GG
          - GH
          - GI
          - GL
          - GM
          - GN
          - GP
          - GQ
          - GR
          - GT
          - GU
          - GW
          - GY
          - HK
          - HN
          - HR
          - HT
          - HU
          - ID
          - IE
          - IL
          - IM
          - IN
          - IQ
          - IR
          - IS
          - IT
          - JE
          - JM
          - JO
          - JP
          - KE
          - KG
          - KH
          - KI
          - KM
          - KN
          - KP
          - KR
          - KW
          - KY
          - KZ
          - LA
          - LB
          - LC
          - LI
          - LK
          - LR
          - LS
          - LT
          - LU
          - LV
          - LY
          - MA
          - MC
          - MD
          - ME
          - MF
          - MG
          - MH
          - MK
          - ML
          - MM
          - MN
          - MO
          - MP
          - MQ
          - MR
          - MS
          - MT
          - MU
          - MV
          - MW
          - MX
          - MY
          - MZ
          - NA
          - NC
          - NE
          - NF
          - NG
          - NI
          - NL
          - 'NO'
          - NP
          - NR
          - NU
          - NZ
          - OM
          - PA
          - PE
          - PF
          - PG
          - PH
          - PK
          - PL
          - PM
          - PN
          - PR
          - PS
          - PT
          - PW
          - PY
          - QA
          - RE
          - RO
          - RS
          - RU
          - RW
          - SA
          - SB
          - SC
          - SD
          - SE
          - SG
          - SH
          - SI
          - SJ
          - SK
          - SL
          - SM
          - SN
          - SO
          - SR
          - SS
          - ST
          - SV
          - SX
          - SY
          - SZ
          - TC
          - TD
          - TG
          - TH
          - TJ
          - TK
          - TL
          - TM
          - TN
          - TO
          - TR
          - TT
          - TV
          - TW
          - TZ
          - UA
          - UG
          - US
          - UY
          - UZ
          - VA
          - VC
          - VE
          - VG
          - VI
          - VN
          - VU
          - WF
          - WS
          - YE
          - YT
          - ZA
          - ZM
          - ZW
        iso3:
          type: string
        name:
          type: string
          deprecated: true
        states_required:
          type: boolean
        zipcode_required:
          type: boolean
        states:
          type: array
          items:
            "$ref": "#/components/schemas/State"
        market:
          allOf:
          - "$ref": "#/components/schemas/Market"
          nullable: true
      required:
      - iso
      - iso3
      - name
      - states_required
      - zipcode_required
      x-typelizer: true
    CreditCard:
      type: object
      properties:
        id:
          type: string
        brand:
          type: string
        last4:
          type: string
        month:
          type: number
        year:
          type: number
        name:
          type: string
          nullable: true
        default:
          type: boolean
        gateway_payment_profile_id:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - brand
      - last4
      - month
      - year
      - name
      - default
      - gateway_payment_profile_id
      x-typelizer: true
    Currency:
      type: object
      properties:
        iso_code:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        name:
          type: string
          deprecated: true
        symbol:
          type: string
          deprecated: true
        decimal_places:
          type: number
      required:
      - iso_code
      - name
      - symbol
      - decimal_places
      x-typelizer: true
    CustomField:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        field_type:
          type: string
          enum:
          - short_text
          - long_text
          - rich_text
          - number
          - boolean
          - json
        key:
          type: string
        value: {}
      required:
      - id
      - label
      - field_type
      - key
      - value
      x-typelizer: true
    CustomerGroup:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
      - id
      - name
      x-typelizer: true
    Customer:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        first_name:
          type: string
          nullable: true
        last_name:
          type: string
          nullable: true
        phone:
          type: string
          nullable: true
        accepts_email_marketing:
          type: boolean
        email_marketing_consent_updated_at:
          type: string
          nullable: true
        full_name:
          type: string
        available_store_credit_total:
          type: string
        display_available_store_credit_total:
          type: string
          description: "`available_store_credit_total` formatted with its currency
            symbol in the request's language."
          deprecated: true
        addresses:
          type: array
          items:
            "$ref": "#/components/schemas/Address"
        default_billing_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        default_shipping_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        newsletter_subscriber:
          allOf:
          - "$ref": "#/components/schemas/NewsletterSubscriber"
          nullable: true
        customer_groups:
          type: array
          items:
            "$ref": "#/components/schemas/CustomerGroup"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - email
      - first_name
      - last_name
      - phone
      - accepts_email_marketing
      - email_marketing_consent_updated_at
      - full_name
      - available_store_credit_total
      - display_available_store_credit_total
      - addresses
      - default_billing_address
      - default_shipping_address
      - newsletter_subscriber
      - customer_groups
      x-typelizer: true
    DataRequestConfirmationRequestedEvent:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        kind:
          type: string
          enum:
          - access
          - erasure
        status:
          anyOf:
          - type: string
            enum:
            - awaiting_confirmation
            - pending
            - processing
            - completed
            - failed
            - lapsed
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        requested_at:
          type: string
          nullable: true
        completed_at:
          type: string
          nullable: true
        email:
          type: string
        confirmation_token:
          type: string
        store_id:
          type: string
        redirect_url:
          type: string
      required:
      - id
      - number
      - kind
      - status
      - requested_at
      - completed_at
      - email
      - confirmation_token
      - store_id
      x-typelizer: true
    DataRequestEvent:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        kind:
          type: string
          enum:
          - access
          - erasure
        status:
          anyOf:
          - type: string
            enum:
            - awaiting_confirmation
            - pending
            - processing
            - completed
            - failed
            - lapsed
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        requested_at:
          type: string
          nullable: true
        completed_at:
          type: string
          nullable: true
      required:
      - id
      - number
      - kind
      - status
      - requested_at
      - completed_at
      x-typelizer: true
    DataRequest:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        kind:
          type: string
          enum:
          - access
          - erasure
        status:
          anyOf:
          - type: string
            enum:
            - awaiting_confirmation
            - pending
            - processing
            - completed
            - failed
            - lapsed
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        requested_at:
          type: string
          nullable: true
        completed_at:
          type: string
          nullable: true
        expires_at:
          type: string
          nullable: true
        download_url:
          type: string
          nullable: true
      required:
      - id
      - number
      - kind
      - status
      - requested_at
      - completed_at
      - expires_at
      - download_url
      x-typelizer: true
    DeliveryMethod:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        code:
          type: string
          nullable: true
        estimated_transit_business_days_min:
          type: number
          nullable: true
        estimated_transit_business_days_max:
          type: number
          nullable: true
        digital:
          type: boolean
        pickup:
          type: boolean
        pickup_point:
          type: boolean
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - code
      - estimated_transit_business_days_min
      - estimated_transit_business_days_max
      - digital
      - pickup
      - pickup_point
      x-typelizer: true
    DeliveryRate:
      type: object
      properties:
        id:
          type: string
        delivery_method_id:
          type: string
        name:
          type: string
        selected:
          type: boolean
        cost:
          type: string
          nullable: true
        total:
          type: string
          nullable: true
        additional_tax_total:
          type: string
          nullable: true
        included_tax_total:
          type: string
          nullable: true
        tax_total:
          type: string
          nullable: true
        carrier:
          type: string
          nullable: true
        service_level:
          type: string
          nullable: true
        estimated_delivery_date:
          type: string
          nullable: true
        unpriced:
          type: boolean
        freight_summary:
          allOf:
          - "$ref": "#/components/schemas/FreightSummary"
          nullable: true
        display_cost:
          type: string
          nullable: true
          description: "`cost` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        delivery_method:
          "$ref": "#/components/schemas/DeliveryMethod"
      required:
      - id
      - delivery_method_id
      - name
      - selected
      - cost
      - total
      - additional_tax_total
      - included_tax_total
      - tax_total
      - carrier
      - service_level
      - estimated_delivery_date
      - unpriced
      - freight_summary
      - display_cost
      - display_total
      - display_additional_tax_total
      - display_included_tax_total
      - display_tax_total
      - delivery_method
      x-typelizer: true
    Delivery:
      type: object
      properties:
        id:
          type: string
        tracking_number:
          type: string
        carrier:
          type: string
          nullable: true
        carrier_name:
          type: string
          nullable: true
        service:
          type: string
          nullable: true
        status:
          type: string
          enum:
          - pending
          - pre_transit
          - in_transit
          - out_for_delivery
          - available_for_pickup
          - delivered
          - return_to_sender
          - failure
          - unknown
        tracking_url:
          type: string
          nullable: true
        estimated_delivery_at:
          type: string
          nullable: true
        delivered_at:
          type: string
          nullable: true
      required:
      - id
      - tracking_number
      - carrier
      - carrier_name
      - service
      - status
      - tracking_url
      - estimated_delivery_at
      - delivered_at
      x-typelizer: true
    DeliveryZoneMember:
      type: object
      properties:
        id:
          type: string
        member_type:
          type: string
          enum:
          - country
          - state
          - postal_code
        country_code:
          type: string
          nullable: true
          enum:
          - AD
          - AE
          - AF
          - AG
          - AI
          - AL
          - AM
          - AO
          - AR
          - AS
          - AT
          - AU
          - AW
          - AZ
          - BA
          - BB
          - BD
          - BE
          - BF
          - BG
          - BH
          - BI
          - BJ
          - BL
          - BM
          - BN
          - BO
          - BQ
          - BR
          - BS
          - BT
          - BW
          - BY
          - BZ
          - CA
          - CC
          - CD
          - CF
          - CG
          - CH
          - CI
          - CK
          - CL
          - CM
          - CN
          - CO
          - CR
          - CU
          - CV
          - CW
          - CX
          - CY
          - CZ
          - DE
          - DJ
          - DK
          - DM
          - DO
          - DZ
          - EC
          - EE
          - EG
          - ER
          - ES
          - ET
          - FI
          - FJ
          - FK
          - FM
          - FO
          - FR
          - GA
          - GB
          - GD
          - GE
          - GF
          - GG
          - GH
          - GI
          - GL
          - GM
          - GN
          - GP
          - GQ
          - GR
          - GT
          - GU
          - GW
          - GY
          - HK
          - HN
          - HR
          - HT
          - HU
          - ID
          - IE
          - IL
          - IM
          - IN
          - IQ
          - IR
          - IS
          - IT
          - JE
          - JM
          - JO
          - JP
          - KE
          - KG
          - KH
          - KI
          - KM
          - KN
          - KP
          - KR
          - KW
          - KY
          - KZ
          - LA
          - LB
          - LC
          - LI
          - LK
          - LR
          - LS
          - LT
          - LU
          - LV
          - LY
          - MA
          - MC
          - MD
          - ME
          - MF
          - MG
          - MH
          - MK
          - ML
          - MM
          - MN
          - MO
          - MP
          - MQ
          - MR
          - MS
          - MT
          - MU
          - MV
          - MW
          - MX
          - MY
          - MZ
          - NA
          - NC
          - NE
          - NF
          - NG
          - NI
          - NL
          - 'NO'
          - NP
          - NR
          - NU
          - NZ
          - OM
          - PA
          - PE
          - PF
          - PG
          - PH
          - PK
          - PL
          - PM
          - PN
          - PR
          - PS
          - PT
          - PW
          - PY
          - QA
          - RE
          - RO
          - RS
          - RU
          - RW
          - SA
          - SB
          - SC
          - SD
          - SE
          - SG
          - SH
          - SI
          - SJ
          - SK
          - SL
          - SM
          - SN
          - SO
          - SR
          - SS
          - ST
          - SV
          - SX
          - SY
          - SZ
          - TC
          - TD
          - TG
          - TH
          - TJ
          - TK
          - TL
          - TM
          - TN
          - TO
          - TR
          - TT
          - TV
          - TW
          - TZ
          - UA
          - UG
          - US
          - UY
          - UZ
          - VA
          - VC
          - VE
          - VG
          - VI
          - VN
          - VU
          - WF
          - WS
          - YE
          - YT
          - ZA
          - ZM
          - ZW
        state_code:
          type: string
          nullable: true
        postal_code_prefix:
          type: string
          nullable: true
        postal_code_from:
          type: string
          nullable: true
        postal_code_to:
          type: string
          nullable: true
        country_name:
          type: string
          nullable: true
        state_name:
          type: string
          nullable: true
      required:
      - id
      - member_type
      - country_code
      - state_code
      - postal_code_prefix
      - postal_code_from
      - postal_code_to
      - country_name
      - state_name
      x-typelizer: true
    DeliveryZone:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        members:
          type: array
          items:
            "$ref": "#/components/schemas/DeliveryZoneMember"
      required:
      - id
      - name
      - description
      x-typelizer: true
    DigitalAsset:
      type: object
      properties:
        id:
          type: string
        variant_id:
          type: string
          nullable: true
        filename:
          type: string
          nullable: true
        content_type:
          type: string
          nullable: true
      required:
      - id
      - variant_id
      - filename
      - content_type
      x-typelizer: true
    DigitalLink:
      type: object
      properties:
        id:
          type: string
        access_counter:
          type: number
        filename:
          type: string
        content_type:
          type: string
        download_url:
          type: string
        expires_at:
          type: string
          nullable: true
        authorizable:
          type: boolean
        expired:
          type: boolean
        access_limit_exceeded:
          type: boolean
      required:
      - id
      - access_counter
      - filename
      - content_type
      - download_url
      - expires_at
      - authorizable
      - expired
      - access_limit_exceeded
      x-typelizer: true
    Discount:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        kind:
          type: string
          enum:
          - promotion
          - manual
        code:
          type: string
          nullable: true
        value_type:
          type: string
          nullable: true
        value:
          type: string
          nullable: true
        promotion_id:
          type: string
          nullable: true
        line_item_id:
          type: string
          nullable: true
        fulfillment_id:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
      required:
      - id
      - label
      - kind
      - code
      - value_type
      - value
      - promotion_id
      - line_item_id
      - fulfillment_id
      - amount
      - display_amount
      x-typelizer: true
    ExchangeLineItem:
      type: object
      properties:
        id:
          type: string
        quantity:
          type: number
        received_quantity:
          type: number
        resellable:
          type: boolean
        original_price:
          type: string
          nullable: true
        new_variant_price:
          type: string
          nullable: true
        price_difference:
          type: string
          nullable: true
        original_tax_total:
          type: string
          nullable: true
        new_tax_total:
          type: string
          nullable: true
        original_variant_id:
          type: string
          nullable: true
        new_variant_id:
          type: string
          nullable: true
        line_item_id:
          type: string
          nullable: true
        fulfillment_item_id:
          type: string
          nullable: true
        original_variant:
          "$ref": "#/components/schemas/Variant"
        new_variant:
          "$ref": "#/components/schemas/Variant"
      required:
      - id
      - quantity
      - received_quantity
      - resellable
      - original_price
      - new_variant_price
      - price_difference
      - original_tax_total
      - new_tax_total
      - original_variant_id
      - new_variant_id
      - line_item_id
      - fulfillment_item_id
      x-typelizer: true
    Exchange:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - requested
            - approved
            - received
            - fulfilled
            - canceled
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        order_id:
          type: string
          nullable: true
        reason_id:
          type: string
          nullable: true
        price_difference:
          type: string
          nullable: true
        display_price_difference:
          type: string
          nullable: true
          description: "`price_difference` formatted with its currency symbol in the
            request's language."
          deprecated: true
        approved_at:
          type: string
          nullable: true
        received_at:
          type: string
          nullable: true
        fulfilled_at:
          type: string
          nullable: true
        canceled_at:
          type: string
          nullable: true
        reason:
          "$ref": "#/components/schemas/ReturnReason"
        exchange_line_items:
          type: array
          items:
            "$ref": "#/components/schemas/ExchangeLineItem"
      required:
      - id
      - number
      - status
      - order_id
      - reason_id
      - price_difference
      - display_price_difference
      - approved_at
      - received_at
      - fulfilled_at
      - canceled_at
      x-typelizer: true
    Export:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        format:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        type:
          type: string
          nullable: true
        user_id:
          type: string
          nullable: true
      required:
      - id
      - number
      - format
      - created_at
      - updated_at
      - type
      - user_id
      x-typelizer: true
    Fee:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        kind:
          anyOf:
          - type: string
            enum:
            - surcharge
            - handling
            - gift_wrap
            - cod
            - payment
            - duty
            - exchange
          - type: string
          description: What sort of charge this is. `duty` is a customs duty on a
            cross-border order and is not taxed; the other kinds are. Extensions may
            register further kinds.
        line_item_id:
          type: string
          nullable: true
        fulfillment_id:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
      required:
      - id
      - label
      - kind
      - line_item_id
      - fulfillment_id
      - amount
      - display_amount
      x-typelizer: true
    FileUpload:
      type: object
      properties:
        signed_id:
          type: string
        filename:
          type: string
        content_type:
          type: string
        byte_size:
          type: number
        visibility:
          type: string
          enum:
          - public
          - private
        expires_at:
          type: string
        upload:
          allOf:
          - "$ref": "#/components/schemas/FileUploadTarget"
          nullable: true
      required:
      - signed_id
      - filename
      - content_type
      - byte_size
      - visibility
      - expires_at
      - upload
      x-typelizer: true
    FileUploadTarget:
      type: object
      properties:
        method:
          type: string
        url:
          type: string
        headers:
          type: object
      required:
      - method
      - url
      - headers
      x-typelizer: true
    FreightSummary:
      type: object
      properties:
        total_units:
          type: number
        total_cartons:
          type: number
        total_pallets:
          type: number
          nullable: true
        total_volume:
          type: string
        total_weight:
          type: string
        complete:
          type: boolean
      required:
      - total_units
      - total_cartons
      - total_pallets
      - total_volume
      - total_weight
      - complete
      x-typelizer: true
    Fulfillment:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        tracking:
          type: string
          nullable: true
        tracking_url:
          type: string
          nullable: true
        pickup_point_data:
          type: object
          nullable: true
        selected_delivery_rate_id:
          type: string
          nullable: true
        unpriced:
          type: boolean
        cost:
          type: string
          nullable: true
        display_cost:
          type: string
          nullable: true
          description: "`cost` formatted with its currency symbol in the request's
            language."
          deprecated: true
        total:
          type: string
          nullable: true
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        discount_total:
          type: string
          nullable: true
        display_discount_total:
          type: string
          nullable: true
          description: "`discount_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        additional_tax_total:
          type: string
          nullable: true
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        tax_total:
          type: string
          nullable: true
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        status:
          anyOf:
          - type: string
            enum:
            - unfulfilled
            - fulfilled
            - delivered
            - canceled
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        fulfillment_type:
          type: string
          enum:
          - shipping
          - digital
          - pickup
          - pickup_point
        fulfilled_at:
          type: string
          nullable: true
        delivered_at:
          type: string
          nullable: true
        items:
          type: array
          items:
            "$ref": "#/components/schemas/FulfillmentManifestItem"
        deliveries:
          type: array
          items:
            "$ref": "#/components/schemas/Delivery"
        delivery_method:
          "$ref": "#/components/schemas/DeliveryMethod"
        stock_location:
          "$ref": "#/components/schemas/StockLocation"
        delivery_rates:
          type: array
          items:
            "$ref": "#/components/schemas/DeliveryRate"
        tax_lines:
          type: array
          items:
            "$ref": "#/components/schemas/TaxLine"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - number
      - tracking
      - tracking_url
      - pickup_point_data
      - selected_delivery_rate_id
      - unpriced
      - cost
      - display_cost
      - total
      - display_total
      - discount_total
      - display_discount_total
      - additional_tax_total
      - display_additional_tax_total
      - included_tax_total
      - display_included_tax_total
      - tax_total
      - display_tax_total
      - status
      - fulfillment_type
      - fulfilled_at
      - delivered_at
      - items
      - deliveries
      - delivery_method
      - stock_location
      - delivery_rates
      x-typelizer: true
    GiftCardBatch:
      type: object
      properties:
        id:
          type: string
        codes_count:
          type: number
        currency:
          type: string
          nullable: true
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        prefix:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        amount:
          type: string
          nullable: true
        expires_at:
          type: string
          nullable: true
        created_by_id:
          type: string
          nullable: true
      required:
      - id
      - codes_count
      - currency
      - prefix
      - created_at
      - updated_at
      - amount
      - expires_at
      - created_by_id
      x-typelizer: true
    GiftCard:
      type: object
      properties:
        id:
          type: string
        code:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - active
            - partially_redeemed
            - redeemed
            - canceled
            - expired
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        amount:
          type: string
          nullable: true
        amount_used:
          type: string
          nullable: true
        amount_authorized:
          type: string
          nullable: true
        amount_remaining:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_amount_used:
          type: string
          nullable: true
          description: "`amount_used` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_amount_remaining:
          type: string
          nullable: true
          description: "`amount_remaining` formatted with its currency symbol in the
            request's language."
          deprecated: true
        expires_at:
          type: string
          nullable: true
        redeemed_at:
          type: string
          nullable: true
        expired:
          type: boolean
        active:
          type: boolean
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - code
      - status
      - currency
      - amount
      - amount_used
      - amount_authorized
      - amount_remaining
      - display_amount
      - display_amount_used
      - display_amount_remaining
      - expires_at
      - redeemed_at
      - expired
      - active
      x-typelizer: true
    ImportRow:
      type: object
      properties:
        id:
          type: string
        row_number:
          type: number
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - processing
            - completed
            - failed
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        validation_errors:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        import_id:
          type: string
          nullable: true
        item_type:
          type: string
          nullable: true
        item_id:
          type: string
          nullable: true
      required:
      - id
      - row_number
      - status
      - validation_errors
      - created_at
      - updated_at
      - import_id
      - item_type
      - item_id
      x-typelizer: true
    Import:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        rows_count:
          type: number
        created_at:
          type: string
        updated_at:
          type: string
        type:
          type: string
          nullable: true
          description: 'Import type. Built-in: products, product_translations, customers,
            price_list_prices. Extensions may register more.'
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - mapping
            - completed_mapping
            - processing
            - completed
            - failed
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        store_id:
          type: string
          nullable: true
        seller_id:
          type: string
          nullable: true
        user_id:
          type: string
          nullable: true
      required:
      - id
      - number
      - rows_count
      - created_at
      - updated_at
      - type
      - status
      - store_id
      - seller_id
      - user_id
      x-typelizer: true
    Invitation:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - accepted
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        resource_type:
          type: string
          nullable: true
        inviter_type:
          type: string
          nullable: true
        invitee_type:
          type: string
          nullable: true
        resource_id:
          type: string
          nullable: true
        inviter_id:
          type: string
          nullable: true
        invitee_id:
          type: string
          nullable: true
        role_id:
          type: string
          nullable: true
        expires_at:
          type: string
          nullable: true
        accepted_at:
          type: string
          nullable: true
      required:
      - id
      - email
      - created_at
      - updated_at
      - status
      - resource_type
      - inviter_type
      - invitee_type
      - resource_id
      - inviter_id
      - invitee_id
      - role_id
      - expires_at
      - accepted_at
      x-typelizer: true
    LineItem:
      type: object
      properties:
        id:
          type: string
        variant_id:
          type: string
        seller_id:
          type: string
          nullable: true
        preorder:
          type: boolean
        preorder_ships_at:
          type: string
          nullable: true
        quantity:
          type: number
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        name:
          type: string
        slug:
          type: string
        options_text:
          type: string
        price:
          type: string
          nullable: true
          description: The price of one unit.
        display_price:
          type: string
          nullable: true
          description: "`price` formatted with its currency symbol in the request's
            language."
          deprecated: true
        total:
          type: string
          nullable: true
          description: 'What this line costs: price times quantity, with its discounts,
            fees and added tax.'
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        adjustment_total:
          type: string
          nullable: true
          description: This line's discounts, fees and added tax together.
        display_adjustment_total:
          type: string
          nullable: true
          description: "`adjustment_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        additional_tax_total:
          type: string
          nullable: true
          description: Tax added on top of the price.
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
          description: Tax already included in the price.
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        discount_total:
          type: string
          nullable: true
          description: What promotions take off this line, as a negative amount.
        display_discount_total:
          type: string
          nullable: true
          description: "`discount_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        pre_tax_amount:
          type: string
          nullable: true
          description: This line after discounts, without tax.
        display_pre_tax_amount:
          type: string
          nullable: true
          description: "`pre_tax_amount` formatted with its currency symbol in the
            request's language."
          deprecated: true
        discounted_amount:
          type: string
          nullable: true
          description: Price times quantity, after discounts.
        display_discounted_amount:
          type: string
          nullable: true
          description: "`discounted_amount` formatted with its currency symbol in
            the request's language."
          deprecated: true
        display_compare_at_amount:
          type: string
          nullable: true
          description: "`compare_at_amount` formatted with its currency symbol in
            the request's language."
          deprecated: true
        compare_at_amount:
          type: string
          nullable: true
          description: The compare-at price times quantity, or null when the variant
            has none.
        thumbnail_url:
          type: string
          nullable: true
        seller:
          "$ref": "#/components/schemas/Seller"
        option_values:
          type: array
          items:
            "$ref": "#/components/schemas/OptionValue"
        digital_links:
          type: array
          items:
            "$ref": "#/components/schemas/DigitalLink"
        tax_lines:
          type: array
          items:
            "$ref": "#/components/schemas/TaxLine"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - variant_id
      - seller_id
      - preorder
      - preorder_ships_at
      - quantity
      - currency
      - name
      - slug
      - options_text
      - price
      - display_price
      - total
      - display_total
      - adjustment_total
      - display_adjustment_total
      - additional_tax_total
      - display_additional_tax_total
      - included_tax_total
      - display_included_tax_total
      - discount_total
      - display_discount_total
      - pre_tax_amount
      - display_pre_tax_amount
      - discounted_amount
      - display_discounted_amount
      - display_compare_at_amount
      - compare_at_amount
      - thumbnail_url
      - option_values
      x-typelizer: true
    Locale:
      type: object
      properties:
        code:
          type: string
          enum:
          - aa
          - ab
          - ae
          - af
          - ak
          - am
          - an
          - ar
          - as
          - av
          - ay
          - az
          - ba
          - be
          - bg
          - bh
          - bi
          - bm
          - bn
          - bo
          - br
          - bs
          - ca
          - ce
          - ch
          - co
          - cr
          - cs
          - cu
          - cv
          - cy
          - da
          - de
          - de-AT
          - de-CH
          - dv
          - dz
          - ee
          - el
          - en
          - en-AU
          - en-CA
          - en-GB
          - en-IN
          - en-NZ
          - en-US
          - eo
          - es
          - es-419
          - es-CL
          - es-EC
          - es-MX
          - et
          - eu
          - fa
          - ff
          - fi
          - fj
          - fo
          - fr
          - fr-CA
          - fy
          - ga
          - gd
          - gl
          - gn
          - gu
          - gv
          - ha
          - he
          - hi
          - ho
          - hr
          - ht
          - hu
          - hy
          - hz
          - ia
          - id
          - ie
          - ig
          - ii
          - ik
          - io
          - is
          - it
          - iu
          - ja
          - jv
          - ka
          - kg
          - ki
          - kj
          - kk
          - kl
          - km
          - kn
          - ko
          - kr
          - ks
          - ku
          - kv
          - kw
          - ky
          - la
          - lb
          - lg
          - li
          - ln
          - lo
          - lt
          - lu
          - lv
          - mg
          - mh
          - mi
          - mk
          - ml
          - mn
          - mr
          - ms
          - mt
          - my
          - na
          - nb
          - nd
          - ne
          - ng
          - nl
          - nn
          - 'no'
          - nr
          - nv
          - ny
          - oc
          - oj
          - om
          - or
          - os
          - pa
          - pi
          - pl
          - ps
          - pt
          - pt-BR
          - pt-PT
          - qu
          - rm
          - rn
          - ro
          - ru
          - rw
          - sa
          - sc
          - sd
          - se
          - sg
          - si
          - sk
          - sl
          - sl-SI
          - sm
          - sn
          - so
          - sq
          - sr
          - ss
          - st
          - su
          - sv
          - sw
          - ta
          - te
          - tg
          - th
          - ti
          - tk
          - tl
          - tn
          - to
          - tr
          - ts
          - tt
          - tw
          - ty
          - ug
          - uk
          - ur
          - uz
          - ve
          - vi
          - vo
          - wa
          - wo
          - xh
          - yi
          - yo
          - za
          - zh-CN
          - zh-HK
          - zh-TW
          - zu
        name:
          type: string
          deprecated: true
        default:
          type: boolean
        rtl:
          type: boolean
      required:
      - code
      - name
      - default
      - rtl
      x-typelizer: true
    Market:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        default_locale:
          type: string
          enum:
          - aa
          - ab
          - ae
          - af
          - ak
          - am
          - an
          - ar
          - as
          - av
          - ay
          - az
          - ba
          - be
          - bg
          - bh
          - bi
          - bm
          - bn
          - bo
          - br
          - bs
          - ca
          - ce
          - ch
          - co
          - cr
          - cs
          - cu
          - cv
          - cy
          - da
          - de
          - de-AT
          - de-CH
          - dv
          - dz
          - ee
          - el
          - en
          - en-AU
          - en-CA
          - en-GB
          - en-IN
          - en-NZ
          - en-US
          - eo
          - es
          - es-419
          - es-CL
          - es-EC
          - es-MX
          - et
          - eu
          - fa
          - ff
          - fi
          - fj
          - fo
          - fr
          - fr-CA
          - fy
          - ga
          - gd
          - gl
          - gn
          - gu
          - gv
          - ha
          - he
          - hi
          - ho
          - hr
          - ht
          - hu
          - hy
          - hz
          - ia
          - id
          - ie
          - ig
          - ii
          - ik
          - io
          - is
          - it
          - iu
          - ja
          - jv
          - ka
          - kg
          - ki
          - kj
          - kk
          - kl
          - km
          - kn
          - ko
          - kr
          - ks
          - ku
          - kv
          - kw
          - ky
          - la
          - lb
          - lg
          - li
          - ln
          - lo
          - lt
          - lu
          - lv
          - mg
          - mh
          - mi
          - mk
          - ml
          - mn
          - mr
          - ms
          - mt
          - my
          - na
          - nb
          - nd
          - ne
          - ng
          - nl
          - nn
          - 'no'
          - nr
          - nv
          - ny
          - oc
          - oj
          - om
          - or
          - os
          - pa
          - pi
          - pl
          - ps
          - pt
          - pt-BR
          - pt-PT
          - qu
          - rm
          - rn
          - ro
          - ru
          - rw
          - sa
          - sc
          - sd
          - se
          - sg
          - si
          - sk
          - sl
          - sl-SI
          - sm
          - sn
          - so
          - sq
          - sr
          - ss
          - st
          - su
          - sv
          - sw
          - ta
          - te
          - tg
          - th
          - ti
          - tk
          - tl
          - tn
          - to
          - tr
          - ts
          - tt
          - tw
          - ty
          - ug
          - uk
          - ur
          - uz
          - ve
          - vi
          - vo
          - wa
          - wo
          - xh
          - yi
          - yo
          - za
          - zh-CN
          - zh-HK
          - zh-TW
          - zu
        tax_inclusive:
          type: boolean
        default:
          type: boolean
        country_codes:
          type: array
          items:
            type: string
            enum:
            - AD
            - AE
            - AF
            - AG
            - AI
            - AL
            - AM
            - AO
            - AR
            - AS
            - AT
            - AU
            - AW
            - AZ
            - BA
            - BB
            - BD
            - BE
            - BF
            - BG
            - BH
            - BI
            - BJ
            - BL
            - BM
            - BN
            - BO
            - BQ
            - BR
            - BS
            - BT
            - BW
            - BY
            - BZ
            - CA
            - CC
            - CD
            - CF
            - CG
            - CH
            - CI
            - CK
            - CL
            - CM
            - CN
            - CO
            - CR
            - CU
            - CV
            - CW
            - CX
            - CY
            - CZ
            - DE
            - DJ
            - DK
            - DM
            - DO
            - DZ
            - EC
            - EE
            - EG
            - ER
            - ES
            - ET
            - FI
            - FJ
            - FK
            - FM
            - FO
            - FR
            - GA
            - GB
            - GD
            - GE
            - GF
            - GG
            - GH
            - GI
            - GL
            - GM
            - GN
            - GP
            - GQ
            - GR
            - GT
            - GU
            - GW
            - GY
            - HK
            - HN
            - HR
            - HT
            - HU
            - ID
            - IE
            - IL
            - IM
            - IN
            - IQ
            - IR
            - IS
            - IT
            - JE
            - JM
            - JO
            - JP
            - KE
            - KG
            - KH
            - KI
            - KM
            - KN
            - KP
            - KR
            - KW
            - KY
            - KZ
            - LA
            - LB
            - LC
            - LI
            - LK
            - LR
            - LS
            - LT
            - LU
            - LV
            - LY
            - MA
            - MC
            - MD
            - ME
            - MF
            - MG
            - MH
            - MK
            - ML
            - MM
            - MN
            - MO
            - MP
            - MQ
            - MR
            - MS
            - MT
            - MU
            - MV
            - MW
            - MX
            - MY
            - MZ
            - NA
            - NC
            - NE
            - NF
            - NG
            - NI
            - NL
            - 'NO'
            - NP
            - NR
            - NU
            - NZ
            - OM
            - PA
            - PE
            - PF
            - PG
            - PH
            - PK
            - PL
            - PM
            - PN
            - PR
            - PS
            - PT
            - PW
            - PY
            - QA
            - RE
            - RO
            - RS
            - RU
            - RW
            - SA
            - SB
            - SC
            - SD
            - SE
            - SG
            - SH
            - SI
            - SJ
            - SK
            - SL
            - SM
            - SN
            - SO
            - SR
            - SS
            - ST
            - SV
            - SX
            - SY
            - SZ
            - TC
            - TD
            - TG
            - TH
            - TJ
            - TK
            - TL
            - TM
            - TN
            - TO
            - TR
            - TT
            - TV
            - TW
            - TZ
            - UA
            - UG
            - US
            - UY
            - UZ
            - VA
            - VC
            - VE
            - VG
            - VI
            - VN
            - VU
            - WF
            - WS
            - YE
            - YT
            - ZA
            - ZM
            - ZW
        country_isos:
          type: array
          items:
            type: string
          deprecated: true
        supported_locales:
          type: array
          items:
            type: string
            enum:
            - aa
            - ab
            - ae
            - af
            - ak
            - am
            - an
            - ar
            - as
            - av
            - ay
            - az
            - ba
            - be
            - bg
            - bh
            - bi
            - bm
            - bn
            - bo
            - br
            - bs
            - ca
            - ce
            - ch
            - co
            - cr
            - cs
            - cu
            - cv
            - cy
            - da
            - de
            - de-AT
            - de-CH
            - dv
            - dz
            - ee
            - el
            - en
            - en-AU
            - en-CA
            - en-GB
            - en-IN
            - en-NZ
            - en-US
            - eo
            - es
            - es-419
            - es-CL
            - es-EC
            - es-MX
            - et
            - eu
            - fa
            - ff
            - fi
            - fj
            - fo
            - fr
            - fr-CA
            - fy
            - ga
            - gd
            - gl
            - gn
            - gu
            - gv
            - ha
            - he
            - hi
            - ho
            - hr
            - ht
            - hu
            - hy
            - hz
            - ia
            - id
            - ie
            - ig
            - ii
            - ik
            - io
            - is
            - it
            - iu
            - ja
            - jv
            - ka
            - kg
            - ki
            - kj
            - kk
            - kl
            - km
            - kn
            - ko
            - kr
            - ks
            - ku
            - kv
            - kw
            - ky
            - la
            - lb
            - lg
            - li
            - ln
            - lo
            - lt
            - lu
            - lv
            - mg
            - mh
            - mi
            - mk
            - ml
            - mn
            - mr
            - ms
            - mt
            - my
            - na
            - nb
            - nd
            - ne
            - ng
            - nl
            - nn
            - 'no'
            - nr
            - nv
            - ny
            - oc
            - oj
            - om
            - or
            - os
            - pa
            - pi
            - pl
            - ps
            - pt
            - pt-BR
            - pt-PT
            - qu
            - rm
            - rn
            - ro
            - ru
            - rw
            - sa
            - sc
            - sd
            - se
            - sg
            - si
            - sk
            - sl
            - sl-SI
            - sm
            - sn
            - so
            - sq
            - sr
            - ss
            - st
            - su
            - sv
            - sw
            - ta
            - te
            - tg
            - th
            - ti
            - tk
            - tl
            - tn
            - to
            - tr
            - ts
            - tt
            - tw
            - ty
            - ug
            - uk
            - ur
            - uz
            - ve
            - vi
            - vo
            - wa
            - wo
            - xh
            - yi
            - yo
            - za
            - zh-CN
            - zh-HK
            - zh-TW
            - zu
        countries:
          type: array
          items:
            "$ref": "#/components/schemas/Country"
      required:
      - id
      - name
      - currency
      - default_locale
      - tax_inclusive
      - default
      - country_codes
      - country_isos
      - supported_locales
      x-typelizer: true
    MediaEvent:
      type: object
      properties:
        id:
          type: string
        viewable_id:
          type: string
        viewable_type:
          type: string
        media_type:
          type: string
          enum:
          - image
          - video
          - external_video
        position:
          type: number
          nullable: true
        alt:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
      required:
      - id
      - viewable_id
      - viewable_type
      - media_type
      - position
      - alt
      - created_at
      - updated_at
      x-typelizer: true
    Media:
      type: object
      properties:
        id:
          type: string
        product_id:
          type: string
          nullable: true
        variant_ids:
          type: array
          items:
            type: string
        position:
          type: number
        alt:
          type: string
          nullable: true
        media_type:
          type: string
          enum:
          - image
          - video
          - external_video
        external_video_url:
          type: string
          nullable: true
        focal_point_x:
          type: number
          nullable: true
        focal_point_y:
          type: number
          nullable: true
        video_provider:
          type: string
          nullable: true
        video_embed_url:
          type: string
          nullable: true
        video_url:
          type: string
          nullable: true
        poster_url:
          type: string
          nullable: true
        original_url:
          type: string
          nullable: true
        mini_url:
          type: string
          nullable: true
        small_url:
          type: string
          nullable: true
        medium_url:
          type: string
          nullable: true
        large_url:
          type: string
          nullable: true
        xlarge_url:
          type: string
          nullable: true
        og_image_url:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - product_id
      - variant_ids
      - position
      - alt
      - media_type
      - external_video_url
      - focal_point_x
      - focal_point_y
      - video_provider
      - video_embed_url
      - video_url
      - poster_url
      - original_url
      - mini_url
      - small_url
      - medium_url
      - large_url
      - xlarge_url
      - og_image_url
      x-typelizer: true
    NewsletterSubscriberRequestEvent:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        verification_token:
          type: string
        unsubscribe_token:
          type: string
        store_id:
          type: string
          nullable: true
        customer_id:
          type: string
          nullable: true
        redirect_url:
          type: string
      required:
      - id
      - email
      - unsubscribe_token
      - store_id
      - customer_id
      x-typelizer: true
    NewsletterSubscriber:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        verified:
          type: boolean
        verified_at:
          type: string
          nullable: true
        customer_id:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - email
      - created_at
      - updated_at
      - verified
      - verified_at
      - customer_id
      x-typelizer: true
    OptionType:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        label:
          type: string
        position:
          type: number
        kind:
          type: string
          enum:
          - dropdown
          - color_swatch
          - buttons
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - label
      - position
      - kind
      x-typelizer: true
    OptionValue:
      type: object
      properties:
        id:
          type: string
        option_type_id:
          type: string
        name:
          type: string
        label:
          type: string
        position:
          type: number
        color_code:
          type: string
          nullable: true
        option_type_name:
          type: string
        option_type_label:
          type: string
        image_url:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - option_type_id
      - name
      - label
      - position
      - color_code
      - option_type_name
      - option_type_label
      - image_url
      x-typelizer: true
    OrderGroup:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        email:
          type: string
          nullable: true
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        item_total:
          type: string
          nullable: true
          description: 'The line items: each price times its quantity, before discounts,
            fees and delivery.'
        display_item_total:
          type: string
          nullable: true
          description: "`item_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        discount_total:
          type: string
          nullable: true
          description: What promotions take off, as a negative amount. Manual discounts
            are not included.
        display_discount_total:
          type: string
          nullable: true
          description: "`discount_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        tax_total:
          type: string
          nullable: true
          description: All tax, both included in prices and added on top.
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
          description: Tax already included in the prices, as in a store whose prices
            are tax-inclusive.
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        additional_tax_total:
          type: string
          nullable: true
          description: Tax added on top of the prices.
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        delivery_total:
          type: string
          nullable: true
          description: What delivery costs, before delivery discounts.
        display_delivery_total:
          type: string
          nullable: true
          description: "`delivery_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        fee_total:
          type: string
          nullable: true
          description: Every fee charged, such as handling or a customs duty.
        display_fee_total:
          type: string
          nullable: true
          description: "`fee_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        gift_card_total:
          type: string
          nullable: true
          description: What a gift card pays.
        display_gift_card_total:
          type: string
          nullable: true
          description: "`gift_card_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        store_credit_total:
          type: string
          nullable: true
          description: What store credit pays, apart from gift cards.
        display_store_credit_total:
          type: string
          nullable: true
          description: "`store_credit_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        total:
          type: string
          nullable: true
          description: 'What the customer pays in all: items, delivery, fees and added
            tax, less discounts.'
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        amount_due:
          type: string
          nullable: true
          description: What is left to pay after payments and store credit.
        display_amount_due:
          type: string
          nullable: true
          description: "`amount_due` formatted with its currency symbol in the request's
            language."
          deprecated: true
        covered_by_store_credit:
          type: boolean
        payments:
          type: array
          items:
            "$ref": "#/components/schemas/Payment"
        fulfillment_status:
          type: string
          nullable: true
          enum:
          - backorder
          - canceled
          - partial
          - unfulfilled
          - fulfilled
          - delivered
          - pending
          - ready
          - shipped
        payment_status:
          type: string
          nullable: true
          enum:
          - none
          - authorized
          - partially_paid
          - paid
          - partially_refunded
          - refunded
          - overcharged
          - voided
        completed_at:
          type: string
          nullable: true
        billing_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        shipping_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        orders:
          type: array
          items:
            "$ref": "#/components/schemas/Order"
      required:
      - id
      - number
      - email
      - currency
      - item_total
      - display_item_total
      - discount_total
      - display_discount_total
      - tax_total
      - display_tax_total
      - included_tax_total
      - display_included_tax_total
      - additional_tax_total
      - display_additional_tax_total
      - delivery_total
      - display_delivery_total
      - fee_total
      - display_fee_total
      - gift_card_total
      - display_gift_card_total
      - store_credit_total
      - display_store_credit_total
      - total
      - display_total
      - amount_due
      - display_amount_due
      - covered_by_store_credit
      - payments
      - fulfillment_status
      - payment_status
      - completed_at
      - billing_address
      - shipping_address
      - orders
      x-typelizer: true
    Order:
      type: object
      properties:
        id:
          type: string
        market_id:
          type: string
          nullable: true
        withdrawal_period_ends_at:
          type: string
          nullable: true
        within_withdrawal_period:
          type: boolean
        shipping_eq_billing_address:
          type: boolean
        cart_id:
          type: string
          nullable: true
        channel_id:
          type: string
          nullable: true
        company_id:
          type: string
          nullable: true
        company_name:
          type: string
          nullable: true
        po_document_filename:
          type: string
          nullable: true
        po_document_byte_size:
          type: number
          nullable: true
        number:
          type: string
        email:
          type: string
        customer_note:
          type: string
          nullable: true
        po_number:
          type: string
          nullable: true
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        locale:
          type: string
          nullable: true
          enum:
          - aa
          - ab
          - ae
          - af
          - ak
          - am
          - an
          - ar
          - as
          - av
          - ay
          - az
          - ba
          - be
          - bg
          - bh
          - bi
          - bm
          - bn
          - bo
          - br
          - bs
          - ca
          - ce
          - ch
          - co
          - cr
          - cs
          - cu
          - cv
          - cy
          - da
          - de
          - de-AT
          - de-CH
          - dv
          - dz
          - ee
          - el
          - en
          - en-AU
          - en-CA
          - en-GB
          - en-IN
          - en-NZ
          - en-US
          - eo
          - es
          - es-419
          - es-CL
          - es-EC
          - es-MX
          - et
          - eu
          - fa
          - ff
          - fi
          - fj
          - fo
          - fr
          - fr-CA
          - fy
          - ga
          - gd
          - gl
          - gn
          - gu
          - gv
          - ha
          - he
          - hi
          - ho
          - hr
          - ht
          - hu
          - hy
          - hz
          - ia
          - id
          - ie
          - ig
          - ii
          - ik
          - io
          - is
          - it
          - iu
          - ja
          - jv
          - ka
          - kg
          - ki
          - kj
          - kk
          - kl
          - km
          - kn
          - ko
          - kr
          - ks
          - ku
          - kv
          - kw
          - ky
          - la
          - lb
          - lg
          - li
          - ln
          - lo
          - lt
          - lu
          - lv
          - mg
          - mh
          - mi
          - mk
          - ml
          - mn
          - mr
          - ms
          - mt
          - my
          - na
          - nb
          - nd
          - ne
          - ng
          - nl
          - nn
          - 'no'
          - nr
          - nv
          - ny
          - oc
          - oj
          - om
          - or
          - os
          - pa
          - pi
          - pl
          - ps
          - pt
          - pt-BR
          - pt-PT
          - qu
          - rm
          - rn
          - ro
          - ru
          - rw
          - sa
          - sc
          - sd
          - se
          - sg
          - si
          - sk
          - sl
          - sl-SI
          - sm
          - sn
          - so
          - sq
          - sr
          - ss
          - st
          - su
          - sv
          - sw
          - ta
          - te
          - tg
          - th
          - ti
          - tk
          - tl
          - tn
          - to
          - tr
          - ts
          - tt
          - tw
          - ty
          - ug
          - uk
          - ur
          - uz
          - ve
          - vi
          - vo
          - wa
          - wo
          - xh
          - yi
          - yo
          - za
          - zh-CN
          - zh-HK
          - zh-TW
          - zu
        total_quantity:
          type: number
        coupon_code:
          type: string
          nullable: true
        fulfillment_status:
          type: string
          nullable: true
          enum:
          - backorder
          - canceled
          - partial
          - unfulfilled
          - fulfilled
          - delivered
          - pending
          - ready
          - shipped
        payment_status:
          type: string
          nullable: true
          enum:
          - none
          - authorized
          - partially_paid
          - paid
          - partially_refunded
          - refunded
          - overcharged
          - voided
        completed_at:
          type: string
          nullable: true
        item_total:
          type: string
          nullable: true
          description: 'The line items: each price times its quantity, before discounts,
            fees and delivery.'
        display_item_total:
          type: string
          nullable: true
          description: "`item_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        discount_total:
          type: string
          nullable: true
          description: What promotions take off, as a negative amount. Manual discounts
            are not included.
        display_discount_total:
          type: string
          nullable: true
          description: "`discount_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        tax_total:
          type: string
          nullable: true
          description: All tax, both included in prices and added on top.
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
          description: Tax already included in the prices, as in a store whose prices
            are tax-inclusive.
        display_included_tax_total:
          type: string
          nullable: true
          description: "`included_tax_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        additional_tax_total:
          type: string
          nullable: true
          description: Tax added on top of the prices.
        display_additional_tax_total:
          type: string
          nullable: true
          description: "`additional_tax_total` formatted with its currency symbol
            in the request's language."
          deprecated: true
        delivery_total:
          type: string
          nullable: true
          description: What delivery costs, before delivery discounts.
        display_delivery_total:
          type: string
          nullable: true
          description: "`delivery_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        fee_total:
          type: string
          nullable: true
          description: Every fee charged, such as handling or a customs duty.
        display_fee_total:
          type: string
          nullable: true
          description: "`fee_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        gift_card_total:
          type: string
          nullable: true
          description: What a gift card pays.
        display_gift_card_total:
          type: string
          nullable: true
          description: "`gift_card_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        store_credit_total:
          type: string
          nullable: true
          description: What store credit pays, apart from gift cards.
        display_store_credit_total:
          type: string
          nullable: true
          description: "`store_credit_total` formatted with its currency symbol in
            the request's language."
          deprecated: true
        total:
          type: string
          nullable: true
          description: 'What the customer pays in all: items, delivery, fees and added
            tax, less discounts.'
        display_total:
          type: string
          nullable: true
          description: "`total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        amount_due:
          type: string
          nullable: true
          description: What is left to pay after payments and store credit.
        display_amount_due:
          type: string
          nullable: true
          description: "`amount_due` formatted with its currency symbol in the request's
            language."
          deprecated: true
        covered_by_store_credit:
          type: boolean
        payments:
          type: array
          items:
            "$ref": "#/components/schemas/Payment"
        adjustment_total:
          type: string
          nullable: true
          description: Every discount, fee and added tax together, as one amount.
        display_adjustment_total:
          type: string
          nullable: true
          description: "`adjustment_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        discounts:
          type: array
          items:
            "$ref": "#/components/schemas/AppliedPromotion"
        fees:
          type: array
          items:
            "$ref": "#/components/schemas/Fee"
        items:
          type: array
          items:
            "$ref": "#/components/schemas/LineItem"
        fulfillments:
          type: array
          items:
            "$ref": "#/components/schemas/Fulfillment"
        billing_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        shipping_address:
          allOf:
          - "$ref": "#/components/schemas/Address"
          nullable: true
        gift_card:
          allOf:
          - "$ref": "#/components/schemas/GiftCard"
          nullable: true
        market:
          allOf:
          - "$ref": "#/components/schemas/Market"
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - market_id
      - withdrawal_period_ends_at
      - within_withdrawal_period
      - shipping_eq_billing_address
      - cart_id
      - channel_id
      - company_id
      - company_name
      - po_document_filename
      - po_document_byte_size
      - number
      - email
      - customer_note
      - po_number
      - currency
      - locale
      - total_quantity
      - coupon_code
      - fulfillment_status
      - payment_status
      - completed_at
      - item_total
      - display_item_total
      - discount_total
      - display_discount_total
      - tax_total
      - display_tax_total
      - included_tax_total
      - display_included_tax_total
      - additional_tax_total
      - display_additional_tax_total
      - delivery_total
      - display_delivery_total
      - fee_total
      - display_fee_total
      - gift_card_total
      - display_gift_card_total
      - store_credit_total
      - display_store_credit_total
      - total
      - display_total
      - amount_due
      - display_amount_due
      - covered_by_store_credit
      - payments
      - adjustment_total
      - display_adjustment_total
      - discounts
      - fees
      - items
      - fulfillments
      - billing_address
      - shipping_address
      - gift_card
      - market
      x-typelizer: true
    PasswordResetRequestedEvent:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        reset_token:
          type: string
        store_id:
          type: string
          nullable: true
        redirect_url:
          type: string
      required:
      - id
      - email
      - reset_token
      - store_id
      x-typelizer: true
    PaymentMethod:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        type:
          type: string
          description: 'Payment method type. Built-in: check, store_credit, custom_payment_source_method,
            bogus (test only); payment provider gems register their own, for example
            stripe.'
        session_required:
          type: boolean
        source_required:
          type: boolean
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - description
      - type
      - session_required
      - source_required
      x-typelizer: true
    Payment:
      type: object
      properties:
        id:
          type: string
        payment_method_id:
          type: string
        response_code:
          type: string
          nullable: true
        number:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - checkout
            - processing
            - pending
            - completed
            - failed
            - void
            - invalid
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        source_type:
          type: string
          nullable: true
          enum:
          - credit_card
          - store_credit
          - payment_source
        source_id:
          type: string
          nullable: true
        source:
          anyOf:
          - "$ref": "#/components/schemas/CreditCard"
          - "$ref": "#/components/schemas/StoreCredit"
          - "$ref": "#/components/schemas/PaymentSource"
          nullable: true
        payment_method:
          "$ref": "#/components/schemas/PaymentMethod"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - payment_method_id
      - response_code
      - number
      - status
      - amount
      - display_amount
      - source_type
      - source_id
      - source
      - payment_method
      x-typelizer: true
    PaymentSession:
      type: object
      properties:
        id:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - processing
            - completed
            - failed
            - canceled
            - expired
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        external_id:
          type: string
        external_data:
          type: object
        customer_external_id:
          type: string
          nullable: true
        expires_at:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        payment_method_id:
          type: string
        order_id:
          type: string
          nullable: true
        cart_id:
          type: string
          nullable: true
        payment_method:
          "$ref": "#/components/schemas/PaymentMethod"
        payment:
          "$ref": "#/components/schemas/Payment"
      required:
      - id
      - status
      - currency
      - external_id
      - external_data
      - customer_external_id
      - expires_at
      - amount
      - payment_method_id
      - order_id
      - cart_id
      - payment_method
      x-typelizer: true
    PaymentSetupSession:
      type: object
      properties:
        id:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - processing
            - completed
            - failed
            - canceled
            - expired
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        external_id:
          type: string
          nullable: true
        external_client_secret:
          type: string
          nullable: true
        external_data:
          type: object
        payment_method_id:
          type: string
          nullable: true
        payment_source_id:
          type: string
          nullable: true
        payment_source_type:
          type: string
          nullable: true
        customer_id:
          type: string
          nullable: true
        payment_method:
          "$ref": "#/components/schemas/PaymentMethod"
      required:
      - id
      - status
      - external_id
      - external_client_secret
      - external_data
      - payment_method_id
      - payment_source_id
      - payment_source_type
      - customer_id
      - payment_method
      x-typelizer: true
    PaymentSource:
      type: object
      properties:
        id:
          type: string
        gateway_payment_profile_id:
          type: string
          nullable: true
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - gateway_payment_profile_id
      x-typelizer: true
    Policy:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
        body:
          type: string
          nullable: true
        body_html:
          type: string
          nullable: true
        updated_at:
          type: string
      required:
      - id
      - name
      - slug
      - body
      - body_html
      - updated_at
      x-typelizer: true
    PriceHistory:
      type: object
      properties:
        id:
          type: string
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        amount:
          type: string
          nullable: true
        amount_in_cents:
          type: number
          nullable: true
          deprecated: true
        display_amount:
          type: string
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        recorded_at:
          type: string
      required:
      - id
      - currency
      - amount
      - amount_in_cents
      - display_amount
      - recorded_at
      x-typelizer: true
    Price:
      type: object
      properties:
        id:
          type: string
        currency:
          type: string
          nullable: true
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        amount:
          type: string
          nullable: true
        compare_at_amount:
          type: string
          nullable: true
        amount_in_cents:
          type: number
          nullable: true
          deprecated: true
        compare_at_amount_in_cents:
          type: number
          nullable: true
          deprecated: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_compare_at_amount:
          type: string
          nullable: true
          description: "`compare_at_amount` formatted with its currency symbol in
            the request's language."
          deprecated: true
        price_list_id:
          type: string
          nullable: true
      required:
      - id
      - currency
      - amount
      - compare_at_amount
      - amount_in_cents
      - compare_at_amount_in_cents
      - display_amount
      - display_compare_at_amount
      - price_list_id
      x-typelizer: true
    ProductFilterAvailabilityOption:
      type: object
      properties:
        id:
          type: string
          enum:
          - in_stock
          - out_of_stock
        count:
          type: number
      required:
      - id
      - count
      x-typelizer: true
    ProductFilterAvailability:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - availability
        options:
          type: array
          items:
            "$ref": "#/components/schemas/ProductFilterAvailabilityOption"
      required:
      - id
      - type
      - options
      x-typelizer: true
    ProductFilterCategoryOption:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        permalink:
          type: string
        count:
          type: number
      required:
      - id
      - name
      - permalink
      - count
      x-typelizer: true
    ProductFilterCategory:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - category
        options:
          type: array
          items:
            "$ref": "#/components/schemas/ProductFilterCategoryOption"
      required:
      - id
      - type
      - options
      x-typelizer: true
    ProductFilterOption:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - option
        name:
          type: string
        label:
          type: string
        kind:
          type: string
          enum:
          - dropdown
          - color_swatch
          - buttons
        options:
          type: array
          items:
            "$ref": "#/components/schemas/ProductFilterOptionValue"
      required:
      - id
      - type
      - name
      - label
      - kind
      - options
      x-typelizer: true
    ProductFilterOptionValue:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        label:
          type: string
        position:
          type: number
        color_code:
          type: string
          nullable: true
        image_url:
          type: string
          nullable: true
        count:
          type: number
      required:
      - id
      - name
      - label
      - position
      - color_code
      - image_url
      - count
      x-typelizer: true
    ProductFilterPriceRange:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - price_range
        min:
          type: string
        max:
          type: string
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
      required:
      - id
      - type
      - min
      - max
      - currency
      x-typelizer: true
    ProductFilterSortOption:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
          nullable: true
      required:
      - id
      - label
      x-typelizer: true
    ProductFilters:
      type: object
      properties:
        id:
          type: string
        default_sort:
          type: string
        total_count:
          type: number
        filters:
          type: array
          items:
            type: object
        sort_options:
          type: array
          items:
            "$ref": "#/components/schemas/ProductFilterSortOption"
      required:
      - id
      - default_sort
      - total_count
      - filters
      - sort_options
      x-typelizer: true
    ProductPublication:
      type: object
      properties:
        id:
          type: string
        published_at:
          type: string
          nullable: true
        unpublished_at:
          type: string
          nullable: true
        product_id:
          type: string
        channel_id:
          type: string
      required:
      - id
      - published_at
      - unpublished_at
      - product_id
      - channel_id
      x-typelizer: true
    Product:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
        meta_title:
          type: string
          nullable: true
        meta_description:
          type: string
          nullable: true
        meta_keywords:
          type: string
          nullable: true
        variant_count:
          type: number
        available_on:
          type: string
          nullable: true
        preorder_ships_at:
          type: string
          nullable: true
        purchasable:
          type: boolean
        preorder:
          type: boolean
        in_stock:
          type: boolean
        backorderable:
          type: boolean
        available:
          type: boolean
        description:
          type: string
          nullable: true
        description_html:
          type: string
          nullable: true
        default_variant_id:
          type: string
        buy_box_variant_id:
          type: string
          nullable: true
        thumbnail_url:
          type: string
          nullable: true
        tags:
          type: array
          items:
            type: string
        price:
          "$ref": "#/components/schemas/Price"
        original_price:
          allOf:
          - "$ref": "#/components/schemas/Price"
          nullable: true
        seller_id:
          type: string
          nullable: true
        seller:
          "$ref": "#/components/schemas/Seller"
        primary_media:
          "$ref": "#/components/schemas/Media"
        media:
          type: array
          items:
            "$ref": "#/components/schemas/Media"
        variants:
          type: array
          items:
            "$ref": "#/components/schemas/Variant"
        default_variant:
          "$ref": "#/components/schemas/Variant"
        option_types:
          type: array
          items:
            "$ref": "#/components/schemas/OptionType"
        option_values:
          type: array
          items:
            "$ref": "#/components/schemas/OptionValue"
        categories:
          type: array
          items:
            "$ref": "#/components/schemas/Category"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
        prior_price:
          allOf:
          - "$ref": "#/components/schemas/PriceHistory"
          nullable: true
      required:
      - id
      - name
      - slug
      - meta_title
      - meta_description
      - meta_keywords
      - variant_count
      - available_on
      - preorder_ships_at
      - purchasable
      - preorder
      - in_stock
      - backorderable
      - available
      - description
      - description_html
      - default_variant_id
      - buy_box_variant_id
      - thumbnail_url
      - tags
      - price
      - original_price
      - seller_id
      x-typelizer: true
    ProductSubmission:
      type: object
      properties:
        id:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - pending
            - approved
            - rejected
            - withdrawn
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        review_note:
          type: string
          nullable: true
        reviewed_at:
          type: string
          nullable: true
        created_at:
          type: string
        product_id:
          type: string
      required:
      - id
      - status
      - review_note
      - reviewed_at
      - created_at
      - product_id
      x-typelizer: true
    ProductType:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
      - id
      - name
      x-typelizer: true
    Promotion:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
      required:
      - id
      - name
      - description
      - code
      x-typelizer: true
    PurchaseOrderEvent:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        status:
          type: string
        ordered_at:
          type: string
          nullable: true
        received_at:
          type: string
          nullable: true
        closed_short_at:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        supplier_id:
          type: string
          nullable: true
        destination_location_id:
          type: string
          nullable: true
      required:
      - id
      - number
      - status
      - ordered_at
      - received_at
      - closed_short_at
      - created_at
      - updated_at
      - supplier_id
      - destination_location_id
      x-typelizer: true
    Refund:
      type: object
      properties:
        id:
          type: string
        transaction_id:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        payment_id:
          type: string
          nullable: true
        refund_reason_id:
          type: string
          nullable: true
        originator_id:
          type: string
          nullable: true
        originator_type:
          type: string
          nullable: true
        reimbursement_id:
          type: string
          nullable: true
          deprecated: true
      required:
      - id
      - transaction_id
      - amount
      - payment_id
      - refund_reason_id
      - originator_id
      - originator_type
      - reimbursement_id
      x-typelizer: true
    ReturnLineItem:
      type: object
      properties:
        id:
          type: string
        quantity:
          type: number
        received_quantity:
          type: number
        resellable:
          type: boolean
        pre_tax_amount:
          type: string
          nullable: true
        display_pre_tax_amount:
          type: string
          nullable: true
          description: "`pre_tax_amount` formatted with its currency symbol in the
            request's language."
          deprecated: true
        included_tax_total:
          type: string
          nullable: true
        additional_tax_total:
          type: string
          nullable: true
        tax_total:
          type: string
          nullable: true
        display_tax_total:
          type: string
          nullable: true
          description: "`tax_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        refund_amount:
          type: string
          nullable: true
        display_refund_amount:
          type: string
          nullable: true
          description: "`refund_amount` formatted with its currency symbol in the
            request's language."
          deprecated: true
        variant_id:
          type: string
          nullable: true
        line_item_id:
          type: string
          nullable: true
        fulfillment_item_id:
          type: string
          nullable: true
        variant:
          "$ref": "#/components/schemas/Variant"
      required:
      - id
      - quantity
      - received_quantity
      - resellable
      - pre_tax_amount
      - display_pre_tax_amount
      - included_tax_total
      - additional_tax_total
      - tax_total
      - display_tax_total
      - refund_amount
      - display_refund_amount
      - variant_id
      - line_item_id
      - fulfillment_item_id
      x-typelizer: true
    ReturnReason:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        active:
          type: boolean
      required:
      - id
      - name
      - active
      x-typelizer: true
    Return:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - requested
            - approved
            - received
            - refunded
            - canceled
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        order_id:
          type: string
          nullable: true
        reason_id:
          type: string
          nullable: true
        refund_total:
          type: string
          nullable: true
        display_refund_total:
          type: string
          nullable: true
          description: "`refund_total` formatted with its currency symbol in the request's
            language."
          deprecated: true
        refund_tax_total:
          type: string
          nullable: true
        display_refund_tax_total:
          type: string
          nullable: true
          description: "`refund_tax_total` formatted with its currency symbol in the
            request's language."
          deprecated: true
        approved_at:
          type: string
          nullable: true
        received_at:
          type: string
          nullable: true
        refunded_at:
          type: string
          nullable: true
        canceled_at:
          type: string
          nullable: true
        reason:
          "$ref": "#/components/schemas/ReturnReason"
        return_line_items:
          type: array
          items:
            "$ref": "#/components/schemas/ReturnLineItem"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - number
      - status
      - order_id
      - reason_id
      - refund_total
      - display_refund_total
      - refund_tax_total
      - display_refund_tax_total
      - approved_at
      - received_at
      - refunded_at
      - canceled_at
      x-typelizer: true
    SavedReportEvent:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        query:
          type: object
        seeded:
          type: boolean
        created_at:
          type: string
        updated_at:
          type: string
        user_id:
          type: string
          nullable: true
      required:
      - id
      - name
      - description
      - query
      - seeded
      - created_at
      - updated_at
      - user_id
      x-typelizer: true
    Seller:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
        about:
          type: string
        about_html:
          type: string
        logo_url:
          type: string
          nullable: true
        square_logo_url:
          type: string
          nullable: true
        cover_photo_url:
          type: string
          nullable: true
        policies:
          type: array
          items:
            "$ref": "#/components/schemas/Policy"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - name
      - slug
      - about
      - about_html
      - logo_url
      - square_logo_url
      - cover_photo_url
      x-typelizer: true
    ShippingLabelEvent:
      type: object
      properties:
        id:
          type: string
        status:
          anyOf:
          - type: string
            enum:
            - purchased
            - refund_requested
            - refunded
          - type: string
          description: The values listed are the built-in ones; extensions may add
            more.
        carrier:
          type: string
          nullable: true
        service:
          type: string
          nullable: true
        tracking_number:
          type: string
          nullable: true
        refunded_at:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        owner_id:
          type: string
        owner_type:
          type: string
          enum:
          - fulfillment
          - return
      required:
      - id
      - status
      - carrier
      - service
      - tracking_number
      - refunded_at
      - created_at
      - updated_at
      - owner_id
      - owner_type
      x-typelizer: true
    State:
      type: object
      properties:
        abbr:
          type: string
        name:
          type: string
      required:
      - abbr
      - name
      x-typelizer: true
    StockLevel:
      type: object
      properties:
        id:
          type: string
        count_on_hand:
          type: number
        backorderable:
          type: boolean
        stock_location_id:
          type: string
          nullable: true
        variant_id:
          type: string
          nullable: true
      required:
      - id
      - count_on_hand
      - backorderable
      - stock_location_id
      - variant_id
      x-typelizer: true
    StockLocation:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        address1:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        zipcode:
          type: string
          nullable: true
        country_code:
          type: string
          nullable: true
          enum:
          - AD
          - AE
          - AF
          - AG
          - AI
          - AL
          - AM
          - AO
          - AR
          - AS
          - AT
          - AU
          - AW
          - AZ
          - BA
          - BB
          - BD
          - BE
          - BF
          - BG
          - BH
          - BI
          - BJ
          - BL
          - BM
          - BN
          - BO
          - BQ
          - BR
          - BS
          - BT
          - BW
          - BY
          - BZ
          - CA
          - CC
          - CD
          - CF
          - CG
          - CH
          - CI
          - CK
          - CL
          - CM
          - CN
          - CO
          - CR
          - CU
          - CV
          - CW
          - CX
          - CY
          - CZ
          - DE
          - DJ
          - DK
          - DM
          - DO
          - DZ
          - EC
          - EE
          - EG
          - ER
          - ES
          - ET
          - FI
          - FJ
          - FK
          - FM
          - FO
          - FR
          - GA
          - GB
          - GD
          - GE
          - GF
          - GG
          - GH
          - GI
          - GL
          - GM
          - GN
          - GP
          - GQ
          - GR
          - GT
          - GU
          - GW
          - GY
          - HK
          - HN
          - HR
          - HT
          - HU
          - ID
          - IE
          - IL
          - IM
          - IN
          - IQ
          - IR
          - IS
          - IT
          - JE
          - JM
          - JO
          - JP
          - KE
          - KG
          - KH
          - KI
          - KM
          - KN
          - KP
          - KR
          - KW
          - KY
          - KZ
          - LA
          - LB
          - LC
          - LI
          - LK
          - LR
          - LS
          - LT
          - LU
          - LV
          - LY
          - MA
          - MC
          - MD
          - ME
          - MF
          - MG
          - MH
          - MK
          - ML
          - MM
          - MN
          - MO
          - MP
          - MQ
          - MR
          - MS
          - MT
          - MU
          - MV
          - MW
          - MX
          - MY
          - MZ
          - NA
          - NC
          - NE
          - NF
          - NG
          - NI
          - NL
          - 'NO'
          - NP
          - NR
          - NU
          - NZ
          - OM
          - PA
          - PE
          - PF
          - PG
          - PH
          - PK
          - PL
          - PM
          - PN
          - PR
          - PS
          - PT
          - PW
          - PY
          - QA
          - RE
          - RO
          - RS
          - RU
          - RW
          - SA
          - SB
          - SC
          - SD
          - SE
          - SG
          - SH
          - SI
          - SJ
          - SK
          - SL
          - SM
          - SN
          - SO
          - SR
          - SS
          - ST
          - SV
          - SX
          - SY
          - SZ
          - TC
          - TD
          - TG
          - TH
          - TJ
          - TK
          - TL
          - TM
          - TN
          - TO
          - TR
          - TT
          - TV
          - TW
          - TZ
          - UA
          - UG
          - US
          - UY
          - UZ
          - VA
          - VC
          - VE
          - VG
          - VI
          - VN
          - VU
          - WF
          - WS
          - YE
          - YT
          - ZA
          - ZM
          - ZW
        country_name:
          type: string
          nullable: true
        state_code:
          type: string
          nullable: true
        state_text:
          type: string
          nullable: true
        country_iso:
          type: string
          nullable: true
          deprecated: true
        state_abbr:
          type: string
          nullable: true
          deprecated: true
        pickup_ready_in_minutes:
          type: number
          nullable: true
        pickup_instructions:
          type: string
          nullable: true
      required:
      - id
      - name
      - address1
      - city
      - zipcode
      - country_code
      - country_name
      - state_code
      - state_text
      - country_iso
      - state_abbr
      - pickup_ready_in_minutes
      - pickup_instructions
      x-typelizer: true
    StockMovement:
      type: object
      properties:
        id:
          type: string
        quantity:
          type: number
        kind:
          type: string
          nullable: true
          enum:
          - received
          - allocated
          - shipped
          - released
          - adjusted
        reason:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        stock_level_id:
          type: string
          nullable: true
      required:
      - id
      - quantity
      - kind
      - reason
      - created_at
      - updated_at
      - stock_level_id
      x-typelizer: true
    StockReceiptEvent:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        quantity_accepted_total:
          type: number
        quantity_rejected_total:
          type: number
        received_at:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        receivable_type:
          type: string
          enum:
          - purchase_order
          - stock_transfer
        receivable_id:
          type: string
      required:
      - id
      - number
      - quantity_accepted_total
      - quantity_rejected_total
      - received_at
      - created_at
      - updated_at
      - receivable_type
      - receivable_id
      x-typelizer: true
    StockReservation:
      type: object
      properties:
        id:
          type: string
      required:
      - id
      x-typelizer: true
    StockTransfer:
      type: object
      properties:
        id:
          type: string
        number:
          type: string
        reference:
          type: string
          nullable: true
        created_at:
          type: string
        updated_at:
          type: string
        source_location_id:
          type: string
        destination_location_id:
          type: string
      required:
      - id
      - number
      - reference
      - created_at
      - updated_at
      - source_location_id
      - destination_location_id
      x-typelizer: true
    StoreCreditEvent:
      type: object
      properties:
        id:
          type: string
        action:
          type: string
        authorization_code:
          type: string
          nullable: true
        display_action:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        created_at:
          type: string
      required:
      - id
      - action
      - authorization_code
      - display_action
      - amount
      - display_amount
      - created_at
      x-typelizer: true
    StoreCredit:
      type: object
      properties:
        id:
          type: string
        amount:
          type: string
          nullable: true
        amount_used:
          type: string
          nullable: true
        amount_remaining:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_amount_used:
          type: string
          nullable: true
          description: "`amount_used` formatted with its currency symbol in the request's
            language."
          deprecated: true
        display_amount_remaining:
          type: string
          nullable: true
          description: "`amount_remaining` formatted with its currency symbol in the
            request's language."
          deprecated: true
        currency:
          type: string
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BRL
          - BSD
          - BTN
          - BWP
          - BYN
          - BYR
          - BZD
          - CAD
          - CDF
          - CHF
          - CLF
          - CLP
          - CNY
          - COP
          - CRC
          - CUC
          - CUP
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EEK
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MRU
          - MTL
          - MUR
          - MVR
          - MWK
          - MXN
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SKK
          - SLE
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - STN
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMM
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - UYI
          - UYU
          - UYW
          - UZS
          - VED
          - VEF
          - VES
          - VND
          - VUV
          - WST
          - XAF
          - XCD
          - XCG
          - XOF
          - XPF
          - YER
          - ZAR
          - ZMK
          - ZMW
          - ZWD
          - ZWG
          - ZWL
          - ZWN
          - ZWR
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
      required:
      - id
      - amount
      - amount_used
      - amount_remaining
      - display_amount
      - display_amount_used
      - display_amount_remaining
      - currency
      x-typelizer: true
    Store:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        seo_title:
          type: string
          nullable: true
        meta_description:
          type: string
          nullable: true
        meta_keywords:
          type: string
          nullable: true
        facebook:
          type: string
          nullable: true
          description: 'Facebook page, as entered by the merchant: a handle or a full
            URL.'
        twitter:
          type: string
          nullable: true
          description: 'X (Twitter) account, as entered by the merchant: a handle
            or a full URL.'
        instagram:
          type: string
          nullable: true
          description: 'Instagram account, as entered by the merchant: a handle or
            a full URL.'
        customer_support_email:
          type: string
          nullable: true
        logo_url:
          type: string
          nullable: true
      required:
      - id
      - name
      - seo_title
      - meta_description
      - meta_keywords
      - facebook
      - twitter
      - instagram
      - customer_support_email
      - logo_url
      x-typelizer: true
    SupplierEvent:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
      required:
      - id
      - name
      - created_at
      - updated_at
      x-typelizer: true
    TaxIdentifier:
      type: object
      properties:
        id:
          type: string
        kind:
          type: string
          description: 'Tax identifier kind, keyed to a registered validator. Built-in:
            eu_vat. Extensions may register more.'
        value:
          type: string
      required:
      - id
      - kind
      - value
      x-typelizer: true
    TaxLine:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        included:
          type: boolean
        credit:
          type: boolean
        rate:
          type: string
          nullable: true
        tax_rate_id:
          type: string
          nullable: true
        line_item_id:
          type: string
          nullable: true
        fulfillment_id:
          type: string
          nullable: true
        fee_id:
          type: string
          nullable: true
        return_line_item_id:
          type: string
          nullable: true
        claim_line_item_id:
          type: string
          nullable: true
        exchange_line_item_id:
          type: string
          nullable: true
        amount:
          type: string
          nullable: true
        display_amount:
          type: string
          nullable: true
          description: "`amount` formatted with its currency symbol in the request's
            language."
          deprecated: true
      required:
      - id
      - label
      - included
      - credit
      - rate
      - tax_rate_id
      - line_item_id
      - fulfillment_id
      - fee_id
      - return_line_item_id
      - claim_line_item_id
      - exchange_line_item_id
      - amount
      - display_amount
      x-typelizer: true
    Variant:
      type: object
      properties:
        id:
          type: string
        product_id:
          type: string
        sku:
          type: string
          nullable: true
        options_text:
          type: string
        track_inventory:
          type: boolean
        media_count:
          type: number
        preorder_ships_at:
          type: string
          nullable: true
        thumbnail_url:
          type: string
          nullable: true
        purchasable:
          type: boolean
        in_stock:
          type: boolean
        backorderable:
          type: boolean
        preorder:
          type: boolean
        weight:
          type: number
          nullable: true
        height:
          type: number
          nullable: true
        width:
          type: number
          nullable: true
        depth:
          type: number
          nullable: true
        weight_unit:
          type: string
          enum:
          - g
          - kg
          - lb
          - oz
        dimensions_unit:
          type: string
          enum:
          - mm
          - cm
          - in
          - ft
        minimum_order_quantity:
          type: number
        order_multiple:
          type: number
        purchase_unit:
          type: string
          enum:
          - unit
          - carton
        units_per_carton:
          type: number
          nullable: true
        price:
          "$ref": "#/components/schemas/Price"
        original_price:
          allOf:
          - "$ref": "#/components/schemas/Price"
          nullable: true
        seller_id:
          type: string
          nullable: true
        seller:
          "$ref": "#/components/schemas/Seller"
        primary_media:
          "$ref": "#/components/schemas/Media"
        media:
          type: array
          items:
            "$ref": "#/components/schemas/Media"
        option_values:
          type: array
          items:
            "$ref": "#/components/schemas/OptionValue"
        custom_fields:
          type: array
          items:
            "$ref": "#/components/schemas/CustomField"
        prior_price:
          allOf:
          - "$ref": "#/components/schemas/PriceHistory"
          nullable: true
      required:
      - id
      - product_id
      - sku
      - options_text
      - track_inventory
      - media_count
      - preorder_ships_at
      - thumbnail_url
      - purchasable
      - in_stock
      - backorderable
      - preorder
      - weight
      - height
      - width
      - depth
      - weight_unit
      - dimensions_unit
      - minimum_order_quantity
      - order_multiple
      - purchase_unit
      - units_per_carton
      - price
      - original_price
      - seller_id
      - option_values
      x-typelizer: true
    WishlistItem:
      type: object
      properties:
        id:
          type: string
        variant_id:
          type: string
        product_id:
          type: string
        wishlist_id:
          type: string
        quantity:
          type: number
        variant:
          "$ref": "#/components/schemas/Variant"
        product:
          "$ref": "#/components/schemas/Product"
      required:
      - id
      - variant_id
      - product_id
      - wishlist_id
      - quantity
      - variant
      x-typelizer: true
    Wishlist:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        token:
          type: string
        is_default:
          type: boolean
        is_private:
          type: boolean
        items:
          type: array
          items:
            "$ref": "#/components/schemas/WishlistItem"
      required:
      - id
      - name
      - token
      - is_default
      - is_private
      x-typelizer: true
    CountryCode:
      type: string
      enum:
      - AD
      - AE
      - AF
      - AG
      - AI
      - AL
      - AM
      - AO
      - AR
      - AS
      - AT
      - AU
      - AW
      - AZ
      - BA
      - BB
      - BD
      - BE
      - BF
      - BG
      - BH
      - BI
      - BJ
      - BL
      - BM
      - BN
      - BO
      - BQ
      - BR
      - BS
      - BT
      - BW
      - BY
      - BZ
      - CA
      - CC
      - CD
      - CF
      - CG
      - CH
      - CI
      - CK
      - CL
      - CM
      - CN
      - CO
      - CR
      - CU
      - CV
      - CW
      - CX
      - CY
      - CZ
      - DE
      - DJ
      - DK
      - DM
      - DO
      - DZ
      - EC
      - EE
      - EG
      - ER
      - ES
      - ET
      - FI
      - FJ
      - FK
      - FM
      - FO
      - FR
      - GA
      - GB
      - GD
      - GE
      - GF
      - GG
      - GH
      - GI
      - GL
      - GM
      - GN
      - GP
      - GQ
      - GR
      - GT
      - GU
      - GW
      - GY
      - HK
      - HN
      - HR
      - HT
      - HU
      - ID
      - IE
      - IL
      - IM
      - IN
      - IQ
      - IR
      - IS
      - IT
      - JE
      - JM
      - JO
      - JP
      - KE
      - KG
      - KH
      - KI
      - KM
      - KN
      - KP
      - KR
      - KW
      - KY
      - KZ
      - LA
      - LB
      - LC
      - LI
      - LK
      - LR
      - LS
      - LT
      - LU
      - LV
      - LY
      - MA
      - MC
      - MD
      - ME
      - MF
      - MG
      - MH
      - MK
      - ML
      - MM
      - MN
      - MO
      - MP
      - MQ
      - MR
      - MS
      - MT
      - MU
      - MV
      - MW
      - MX
      - MY
      - MZ
      - NA
      - NC
      - NE
      - NF
      - NG
      - NI
      - NL
      - 'NO'
      - NP
      - NR
      - NU
      - NZ
      - OM
      - PA
      - PE
      - PF
      - PG
      - PH
      - PK
      - PL
      - PM
      - PN
      - PR
      - PS
      - PT
      - PW
      - PY
      - QA
      - RE
      - RO
      - RS
      - RU
      - RW
      - SA
      - SB
      - SC
      - SD
      - SE
      - SG
      - SH
      - SI
      - SJ
      - SK
      - SL
      - SM
      - SN
      - SO
      - SR
      - SS
      - ST
      - SV
      - SX
      - SY
      - SZ
      - TC
      - TD
      - TG
      - TH
      - TJ
      - TK
      - TL
      - TM
      - TN
      - TO
      - TR
      - TT
      - TV
      - TW
      - TZ
      - UA
      - UG
      - US
      - UY
      - UZ
      - VA
      - VC
      - VE
      - VG
      - VI
      - VN
      - VU
      - WF
      - WS
      - YE
      - YT
      - ZA
      - ZM
      - ZW
    CurrencyCode:
      type: string
      enum:
      - AED
      - AFN
      - ALL
      - AMD
      - ANG
      - AOA
      - ARS
      - AUD
      - AWG
      - AZN
      - BAM
      - BBD
      - BDT
      - BGN
      - BHD
      - BIF
      - BMD
      - BND
      - BOB
      - BRL
      - BSD
      - BTN
      - BWP
      - BYN
      - BYR
      - BZD
      - CAD
      - CDF
      - CHF
      - CLF
      - CLP
      - CNY
      - COP
      - CRC
      - CUC
      - CUP
      - CVE
      - CZK
      - DJF
      - DKK
      - DOP
      - DZD
      - EEK
      - EGP
      - ERN
      - ETB
      - EUR
      - FJD
      - FKP
      - GBP
      - GEL
      - GHS
      - GIP
      - GMD
      - GNF
      - GTQ
      - GYD
      - HKD
      - HNL
      - HRK
      - HTG
      - HUF
      - IDR
      - ILS
      - INR
      - IQD
      - IRR
      - ISK
      - JMD
      - JOD
      - JPY
      - KES
      - KGS
      - KHR
      - KMF
      - KPW
      - KRW
      - KWD
      - KYD
      - KZT
      - LAK
      - LBP
      - LKR
      - LRD
      - LSL
      - LTL
      - LVL
      - LYD
      - MAD
      - MDL
      - MGA
      - MKD
      - MMK
      - MNT
      - MOP
      - MRO
      - MRU
      - MTL
      - MUR
      - MVR
      - MWK
      - MXN
      - MYR
      - MZN
      - NAD
      - NGN
      - NIO
      - NOK
      - NPR
      - NZD
      - OMR
      - PAB
      - PEN
      - PGK
      - PHP
      - PKR
      - PLN
      - PYG
      - QAR
      - RON
      - RSD
      - RUB
      - RWF
      - SAR
      - SBD
      - SCR
      - SDG
      - SEK
      - SGD
      - SHP
      - SKK
      - SLE
      - SLL
      - SOS
      - SRD
      - SSP
      - STD
      - STN
      - SVC
      - SYP
      - SZL
      - THB
      - TJS
      - TMM
      - TMT
      - TND
      - TOP
      - TRY
      - TTD
      - TWD
      - TZS
      - UAH
      - UGX
      - USD
      - UYI
      - UYU
      - UYW
      - UZS
      - VED
      - VEF
      - VES
      - VND
      - VUV
      - WST
      - XAF
      - XCD
      - XCG
      - XOF
      - XPF
      - YER
      - ZAR
      - ZMK
      - ZMW
      - ZWD
      - ZWG
      - ZWL
      - ZWN
      - ZWR
    LocaleCode:
      type: string
      enum:
      - aa
      - ab
      - ae
      - af
      - ak
      - am
      - an
      - ar
      - as
      - av
      - ay
      - az
      - ba
      - be
      - bg
      - bh
      - bi
      - bm
      - bn
      - bo
      - br
      - bs
      - ca
      - ce
      - ch
      - co
      - cr
      - cs
      - cu
      - cv
      - cy
      - da
      - de
      - de-AT
      - de-CH
      - dv
      - dz
      - ee
      - el
      - en
      - en-AU
      - en-CA
      - en-GB
      - en-IN
      - en-NZ
      - en-US
      - eo
      - es
      - es-419
      - es-CL
      - es-EC
      - es-MX
      - et
      - eu
      - fa
      - ff
      - fi
      - fj
      - fo
      - fr
      - fr-CA
      - fy
      - ga
      - gd
      - gl
      - gn
      - gu
      - gv
      - ha
      - he
      - hi
      - ho
      - hr
      - ht
      - hu
      - hy
      - hz
      - ia
      - id
      - ie
      - ig
      - ii
      - ik
      - io
      - is
      - it
      - iu
      - ja
      - jv
      - ka
      - kg
      - ki
      - kj
      - kk
      - kl
      - km
      - kn
      - ko
      - kr
      - ks
      - ku
      - kv
      - kw
      - ky
      - la
      - lb
      - lg
      - li
      - ln
      - lo
      - lt
      - lu
      - lv
      - mg
      - mh
      - mi
      - mk
      - ml
      - mn
      - mr
      - ms
      - mt
      - my
      - na
      - nb
      - nd
      - ne
      - ng
      - nl
      - nn
      - 'no'
      - nr
      - nv
      - ny
      - oc
      - oj
      - om
      - or
      - os
      - pa
      - pi
      - pl
      - ps
      - pt
      - pt-BR
      - pt-PT
      - qu
      - rm
      - rn
      - ro
      - ru
      - rw
      - sa
      - sc
      - sd
      - se
      - sg
      - si
      - sk
      - sl
      - sl-SI
      - sm
      - sn
      - so
      - sq
      - sr
      - ss
      - st
      - su
      - sv
      - sw
      - ta
      - te
      - tg
      - th
      - ti
      - tk
      - tl
      - tn
      - to
      - tr
      - ts
      - tt
      - tw
      - ty
      - ug
      - uk
      - ur
      - uz
      - ve
      - vi
      - vo
      - wa
      - wo
      - xh
      - yi
      - yo
      - za
      - zh-CN
      - zh-HK
      - zh-TW
      - zu
    AcceptCompanyInvitationParams:
      type: object
      properties:
        first_name:
          type: string
          example: Ada
        last_name:
          type: string
          example: Lovelace
        phone:
          type: string
        password:
          type: string
          example: a-strong-password
        password_confirmation:
          type: string
          example: a-strong-password
    AddCompanyMemberParams:
      type: object
      properties:
        customer_email:
          type: string
          example: colleague@acme.test
      required:
      - customer_email
    AddLineItemParams:
      type: object
      properties:
        variant_id:
          type: string
          example: variant_abc123
        quantity:
          type: integer
          description: Defaults to 1.
          example: 2
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata.
          example:
            gift_message: Happy Birthday!
        options:
          type: object
          additionalProperties: true
          description: Values for line item attributes an extension adds.
      required:
      - variant_id
    AddressCreateParams:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        company:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        postal_code:
          type: string
        phone:
          type: string
        country_code:
          allOf:
          - "$ref": "#/components/schemas/CountryCode"
          description: ISO 3166-1 alpha-2 country code, such as `US` or `DE`.
          example: US
        state_code:
          type: string
          description: ISO 3166-2 subdivision code without the country prefix, such
            as `CA` or `NY`.
          example: NY
        state_name:
          type: string
          description: The state name, for countries without predefined states.
        quick_checkout:
          type: boolean
          description: Relaxes validation (name, phone, postal code, street), for
            express checkouts that share a partial address.
        country_iso:
          type: string
          description: 'Deprecated: Use `country_code`. Removed in 6.5.'
          deprecated: true
        state_abbr:
          type: string
          description: 'Deprecated: Use `state_code`. Removed in 6.5.'
          deprecated: true
        is_default_billing:
          type: boolean
          description: Makes this the default billing address.
        is_default_shipping:
          type: boolean
          description: Makes this the default shipping address.
      required:
      - first_name
      - last_name
      - address1
      - city
      - country_code
    AddressUpdateParams:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        company:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        postal_code:
          type: string
        phone:
          type: string
        country_code:
          allOf:
          - "$ref": "#/components/schemas/CountryCode"
          description: ISO 3166-1 alpha-2 country code, such as `US` or `DE`.
          example: US
        state_code:
          type: string
          description: ISO 3166-2 subdivision code without the country prefix, such
            as `CA` or `NY`.
          example: NY
        state_name:
          type: string
          description: The state name, for countries without predefined states.
        quick_checkout:
          type: boolean
          description: Relaxes validation (name, phone, postal code, street), for
            express checkouts that share a partial address.
        country_iso:
          type: string
          description: 'Deprecated: Use `country_code`. Removed in 6.5.'
          deprecated: true
        state_abbr:
          type: string
          description: 'Deprecated: Use `state_code`. Removed in 6.5.'
          deprecated: true
        is_default_billing:
          type: boolean
          description: Makes this the default billing address.
        is_default_shipping:
          type: boolean
          description: Makes this the default shipping address.
    ApplyDiscountCodeParams:
      type: object
      properties:
        code:
          type: string
          description: The promotion code to apply.
          example: SAVE10
      required:
      - code
    ApplyGiftCardParams:
      type: object
      properties:
        code:
          type: string
          description: The gift card code to apply.
          example: GC-ABCD-1234
      required:
      - code
    ApplyStoreCreditParams:
      type: object
      properties:
        amount:
          type: string
          format: decimal
          pattern: "^-?\\d+(\\.\\d+)?$"
          description: Defaults to as much as the cart can use. A JSON number is still
            read until 6.5, with a deprecation warning.
          example: '10.00'
    CartAddressParams:
      type: object
      properties:
        id:
          type: string
          description: An existing address from the buyer's address book, or from
            the book of the company the cart is for. The other fields are then ignored.
        first_name:
          type: string
        last_name:
          type: string
        company:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        postal_code:
          type: string
        phone:
          type: string
        country_code:
          allOf:
          - "$ref": "#/components/schemas/CountryCode"
          description: ISO 3166-1 alpha-2 country code, such as `US` or `DE`.
          example: US
        state_code:
          type: string
          description: ISO 3166-2 subdivision code without the country prefix, such
            as `CA` or `NY`.
          example: NY
        state_name:
          type: string
          description: The state name, for countries without predefined states.
        quick_checkout:
          type: boolean
          description: Relaxes validation (name, phone, postal code, street), for
            express checkouts that share a partial address.
        country_iso:
          type: string
          description: 'Deprecated: Use `country_code`. Removed in 6.5.'
          deprecated: true
        state_abbr:
          type: string
          description: 'Deprecated: Use `state_code`. Removed in 6.5.'
          deprecated: true
    CompanyAddressCreateParams:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        company:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        postal_code:
          type: string
        phone:
          type: string
        label:
          type: string
        country_code:
          allOf:
          - "$ref": "#/components/schemas/CountryCode"
          description: ISO 3166-1 alpha-2 code, such as `US`.
          example: US
        state_code:
          type: string
          description: The state or province abbreviation, such as `NY`.
          example: NY
        state_name:
          type: string
          description: For countries without states in the database.
        zipcode:
          type: string
          description: 'Deprecated: Use `postal_code`. Removed in 6.5.'
          deprecated: true
        default_billing:
          type: boolean
          description: True makes this the node's default billing address, false gives
            that up, and leaving it out changes nothing.
        default_shipping:
          type: boolean
          description: True makes this the node's default shipping address, false
            gives that up, and leaving it out changes nothing.
      required:
      - first_name
      - last_name
      - address1
      - city
      - country_code
    CompanyAddressUpdateParams:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        company:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        postal_code:
          type: string
        phone:
          type: string
        label:
          type: string
        country_code:
          allOf:
          - "$ref": "#/components/schemas/CountryCode"
          description: ISO 3166-1 alpha-2 code, such as `US`.
          example: US
        state_code:
          type: string
          description: The state or province abbreviation, such as `NY`.
          example: NY
        state_name:
          type: string
          description: For countries without states in the database.
        zipcode:
          type: string
          description: 'Deprecated: Use `postal_code`. Removed in 6.5.'
          deprecated: true
        default_billing:
          type: boolean
          description: True makes this the node's default billing address, false gives
            that up, and leaving it out changes nothing.
        default_shipping:
          type: boolean
          description: True makes this the node's default shipping address, false
            gives that up, and leaving it out changes nothing.
    CompletePaymentSessionParams:
      type: object
      properties:
        session_result:
          type: string
          description: Provider-specific session result token.
        external_data:
          type: object
          additionalProperties: true
          description: Provider-specific completion data.
    CompletePaymentSetupSessionParams:
      type: object
      properties:
        external_data:
          type: object
          additionalProperties: true
          description: Provider-specific completion data.
    CreateCartParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: customer@example.com
        customer_note:
          type: string
          example: Leave at door
        market_id:
          type: string
        currency:
          "$ref": "#/components/schemas/CurrencyCode"
        locale:
          "$ref": "#/components/schemas/LocaleCode"
        shipping_address_id:
          type: string
          description: An existing address to ship to, from the buyer's address book
            or from the book of the company the cart is for. List both with `GET /store/carts/:id/addresses`.
          example: addr_abc123
        billing_address_id:
          type: string
          description: An existing address to bill, from the buyer's address book
            or from the book of the company the cart is for. List both with `GET /store/carts/:id/addresses`.
          example: addr_def456
        preferred_stock_location_id:
          type: string
        company_id:
          type: string
          description: 'The company node this purchase is for. The buyer must have
            standing over it: a membership on that node or one of its ancestors. Null
            clears it, and with it the company''s catalog, pricing and tax anchoring.'
          nullable: true
        po_number:
          type: string
          description: The buyer's own purchase-order reference. Their accounting
            reconciles the order, the invoice and the payment against it. Blank clears
            it.
          nullable: true
        po_document_signed_id:
          type: string
          description: The `signed_id` of the buyer's purchase order, from `POST /store/carts/:id/po_document`.
            Blank detaches the document.
          nullable: true
        use_shipping:
          type: boolean
          description: When true, copies the shipping address to the billing address.
        shipping_address:
          allOf:
          - "$ref": "#/components/schemas/CartAddressParams"
          description: A new shipping address.
        billing_address:
          allOf:
          - "$ref": "#/components/schemas/CartAddressParams"
          description: A new billing address.
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata, merged with what the cart has.
        items:
          type: array
          items:
            "$ref": "#/components/schemas/LineItemInputParams"
          description: 'Items to upsert: sets the quantity of a variant already in
            the cart, adds the others.'
    CreateClaimParams:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              line_item_id:
                type: string
              quantity:
                type: integer
              description:
                type: string
                description: What is wrong with the item.
            required:
            - line_item_id
            - quantity
        reason_id:
          type: string
          description: One of the store's claim reasons.
        memo:
          type: string
      required:
      - items
    CreateDataRequestParams:
      type: object
      properties:
        kind:
          type: string
          enum:
          - access
          - erasure
          description: Defaults to `access`.
        current_password:
          type: string
          description: Required for `erasure`.
        redirect_url:
          type: string
          format: uri
          description: The storefront page the confirmation link opens, with the token
            appended. Ignored unless it matches one of the store's allowed origins.
          example: https://myshop.com/account/data-requests/confirm
    CreateNewsletterSubscriberParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: subscriber@example.com
        redirect_url:
          type: string
          format: uri
          description: The storefront URL the verification token is appended to. Left
            out of the webhook payload unless it matches one of the store's allowed
            origins.
          example: https://your-store.com/newsletter/confirm
      required:
      - email
    CreatePaymentParams:
      type: object
      properties:
        payment_method_id:
          type: string
          description: A payment method that needs no payment session.
          example: pm_abc123
        amount:
          type: string
          format: decimal
          pattern: "^-?\\d+(\\.\\d+)?$"
          description: Defaults to the order total minus store credits.
          example: '99.99'
        metadata:
          type: object
          additionalProperties: true
          description: Key-value metadata to attach to the payment.
      required:
      - payment_method_id
    CreatePaymentSessionParams:
      type: object
      properties:
        payment_method_id:
          type: string
          example: pm_abc123
        amount:
          type: string
          format: decimal
          pattern: "^-?\\d+(\\.\\d+)?$"
          description: Defaults to the order total minus store credits.
          example: '99.99'
        external_data:
          type: object
          additionalProperties: true
          description: Provider-specific data passed to the gateway.
      required:
      - payment_method_id
    CreatePaymentSetupSessionParams:
      type: object
      properties:
        payment_method_id:
          type: string
          example: pm_abc123
        external_data:
          type: object
          additionalProperties: true
          description: Provider-specific data passed to the gateway.
      required:
      - payment_method_id
    CreatePoDocumentParams:
      type: object
      properties:
        filename:
          type: string
        content_type:
          type: string
        byte_size:
          type: integer
        checksum:
          type: string
          description: Base64-encoded MD5 digest of the file; the storage service
            checks the bytes against it.
      required:
      - filename
      - content_type
      - byte_size
      - checksum
    CreateReturnParams:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              fulfillment_item_id:
                type: string
                description: The shipped unit coming back.
              quantity:
                type: integer
            required:
            - fulfillment_item_id
            - quantity
        reason_id:
          type: string
          description: One of the store's return reasons.
        memo:
          type: string
      required:
      - items
    CreateWishlistItemParams:
      type: object
      properties:
        variant_id:
          type: string
          example: variant_abc123
        quantity:
          type: integer
          example: 1
      required:
      - variant_id
    CreateWishlistParams:
      type: object
      properties:
        name:
          type: string
          example: Birthday Ideas
        is_private:
          type: boolean
        is_default:
          type: boolean
      required:
      - name
    LineItemInputParams:
      type: object
      properties:
        variant_id:
          type: string
          example: variant_abc123
        quantity:
          type: integer
          description: Defaults to 1.
          example: 2
        metadata:
          type: object
          additionalProperties: true
          description: Key-value metadata, merged with what the line item has.
        options:
          type: object
          additionalProperties: true
      required:
      - variant_id
    LogoutParams:
      type: object
      properties:
        refresh_token:
          type: string
          description: The refresh token to revoke.
    RefreshTokenParams:
      type: object
      properties:
        refresh_token:
          type: string
          description: The refresh token from the login response.
      required:
      - refresh_token
    RegisterParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: newuser@example.com
        password:
          type: string
          example: password123
        password_confirmation:
          type: string
          example: password123
        first_name:
          type: string
          example: John
        last_name:
          type: string
          example: Doe
        phone:
          type: string
          example: "+1 555 123 4567"
        accepts_email_marketing:
          type: boolean
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata.
        terms_of_service:
          type: boolean
          description: Whether the customer ticked the storefront's terms of service
            box. Recorded as their consent.
      required:
      - email
      - password
    RequestNewsletterUnsubscribeParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: subscriber@example.com
        redirect_url:
          type: string
          format: uri
          description: The storefront URL the unsubscribe token is appended to in
            the email. Left out of the event payload unless it matches one of the
            store's allowed origins.
    RequestPasswordResetParams:
      type: object
      properties:
        email:
          type: string
          format: email
          description: The email of the account to reset.
          example: customer@example.com
        redirect_url:
          type: string
          format: uri
          description: Where the reset link sends the customer. Ignored unless it
            matches one of the store's allowed origins.
          example: https://myshop.com/reset-password
      required:
      - email
    ResetPasswordParams:
      type: object
      properties:
        password:
          type: string
          example: newsecurepassword
        password_confirmation:
          type: string
          example: newsecurepassword
      required:
      - password
      - password_confirmation
    TaxIdentifierParams:
      type: object
      properties:
        kind:
          type: string
          description: 'The registration the number belongs to, such as `eu_vat` or
            `gb_vat`. Any kind is accepted; one with a registered validator is checked
            by it. Built-in: `eu_vat`. Extensions may register more.'
          example: eu_vat
        value:
          type: string
          example: DE123456789
      required:
      - kind
      - value
    UpdateCartParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: customer@example.com
        customer_note:
          type: string
          example: Leave at door
        market_id:
          type: string
        currency:
          "$ref": "#/components/schemas/CurrencyCode"
        locale:
          "$ref": "#/components/schemas/LocaleCode"
        shipping_address_id:
          type: string
          description: An existing address to ship to, from the buyer's address book
            or from the book of the company the cart is for. List both with `GET /store/carts/:id/addresses`.
          example: addr_abc123
        billing_address_id:
          type: string
          description: An existing address to bill, from the buyer's address book
            or from the book of the company the cart is for. List both with `GET /store/carts/:id/addresses`.
          example: addr_def456
        preferred_stock_location_id:
          type: string
        company_id:
          type: string
          description: 'The company node this purchase is for. The buyer must have
            standing over it: a membership on that node or one of its ancestors. Null
            clears it, and with it the company''s catalog, pricing and tax anchoring.'
          nullable: true
        po_number:
          type: string
          description: The buyer's own purchase-order reference. Their accounting
            reconciles the order, the invoice and the payment against it. Blank clears
            it.
          nullable: true
        po_document_signed_id:
          type: string
          description: The `signed_id` of the buyer's purchase order, from `POST /store/carts/:id/po_document`.
            Blank detaches the document.
          nullable: true
        use_shipping:
          type: boolean
          description: When true, copies the shipping address to the billing address.
        shipping_address:
          allOf:
          - "$ref": "#/components/schemas/CartAddressParams"
          description: A new shipping address.
        billing_address:
          allOf:
          - "$ref": "#/components/schemas/CartAddressParams"
          description: A new billing address.
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata, merged with what the cart has.
        items:
          type: array
          items:
            "$ref": "#/components/schemas/LineItemInputParams"
          description: 'Items to upsert: sets the quantity of a variant already in
            the cart, adds the others.'
    UpdateCompanyParams:
      type: object
      properties:
        name:
          type: string
          example: Acme Industrial Group
    UpdateCustomerParams:
      type: object
      properties:
        email:
          type: string
          format: email
          example: customer@example.com
        password:
          type: string
          description: 'Changing it signs the customer out everywhere: every refresh
            token is revoked, so sign in again once the access token expires.'
        password_confirmation:
          type: string
        current_password:
          type: string
          description: Required when changing the email or the password.
        first_name:
          type: string
          example: John
        last_name:
          type: string
          example: Doe
        phone:
          type: string
          example: "+1 555 123 4567"
        accepts_email_marketing:
          type: boolean
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata.
    UpdateFulfillmentParams:
      type: object
      properties:
        selected_delivery_rate_id:
          type: string
          description: The delivery rate to select.
          example: dr_abc123
        pickup_point_external_id:
          type: string
          description: 'For a pickup point delivery method: the provider''s id of
            the point to collect from.'
    UpdateLineItemParams:
      type: object
      properties:
        quantity:
          type: integer
          description: At least 1. Remove an item with DELETE.
          example: 5
        metadata:
          type: object
          additionalProperties: true
          description: Write-only key-value metadata, merged with what the line item
            has.
          example:
            engraving: J.D.
    UpdatePaymentSessionParams:
      type: object
      properties:
        amount:
          type: string
          format: decimal
          pattern: "^-?\\d+(\\.\\d+)?$"
          example: '50.00'
        external_data:
          type: object
          additionalProperties: true
          description: Provider-specific data to update.
    UpdateWishlistItemParams:
      type: object
      properties:
        variant_id:
          type: string
          description: Moves the item to another variant.
        quantity:
          type: integer
          example: 2
    UpdateWishlistParams:
      type: object
      properties:
        name:
          type: string
          example: Updated Name
        is_private:
          type: boolean
        is_default:
          type: boolean
    VerifyNewsletterSubscriberParams:
      type: object
      properties:
        token:
          type: string
          description: The verification token from the confirmation email.
          example: abc123def456
      required:
      - token
  x-spree-filter-tables:
    Address:
      attributes:
        address1: text
        address2: text
        city: text
        company: text
        country_code:
          code: CountryCode
        created_at: datetime
        first_name: text
        id: id
        last_name: text
        phone: text
        postal_code: text
        state_code: text
        updated_at: datetime
      associations: {}
      scopes: {}
    Category:
      attributes:
        automatic: boolean
        children_count: integer
        created_at: datetime
        depth: integer
        id: id
        name: text
        parent_id: id
        permalink: text
        position: integer
        pretty_name: text
        products_count: integer
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    Claim:
      attributes:
        created_at: datetime
        id: id
        number: text
        status:
          enum:
          - open
          - approved
          - resolved
          - denied
          - canceled
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    Collection:
      attributes:
        automatic: boolean
        created_at: datetime
        id: id
        name: text
        permalink: text
        position: integer
        products_count: integer
        sort_order:
          enum:
          - manual
          - best_selling
          - price asc
          - price desc
          - available_on desc
          - available_on asc
          - name asc
          - name desc
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    CompanyInvitation:
      attributes:
        created_at: datetime
        email: text
        id: id
        updated_at: datetime
      associations: {}
      scopes: {}
    CompanyMembership:
      attributes:
        created_at: datetime
        id: id
        updated_at: datetime
      associations: {}
      scopes: {}
    CreditCard:
      attributes:
        created_at: datetime
        id: id
        name: text
        updated_at: datetime
      associations: {}
      scopes: {}
    DataRequest:
      attributes:
        completed_at: datetime
        created_at: datetime
        email: text
        id: id
        kind:
          enum:
          - access
          - erasure
        number: text
        requested_at: datetime
        status:
          enum:
          - awaiting_confirmation
          - pending
          - processing
          - completed
          - failed
          - lapsed
        updated_at: datetime
      associations: {}
      scopes:
        access: boolean
        erasure: boolean
        in_progress: boolean
    DeliveryMethod:
      attributes:
        available_to_sellers: boolean
        created_at: datetime
        id: id
        name: text
        seller_id: id
        storefront_visible: boolean
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    DigitalLink:
      attributes:
        created_at: datetime
        id: id
        updated_at: datetime
      associations: {}
      scopes: {}
    GiftCard:
      attributes:
        code: text
        created_at: datetime
        created_by_id: id
        currency:
          code: CurrencyCode
        customer_id: id
        expires_at: date
        gift_card_batch_id: id
        id: id
        state:
          enum:
          - active
          - partially_redeemed
          - redeemed
          - canceled
        status:
          enum:
          - active
          - partially_redeemed
          - redeemed
          - canceled
        updated_at: datetime
      associations: {}
      scopes:
        active: boolean
        expired: boolean
        partially_redeemed: boolean
        redeemed: boolean
        search: text
    Order:
      attributes:
        channel_id: id
        completed_at: datetime
        created_at: datetime
        currency:
          code: CurrencyCode
        customer_id: id
        delivery_total: decimal
        fulfillment_status:
          enum:
          - backorder
          - canceled
          - partial
          - unfulfilled
          - fulfilled
          - delivered
          - pending
          - ready
          - shipped
        id: id
        item_total: decimal
        locale:
          code: LocaleCode
        market_id: id
        number: text
        order_group_id: id
        payment_state:
          enum:
          - none
          - authorized
          - partially_paid
          - paid
          - partially_refunded
          - refunded
          - overcharged
          - voided
          - balance_due
          - credit_owed
          - failed
          - void
        payment_status:
          enum:
          - none
          - authorized
          - partially_paid
          - paid
          - partially_refunded
          - refunded
          - overcharged
          - voided
          - balance_due
          - credit_owed
          - failed
          - void
        po_number: text
        seller_id: id
        shipment_state:
          enum:
          - backorder
          - canceled
          - partial
          - unfulfilled
          - fulfilled
          - delivered
          - pending
          - ready
          - shipped
        status:
          enum:
          - draft
          - placed
          - canceled
        total: decimal
        total_quantity: integer
        updated_at: datetime
      associations: {}
      scopes:
        complete: boolean
        incomplete: boolean
        partially_refunded: boolean
        refunded: boolean
    Policy:
      attributes:
        created_at: datetime
        id: id
        name: text
        owner_id: id
        owner_type: type
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    Product:
      attributes:
        available_on: datetime
        created_at: datetime
        description: text
        discontinue_on: datetime
        id: id
        name: text
        price: decimal
        seller_id: id
        slug: text
        status:
          enum:
          - draft
          - active
          - archived
          - proposed
          - rejected
        updated_at: datetime
      associations:
        categories: Category
        collections: Collection
        tags: Tag
      scopes:
        ascend_by_price: boolean
        descend_by_price: boolean
        in_categories:
          list: id
        in_category: id
        in_collection: id
        in_stock: boolean
        in_taxon: id
        not_discontinued: boolean
        out_of_stock: boolean
        price_between:
        - decimal
        - decimal
        price_gte: decimal
        price_lte: decimal
        search: text
        search_by_name: text
        with_option_value_ids:
          list: id
    Return:
      attributes:
        created_at: datetime
        id: id
        number: text
        status:
          enum:
          - requested
          - approved
          - received
          - refunded
          - canceled
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    Seller:
      attributes:
        created_at: datetime
        id: id
        name: text
        updated_at: datetime
      associations: {}
      scopes:
        search: text
    StoreCredit:
      attributes:
        amount: decimal
        created_at: datetime
        currency:
          code: CurrencyCode
        customer_id: id
        id: id
        updated_at: datetime
      associations: {}
      scopes:
        from_gift_card: boolean
        outstanding: boolean
    Tag:
      attributes:
        created_at: datetime
        id: id
        name: text
        updated_at: datetime
      associations: {}
      scopes: {}
    Wishlist:
      attributes:
        created_at: datetime
        id: id
        name: text
        updated_at: datetime
      associations: {}
      scopes: {}
  x-spree-filter-predicates:
    text:
    - eq
    - not_eq
    - in
    - not_in
    - cont
    - i_cont
    - not_cont
    - start
    - end
    - 'null'
    - not_null
    - present
    - blank
    decimal:
    - eq
    - not_eq
    - in
    - not_in
    - lt
    - lteq
    - gt
    - gteq
    - 'null'
    - not_null
    integer:
    - eq
    - not_eq
    - in
    - not_in
    - lt
    - lteq
    - gt
    - gteq
    - 'null'
    - not_null
    date:
    - eq
    - not_eq
    - in
    - not_in
    - lt
    - lteq
    - gt
    - gteq
    - 'null'
    - not_null
    datetime:
    - eq
    - not_eq
    - in
    - not_in
    - lt
    - lteq
    - gt
    - gteq
    - 'null'
    - not_null
    enum:
    - eq
    - not_eq
    - in
    - not_in
    - 'null'
    - not_null
    id:
    - eq
    - not_eq
    - in
    - not_in
    - 'null'
    - not_null
    type:
    - eq
    - not_eq
    - in
    - not_in
    - 'null'
    - not_null
    boolean:
    - eq
    - not_eq
    - in
    - not_in
    - 'true'
    - 'false'
    - 'null'
