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 (bare UUID).
`limit` number	1–100, default 20.

curl "https://baynoy.com/api/v1/payouts?status=paid&limit=20" \
  -H "Authorization: Bearer sk_test_…"

Response

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
        "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
  }
}