Sellers
Retrieve Seller
Retrieve a seller by ID.
GET
/
admin
/
sellers
/
{id}
curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF' \
-H 'Authorization: Bearer <token>'
const { seller } = await client.admin.sellers.$id.query({
$id: "sel_01HXYZABCDEF",
})
{
"seller": {
"id": "sel_01HXYZABCDEF",
"name": "Acme",
"handle": "acme",
"email": "hello@acme.co",
"currency_code": "usd",
"status": "open",
"approved_at": "2026-06-02T09:30:00.000Z",
"is_premium": false,
"address": null,
"payment_details": null,
"professional_details": null,
"members": [],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-02T09:30:00.000Z"
}
}
Returns a single seller, including address, payment details, professional details, payout account, and members.
Path parameters
string
required
The seller’s ID.
Query parameters
string
Comma-separated list of fields to include, prefix with
+/- to add or remove from defaults.Response
object
Show properties
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
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.
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[]
The seller’s members.
object
Custom key-value data.
string
Creation timestamp.
string
Last update timestamp.
curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF' \
-H 'Authorization: Bearer <token>'
const { seller } = await client.admin.sellers.$id.query({
$id: "sel_01HXYZABCDEF",
})
{
"seller": {
"id": "sel_01HXYZABCDEF",
"name": "Acme",
"handle": "acme",
"email": "hello@acme.co",
"currency_code": "usd",
"status": "open",
"approved_at": "2026-06-02T09:30:00.000Z",
"is_premium": false,
"address": null,
"payment_details": null,
"professional_details": null,
"members": [],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-02T09:30:00.000Z"
}
}
⌘I
curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF' \
-H 'Authorization: Bearer <token>'
const { seller } = await client.admin.sellers.$id.query({
$id: "sel_01HXYZABCDEF",
})
{
"seller": {
"id": "sel_01HXYZABCDEF",
"name": "Acme",
"handle": "acme",
"email": "hello@acme.co",
"currency_code": "usd",
"status": "open",
"approved_at": "2026-06-02T09:30:00.000Z",
"is_premium": false,
"address": null,
"payment_details": null,
"professional_details": null,
"members": [],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-02T09:30:00.000Z"
}
}