@mercurjs/docs 2.2.0-canary.40

package/content/references/api/admin/sellers/approve-seller.mdx

@@ -0,0 +1,54 @@
+---
+title: "Approve Seller"
+api: "POST /admin/sellers/{id}/approve"
+description: "Approve a pending seller."
+---
+
+Moves the seller from `pending_approval` to `open` and sets `approved_at`.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="status" type="string">The seller's status, `open` after approval.</ResponseField>
+    <ResponseField name="approved_at" type="string">When the seller was approved.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/approve' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { seller } = await client.admin.sellers.$id.approve.mutate({
+  $id: "sel_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "seller": {
+    "id": "sel_01HXYZABCDEF",
+    "name": "Acme",
+    "handle": "acme",
+    "status": "open",
+    "approved_at": "2026-06-02T09:30:00.000Z",
+    "updated_at": "2026-06-02T09:30:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/create-seller.mdx

@@ -0,0 +1,100 @@
+---
+title: "Create Seller"
+api: "POST /admin/sellers"
+description: "Create a new seller account."
+---
+
+Creates a seller and its initial owner member.
+
+<Note>
+The `member.email` must belong to an existing or invited user; the seller is created with status `pending_approval` unless a `status` is provided.
+</Note>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Body parameters
+
+<ParamField body="name" type="string" required>Display name of the seller.</ParamField>
+<ParamField body="email" type="string" required>Contact email of the seller.</ParamField>
+<ParamField body="currency_code" type="string" required>The seller's currency code.</ParamField>
+<ParamField body="member" type="object" required>
+  The initial owner member of the seller.
+  <Expandable title="properties">
+    <ParamField body="email" type="string" required>Email of the owner member.</ParamField>
+  </Expandable>
+</ParamField>
+<ParamField body="handle" type="string">Unique URL-safe handle, generated from the name if omitted.</ParamField>
+<ParamField body="phone" type="string">Contact phone number.</ParamField>
+<ParamField body="description" type="string">Seller description.</ParamField>
+<ParamField body="logo" type="string">URL of the seller's logo.</ParamField>
+<ParamField body="banner" type="string">URL of the seller's banner image.</ParamField>
+<ParamField body="website_url" type="string">The seller's website URL.</ParamField>
+<ParamField body="external_id" type="string">ID of the seller in an external system.</ParamField>
+<ParamField body="status" type="string" default="pending_approval">One of `open`, `pending_approval`, `suspended`, `terminated`.</ParamField>
+<ParamField body="status_reason" type="string">Reason recorded with the status.</ParamField>
+<ParamField body="is_premium" type="boolean">Whether the seller is marked as premium.</ParamField>
+<ParamField body="closed_from" type="string">Start of a temporary store closure.</ParamField>
+<ParamField body="closed_to" type="string">End of a temporary store closure.</ParamField>
+<ParamField body="closure_note" type="string">Note shown while the store is closed.</ParamField>
+<ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+<ParamField body="additional_data" type="object">Extra data passed to workflow hooks.</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="name" type="string">Display name of the seller.</ResponseField>
+    <ResponseField name="handle" type="string">Unique URL-safe handle.</ResponseField>
+    <ResponseField name="email" type="string">Contact email of the seller.</ResponseField>
+    <ResponseField name="currency_code" type="string">The seller's currency code.</ResponseField>
+    <ResponseField name="status" type="string">One of `open`, `pending_approval`, `suspended`, `terminated`.</ResponseField>
+    <ResponseField name="is_premium" type="boolean">Whether the seller is marked as premium.</ResponseField>
+    <ResponseField name="members" type="object[]">The seller's members.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/sellers' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "name": "Acme",
+    "email": "hello@acme.co",
+    "currency_code": "usd",
+    "member": { "email": "owner@acme.co" }
+  }'
+```
+
+```ts JS Client
+const { seller } = await client.admin.sellers.mutate({
+  name: "Acme",
+  email: "hello@acme.co",
+  currency_code: "usd",
+  member: { email: "owner@acme.co" },
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 201
+{
+  "seller": {
+    "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"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/delete-member-invite.mdx

@@ -0,0 +1,42 @@
+---
+title: "Delete Member Invite"
+api: "DELETE /admin/sellers/{id}/members/invites/{invite_id}"
+description: "Delete a seller's member invite."
+---
+
+Deletes a pending member invite.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+<ParamField path="invite_id" type="string" required>The invite's ID.</ParamField>
+
+## Response
+
+<ResponseField name="id" type="string">ID of the deleted invite.</ResponseField>
+<ResponseField name="object" type="string">Always `member_invite`.</ResponseField>
+<ResponseField name="deleted" type="boolean">Whether the invite was deleted.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X DELETE 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/members/invites/meminv_01HXYZINVAA' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const result = await client.admin.sellers.$id.members.invites.$inviteId.delete({
+  $id: "sel_01HXYZABCDEF",
+  $inviteId: "meminv_01HXYZINVAA",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "id": "meminv_01HXYZINVAA",
+  "object": "member_invite",
+  "deleted": true
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/delete-professional-details.mdx

@@ -0,0 +1,52 @@
+---
+title: "Delete Professional Details"
+api: "DELETE /admin/sellers/{id}/professional-details"
+description: "Delete a seller's professional details."
+---
+
+Removes the seller's professional details and returns the updated seller.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="professional_details" type="object">The seller's professional details, `null` after deletion.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X DELETE 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/professional-details' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { seller } = await client.admin.sellers.$id.professionalDetails.delete({
+  $id: "sel_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "seller": {
+    "id": "sel_01HXYZABCDEF",
+    "name": "Acme",
+    "status": "open",
+    "professional_details": null,
+    "updated_at": "2026-06-12T12:00:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/invite-seller-member.mdx

@@ -0,0 +1,63 @@
+---
+title: "Invite Seller Member"
+api: "POST /admin/sellers/{id}/members/invite"
+description: "Invite a new member to a seller's team by email."
+---
+
+Creates a member invite for the given email and role.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="email" type="string" required>Email address to invite.</ParamField>
+<ParamField body="role_id" type="string" required>ID of the role assigned once the invite is accepted.</ParamField>
+
+## Response
+
+<ResponseField name="member_invite" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The invite's ID.</ResponseField>
+    <ResponseField name="email" type="string">Invited email address.</ResponseField>
+    <ResponseField name="role_id" type="string">Role assigned on acceptance.</ResponseField>
+    <ResponseField name="accepted" type="boolean">Whether the invite was accepted.</ResponseField>
+    <ResponseField name="token" type="string">Token used to accept the invite.</ResponseField>
+    <ResponseField name="expires_at" type="string">When the invite expires.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/members/invite' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"email": "new.member@acme.co", "role_id": "role_01HXYZROLEAA"}'
+```
+
+```ts JS Client
+const { member_invite } = await client.admin.sellers.$id.members.invite.mutate({
+  $id: "sel_01HXYZABCDEF",
+  email: "new.member@acme.co",
+  role_id: "role_01HXYZROLEAA",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 201
+{
+  "member_invite": {
+    "id": "meminv_01HXYZINVAA",
+    "email": "new.member@acme.co",
+    "role_id": "role_01HXYZROLEAA",
+    "accepted": false,
+    "token": "inv_token_abc123",
+    "expires_at": "2026-06-22T09:00:00.000Z",
+    "created_at": "2026-06-15T09:00:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/list-member-invites.mdx

@@ -0,0 +1,71 @@
+---
+title: "List Member Invites"
+api: "GET /admin/sellers/{id}/members/invites"
+description: "Retrieve a paginated list of a seller's member invites."
+---
+
+Returns all member invites created for the seller.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="50">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Response
+
+<ResponseField name="member_invites" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The invite's ID.</ResponseField>
+    <ResponseField name="email" type="string">Invited email address.</ResponseField>
+    <ResponseField name="role_id" type="string">Role assigned on acceptance.</ResponseField>
+    <ResponseField name="accepted" type="boolean">Whether the invite was accepted.</ResponseField>
+    <ResponseField name="token" type="string">Token used to accept the invite.</ResponseField>
+    <ResponseField name="expires_at" type="string">When the invite expires.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of invites.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/members/invites' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { member_invites } = await client.admin.sellers.$id.members.invites.query({
+  $id: "sel_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "member_invites": [
+    {
+      "id": "meminv_01HXYZINVAA",
+      "email": "new.member@acme.co",
+      "role_id": "role_01HXYZROLEAA",
+      "accepted": false,
+      "token": "inv_token_abc123",
+      "expires_at": "2026-06-22T09:00:00.000Z",
+      "created_at": "2026-06-15T09:00:00.000Z",
+      "updated_at": "2026-06-15T09:00:00.000Z"
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 50
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/list-seller-members.mdx

@@ -0,0 +1,71 @@
+---
+title: "List Seller Members"
+api: "GET /admin/sellers/{id}/members"
+description: "Retrieve a paginated list of a seller's members."
+---
+
+Returns the members of the seller's team, including their user record and role.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="50">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Response
+
+<ResponseField name="seller_members" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller member's ID.</ResponseField>
+    <ResponseField name="is_owner" type="boolean">Whether this member owns the seller account.</ResponseField>
+    <ResponseField name="member" type="object">The underlying member record, including its email.</ResponseField>
+    <ResponseField name="rbac_role" type="object">The role assigned to the member.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of seller members.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/members' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { seller_members } = await client.admin.sellers.$id.members.query({
+  $id: "sel_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "seller_members": [
+    {
+      "id": "selmem_01HXYZSMAA",
+      "is_owner": true,
+      "member": {
+        "id": "mem_01HXYZMEMAA",
+        "email": "owner@acme.co"
+      },
+      "rbac_role": {
+        "id": "role_01HXYZROLEAA",
+        "name": "Owner"
+      },
+      "created_at": "2026-06-01T10:00:00.000Z"
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 50
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/list-seller-products.mdx

@@ -0,0 +1,85 @@
+---
+title: "List Seller Products"
+api: "GET /admin/sellers/{id}/products"
+description: "Retrieve a paginated list of a seller's products."
+---
+
+Returns the products owned by the seller.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The seller's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="50">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+<ParamField query="q" type="string">Search term matched against product fields.</ParamField>
+<ParamField query="id" type="string | string[]">Filter by product ID(s).</ParamField>
+<ParamField query="status" type="string | string[]">Filter by product status.</ParamField>
+<ParamField query="collection_id" type="string | string[]">Filter by collection ID(s).</ParamField>
+<ParamField query="sales_channel_id" type="string | string[]">Filter by sales channel ID(s).</ParamField>
+<ParamField query="type_id" type="string | string[]">Filter by product type ID(s).</ParamField>
+<ParamField query="tag_id" type="string | string[]">Filter by product tag ID(s).</ParamField>
+<ParamField query="created_at" type="object">Filter by creation date with operators like `$gte`, `$lte`.</ParamField>
+<ParamField query="updated_at" type="object">Filter by update date with operators like `$gte`, `$lte`.</ParamField>
+
+## Response
+
+<ResponseField name="products" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The product's ID.</ResponseField>
+    <ResponseField name="title" type="string">Product title.</ResponseField>
+    <ResponseField name="handle" type="string">Unique URL-safe handle.</ResponseField>
+    <ResponseField name="status" type="string">Product status, e.g. `draft` or `published`.</ResponseField>
+    <ResponseField name="thumbnail" type="string">URL of the product's thumbnail.</ResponseField>
+    <ResponseField name="collection" type="object">The product's collection.</ResponseField>
+    <ResponseField name="sales_channels" type="object[]">Sales channels the product is available in.</ResponseField>
+    <ResponseField name="variants" type="object[]">The product's variants (IDs only by default).</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of the seller's products.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/products?limit=20' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { products, count } = await client.admin.sellers.$id.products.query({
+  $id: "sel_01HXYZABCDEF",
+  limit: 20,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "products": [
+    {
+      "id": "prod_01HXYZPRODAA",
+      "title": "Canvas Tote Bag",
+      "handle": "canvas-tote-bag",
+      "status": "published",
+      "thumbnail": "https://cdn.example.com/tote.jpg",
+      "collection": null,
+      "sales_channels": [],
+      "variants": [{ "id": "variant_01HXYZVARAA" }],
+      "created_at": "2026-06-03T10:00:00.000Z",
+      "updated_at": "2026-06-03T10:00:00.000Z"
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 20
+}
+```
+</ResponseExample>

package/content/references/api/admin/sellers/list-sellers.mdx

@@ -0,0 +1,96 @@
+---
+title: "List Sellers"
+api: "GET /admin/sellers"
+description: "Retrieve a paginated list of sellers."
+---
+
+Returns all sellers on the marketplace, with optional filtering by status, handle, email, and more.
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="50">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+<ParamField query="q" type="string">Search term matched against seller fields.</ParamField>
+<ParamField query="id" type="string | string[]">Filter by seller ID(s).</ParamField>
+<ParamField query="name" type="string | string[]">Filter by seller name(s).</ParamField>
+<ParamField query="handle" type="string">Filter by seller handle.</ParamField>
+<ParamField query="email" type="string">Filter by seller email.</ParamField>
+<ParamField query="status" type="string | string[]">Filter by status: `open`, `pending_approval`, `suspended`, or `terminated`.</ParamField>
+<ParamField query="is_premium" type="boolean">Filter by premium flag.</ParamField>
+<ParamField query="created_at" type="object">Filter by creation date with operators like `$gte`, `$lte`.</ParamField>
+<ParamField query="updated_at" type="object">Filter by update date with operators like `$gte`, `$lte`.</ParamField>
+
+## Response
+
+<ResponseField name="sellers" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="name" type="string">Display name of the seller.</ResponseField>
+    <ResponseField name="handle" type="string">Unique URL-safe handle.</ResponseField>
+    <ResponseField name="email" type="string">Contact email of the seller.</ResponseField>
+    <ResponseField name="phone" type="string">Contact phone number.</ResponseField>
+    <ResponseField name="description" type="string">Seller description.</ResponseField>
+    <ResponseField name="logo" type="string">URL of the seller's logo.</ResponseField>
+    <ResponseField name="banner" type="string">URL of the seller's banner image.</ResponseField>
+    <ResponseField name="website_url" type="string">The seller's website URL.</ResponseField>
+    <ResponseField name="external_id" type="string">ID of the seller in an external system.</ResponseField>
+    <ResponseField name="currency_code" type="string">The seller's currency code.</ResponseField>
+    <ResponseField name="status" type="string">One of `open`, `pending_approval`, `suspended`, `terminated`.</ResponseField>
+    <ResponseField name="status_reason" type="string">Reason recorded with the latest status change.</ResponseField>
+    <ResponseField name="approved_at" type="string">When the seller was approved.</ResponseField>
+    <ResponseField name="rejected_at" type="string">When the seller was rejected.</ResponseField>
+    <ResponseField name="is_premium" type="boolean">Whether the seller is marked as premium.</ResponseField>
+    <ResponseField name="closed_from" type="string">Start of a temporary store closure.</ResponseField>
+    <ResponseField name="closed_to" type="string">End of a temporary store closure.</ResponseField>
+    <ResponseField name="closure_note" type="string">Note shown while the store is closed.</ResponseField>
+    <ResponseField name="address" type="object">The seller's address.</ResponseField>
+    <ResponseField name="payment_details" type="object">The seller's bank payment details.</ResponseField>
+    <ResponseField name="professional_details" type="object">The seller's legal and tax details.</ResponseField>
+    <ResponseField name="payout_account" type="object">The seller's payout account with status and onboarding data.</ResponseField>
+    <ResponseField name="metadata" type="object">Custom key-value data.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of matching sellers.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/sellers?status=pending_approval&limit=20' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { sellers, count } = await client.admin.sellers.query({
+  status: "pending_approval",
+  limit: 20,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "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
+}
+```
+</ResponseExample>