---
title: "List business bundles"
method: GET
path: "/v3/bundles"
tags: ["Business Bundles"]
---

# List business bundles

`GET /v3/bundles`

Requires the `bundle:list` scope. Retrieves a paginated list of bundles with optional filtering. The data is sorted by id in descending order and cannot be changed. Uses cursor-based pagination with default page size of 25 and maximum of 25.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `search` string
- `is_bundle_sharing` boolean
- `store_id` integer
- `label` string

## Response `200`

Bundles list

- ListBundlesResponseBody — Paginated list payload for v3.
  - `data` BundleList[], required
    - `business` object
      - `account_holder` string — Name of the account holder
      - `email` string, email — Email address of the business
      - `id` integer — Business ID
      - `is_banned` boolean — Is the business banned?
      - `logo` string, uri — URL to the business logo
      - `unique_id` string — Unique identifier for the business
      - `username` string — Username of the business
    - `created_at` string, date-time — Creation timestamp
    - `created_by` object
      - `aff_code` string — Affiliate code of the user
      - `avatar` string, uri — URL to user avatar
      - `email` string, email — User email
      - `fullname` string — User full name
      - `id` integer — User ID
      - `phone` string — User phone number
    - `custom_id` string — Custom Identifier
    - `description` string — Description
    - `display` string — Display Name
    - `id` integer — Bundle ID
    - `images` string[] — List of Image URLs
    - `is_bundle_sharing` boolean — Is Bundle Sharing Enabled
    - `last_updated_at` string, date-time — Last update timestamp
    - `last_updated_by` object
      - `aff_code` string — Affiliate code of the user
      - `avatar` string, uri — URL to user avatar
      - `email` string, email — User email
      - `fullname` string — User full name
      - `id` integer — User ID
      - `phone` string — User phone number
    - `name` string — Name
    - `public_name` string — Public Name
    - `variants_count` integer — Number of variants in the bundle
    - `weight_bump` integer — Weight Bump
  - `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/revisions/4354959d76dc/schema)
