---
title: "List business stores"
method: GET
path: "/v3/stores"
tags: ["Business Stores"]
---

# List business stores

`GET /v3/stores`

Requires the `store:list` scope.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `search` string
- `product_id` integer
- `domain` string
- `has_domain` boolean

## Response `200`

Paginated business store list

- BusinessStoreCollectionResponseBody
  - `data` BusinessStore[], required
    - `id` integer, required — Numeric Scalev store database ID.
    - `unique_id` string, required — Public store unique ID used by storefront routes.
    - `uuid` string, uuid
    - `name` string, required
    - `business_id` integer
    - `is_active` boolean
    - `is_public` boolean
    - `logo` string, nullable — Public URL for the store logo when configured.
    - `custom_domain` object, nullable
    - `payment_methods` string[]
    - `xendit_va_bank_codes` string[]
    - `products` BusinessStoreProduct[]
      - `id` integer, required
      - `name` string
      - `display` string
      - `is_visible` boolean, required — Whether this product is visible in this store.
      - `variants` BusinessStoreVariantSummary[]
        - `id` integer, required — Scalev variant record ID used by checkout/form_display payloads.
        - `unique_id` string
        - `fullname` string
        - `sku` string
        - `price` number
    - `bundle_price_options` BusinessStoreBundlePriceOption[]
      - `id` integer, required — Scalev bundle price option record ID used by checkout/form_display payloads.
      - `name` string
      - `price` number
      - `is_visible` boolean — Present on store-scoped bundle responses.
    - `bundles` BusinessStoreBundle[]
      - `id` integer, required
      - `name` string
      - `display` string
      - `bundle_price_options` BusinessStoreBundlePriceOption[], required
        - `id` integer, required — Scalev bundle price option record ID used by checkout/form_display payloads.
        - `name` string
        - `price` number
        - `is_visible` boolean — Present on store-scoped bundle responses.
    - `created_at` string, date-time
    - `last_updated_at` string, date-time
  - `is_paginated` true, required
  - `has_next` boolean
  - `has_previous` boolean
  - `next_cursor` string, nullable
  - `previous_cursor` string, nullable
  - `page_size` integer

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/versions/4354959d76dc/schema)