Skip to main content
GET
/
store
/
sellers
curl 'http://localhost:9000/store/sellers?limit=20' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'

{
  "sellers": [
    {
      "id": "sel_01JB2K8A1B",
      "name": "Nordic Textiles",
      "handle": "nordic-textiles",
      "description": "Scandinavian linen and wool.",
      "logo": "https://cdn.example.com/nordic-logo.png",
      "banner": null,
      "is_premium": false,
      "metadata": null
    }
  ],
  "count": 12,
  "offset": 0,
  "limit": 20
}
Returns a paginated list of sellers; only sellers with status open that are outside any scheduled closure window (closed_from / closed_to) are included.

​
Query parameters

​
limit
number
default:"50"
Maximum number of sellers to return.
​
offset
number
default:"0"
Number of sellers to skip before collecting results.
​
order
string
Field to sort by, prefixed with - for descending order.
​
fields
string
Comma-separated fields and relations to include; prefix with +/- to add to or remove from the defaults.
​
q
string
Free-text search term applied to seller fields.
​
id
string | string[]
Filter by one or more seller IDs.
​
name
string | string[]
Filter by one or more seller names.
​
handle
string
Filter by seller handle.
​
is_premium
boolean
Filter premium sellers.
​
created_at
object
Filter by creation date using operators like $gt, $gte, $lt, $lte.
​
updated_at
object
Filter by update date using operators like $gt, $gte, $lt, $lte.

​
Response

​
sellers
object[]
​
count
number
Total number of matching sellers.
​
offset
number
Number of skipped sellers.
​
limit
number
Maximum number of returned sellers.
curl 'http://localhost:9000/store/sellers?limit=20' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'

{
  "sellers": [
    {
      "id": "sel_01JB2K8A1B",
      "name": "Nordic Textiles",
      "handle": "nordic-textiles",
      "description": "Scandinavian linen and wool.",
      "logo": "https://cdn.example.com/nordic-logo.png",
      "banner": null,
      "is_premium": false,
      "metadata": null
    }
  ],
  "count": 12,
  "offset": 0,
  "limit": 20
}