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

{
  "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

​
limit
number
default:"50"
Maximum number of records to return.
​
offset
number
default:"0"
Number of records to skip.
​
order
string
Field to sort by, prefix with - for descending order.
​
fields
string
Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.
​
q
string
Search term matched against seller fields.
​
id
string | string[]
Filter by seller ID(s).
​
name
string | string[]
Filter by seller name(s).
​
handle
string
Filter by seller handle.
​
email
string
Filter by seller email.
​
status
string | string[]
Filter by status: open, pending_approval, suspended, or terminated.
​
is_premium
boolean
Filter by premium flag.
​
created_at
object
Filter by creation date with operators like $gte, $lte.
​
updated_at
object
Filter by update date with operators like $gte, $lte.

​
Response

​
sellers
object[]
​
count
number
Total number of matching sellers.
​
offset
number
Number of records skipped.
​
limit
number
Number of records returned.
curl 'http://localhost:9000/admin/sellers?status=pending_approval&limit=20' \
  -H 'Authorization: Bearer <token>'

{
  "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
}