List Sellers

GET

admin

sellers

curl 'http://localhost:9000/admin/sellers?status=pending_approval&limit=20' \
  -H 'Authorization: Bearer <token>'

const { sellers, count } = await client.admin.sellers.query({
  status: "pending_approval",
  limit: 20,
})

{
  "sellers": [
    {
      "id": "sel_01HXYZABCDEF",
      "name": "Acme",
      "handle": "acme",
      "email": "hello@acme.co",
      "currency_code": "usd",
      "status": "pending_approval",
      "is_premium": false,
      "created_at": "2026-06-01T10:00:00.000Z",
      "updated_at": "2026-06-01T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

Returns all sellers on the marketplace, with optional filtering by status, handle, email, and more.

Query parameters

number

default:"50"

Maximum number of records to return.

number

default:"0"

Number of records to skip.

string

Field to sort by, prefix with - for descending order.

string

Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.

string

Search term matched against seller fields.

string | string[]

Filter by seller ID(s).

string | string[]

Filter by seller name(s).

string

Filter by seller handle.

string

Filter by seller email.

string | string[]

Filter by status: open, pending_approval, suspended, or terminated.

boolean

Filter by premium flag.

object

Filter by creation date with operators like $gte, $lte.

object

Filter by update date with operators like $gte, $lte.

Response

object[]

Show properties

string

The seller’s ID.

string

Display name of the seller.

string

Unique URL-safe handle.

string

Contact email of the seller.

string

Contact phone number.

string

Seller description.

string

URL of the seller’s logo.

string

URL of the seller’s banner image.

string

The seller’s website URL.

string

ID of the seller in an external system.

string

The seller’s currency code.

string

One of open, pending_approval, suspended, terminated.

string

Reason recorded with the latest status change.

string

When the seller was approved.

string

When the seller was rejected.

boolean

Whether the seller is marked as premium.

string

Start of a temporary store closure.

string

End of a temporary store closure.

string

Note shown while the store is closed.

object

The seller’s address.

object

The seller’s bank payment details.

object

The seller’s legal and tax details.

object

The seller’s payout account with status and onboarding data.

object

Custom key-value data.

string

Creation timestamp.

string

Last update timestamp.

number

Total number of matching sellers.

number

Number of records skipped.

number

Number of records returned.

curl 'http://localhost:9000/admin/sellers?status=pending_approval&limit=20' \
  -H 'Authorization: Bearer <token>'

const { sellers, count } = await client.admin.sellers.query({
  status: "pending_approval",
  limit: 20,
})

{
  "sellers": [
    {
      "id": "sel_01HXYZABCDEF",
      "name": "Acme",
      "handle": "acme",
      "email": "hello@acme.co",
      "currency_code": "usd",
      "status": "pending_approval",
      "is_premium": false,
      "created_at": "2026-06-01T10:00:00.000Z",
      "updated_at": "2026-06-01T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

curl 'http://localhost:9000/admin/sellers?status=pending_approval&limit=20' \
  -H 'Authorization: Bearer <token>'

const { sellers, count } = await client.admin.sellers.query({
  status: "pending_approval",
  limit: 20,
})

{
  "sellers": [
    {
      "id": "sel_01HXYZABCDEF",
      "name": "Acme",
      "handle": "acme",
      "email": "hello@acme.co",
      "currency_code": "usd",
      "status": "pending_approval",
      "is_premium": false,
      "created_at": "2026-06-01T10:00:00.000Z",
      "updated_at": "2026-06-01T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Query parameters

Response

​Query parameters

​Response

Query parameters

Response