Skip to main content
GET
/
vendor
/
payouts
curl 'http://localhost:9000/vendor/payouts?status=paid' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "payouts": [
    {
      "id": "pout_01HXYZ",
      "display_id": 42,
      "amount": 1250,
      "currency_code": "usd",
      "status": "paid",
      "created_at": "2026-01-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}
Returns the payouts belonging to the current seller.

​
Query parameters

​
limit
number
default:"20"
Maximum number of items to return.
​
offset
number
default:"0"
Number of items to skip.
​
order
string
Field to sort by, prefixed with - for descending order.
​
fields
string
Comma-separated fields to include in the response.
​
status
string | string[]
Filter by payout status: pending, processing, paid, failed, canceled.
​
created_at
object
Filter by creation date using operators like $gte, $lte, $gt, $lt.
​
updated_at
object
Filter by update date using operators like $gte, $lte, $gt, $lt.

​
Response

​
payouts
object[]
​
count
number
Total number of payouts.
​
offset
number
Number of items skipped.
​
limit
number
Maximum number of items returned.
curl 'http://localhost:9000/vendor/payouts?status=paid' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "payouts": [
    {
      "id": "pout_01HXYZ",
      "display_id": 42,
      "amount": 1250,
      "currency_code": "usd",
      "status": "paid",
      "created_at": "2026-01-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}