API reference

Payouts

Payouts move money from your Baynoy balance to your bank account. Initiating a payout requires a dashboard session — it's intentionally not API-callable to keep a stolen secret from draining funds. Reading the payout history IS API-callable so partners can reconcile.

List payouts

GET/v1/payoutsscope: payouts:read

Cursor-paginated, newest first. Filter by status to see pending / in-transit / paid / failed / cancelled rows separately.

Query parameters

`status` string	Filter by status. One of: `pending`, `in_transit`, `paid`, `failed`, `cancelled`
`cursor` string	Pagination cursor.
`pageSize` number	1–100, default 25.

curl "https://baynoy.com/api/v1/payouts?status=paid&pageSize=25" \
  -H "Authorization: Bearer sk_live_…"

Response

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "po_a1b2c3-...",
        "amount": "124000",
        "currency": "CHF",
        "destination": "bank",
        "method": "standard",
        "status": "paid",
        "providerRef": "po_1NXxYzABC123",
        "paidAt": "2026-05-26T09:00:00.000Z",
        "createdAt": "2026-05-24T18:42:13.000Z"
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
}