List Wix Payments payouts

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the app's Wix Payments payouts, newest first, along with the funds scheduled to be paid out and the funds on hold.

The data is read live from Wix Payments. The first page also reads the account balance: scheduled and on_hold are filled in only there, and balance_unavailable is true when Wix couldn't return the balance while the payouts themselves still came back.

Pass next_cursor back as cursor to get the next page, and leave limit out when you do, since the cursor keeps the page size you started with. Every page covers only what was created before the first page was read, so a new one doesn't shift the pages you're walking. A cursor expires after 24 hours.

This endpoint is limited to 60 requests per minute, scoped to your account rather than the workspace.

To open the payouts page of the Wix Payments dashboard instead, call Get Wix Payments dashboard link with destination set to payouts.

<Note>This endpoint only reads, but it needs write access to the app, so a viewer is refused. A read-only personal access token is accepted. The app's workspace also has to allow payment management.</Note>

get/api/apps/{app_id}/payments/wix/payouts

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/payments/wix/payouts
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the Base44 app.

Query parameters

cursorstring

next_cursor from the previous page. Leave it out to get the first page.

limitinteger

Payouts per page, from 1 to 100. Defaults to 20. Send it only on the first page.

Response

One page of the app's payouts, with its scheduled and held funds on the first page.

balance_unavailableboolean required

true when Wix couldn't return the balance, so scheduled and on_hold are null even if funds exist. Always false on pages after the first, which don't read the balance.

totalinteger required

Total number of payouts created before the first page was read, as Wix reports it.

has_moreboolean required

Whether more payouts follow this page.

next_cursorstring nullable required

Pass as cursor to get the next page, or null on the last page. Expires after 24 hours.

Example response

{
  "payouts": [
    {
      "account_profile_id": "3f6d2a90-8e14-4c57-b2a9-6e0f1d7c4b28",
      "date": "2026-07-15",
      "estimated_arrival": "2026-07-18",
      "id": "7c1a3e52-4b0d-4f7e-9a61-2d8f5c3b9e10",
      "money": {
        "amount": 21485,
        "currency": "usd"
      },
      "status": "sent"
    }
  ],
  "scheduled": {
    "date": "2026-07-19",
    "money": {
      "amount": 21485,
      "currency": "usd"
    }
  },
  "on_hold": {
    "amount": 21485,
    "currency": "usd"
  },
  "total": 21,
  "has_more": true,
  "next_cursor": "gAAAAABn7vJ2kXq9..."
}

Changes

    • breaking

      query request parameter cursor list-of-types was narrowed by removing types null

    • breaking

      query request parameter limit list-of-types was narrowed by removing types null

    • breaking

      for the query request parameter limit, the type changed from no type to integer

    • warning

      for the query request parameter limit, the max was set to 100.00

    • warning

      for the query request parameter limit, the min was set to 1.00

    • info

      for the query request parameter cursor, the type was generalized from no type to string

    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth