---
title: "Get Wix Payments payout"
method: GET
path: "/api/apps/{app_id}/payments/wix/payouts/{payout_id}"
---

# Get Wix Payments payout

`GET /api/apps/{app_id}/payments/wix/payouts/{payout_id}`

## Request

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

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

Returns one Wix Payments payout and the balance records it pays out, newest first.

The data is read live from Wix Payments. `summary_items` totals the whole payout by record type and is filled in only on the first page.

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.

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

## Path parameters

- `payout_id` string, required: ID of the payout, taken from `id` on a payout from [List Wix Payments payouts](/api-reference/list-wix-payments-payouts).
- `app_id` string, required: ID of the Base44 app.

## Query parameters

- `cursor` string: `next_cursor` from the previous page of records. Leave it out to get the first page.
- `limit` integer: Balance records per page, from 1 to 100. Defaults to 50. Send it only on the first page.

## Response `200`

The payout and one page of its balance records.

- PayoutDetail
  - `payout` PayoutItem, required
    - `id` string, required: Wix Payments ID of the payout. Pass it to [Get Wix Payments payout](/api-reference/get-wix-payments-payout).
    - `date` string, required: Date the payout was created, as `YYYY-MM-DD`.
    - `estimated_arrival` string, nullable, required: Date the funds are expected to reach the bank account, as `YYYY-MM-DD`, or `null` when Wix doesn't give one.
    - `status` string, required: Wix Payments payout status, lowercased, for example `sent` or `failed`. Wix can add values, so handle ones you don't recognize. `unknown` when Wix returns no status.
    - `money` PayoutMoney, required
      - `amount` integer, required: Amount in the currency's smallest unit, such as cents, so `21485` is 214.85 in USD.
      - `currency` string, required: Lowercase three-letter ISO 4217 currency code.
    - `account_profile_id` string, nullable, required: ID of the Wix Payments account profile the payout belongs to, or `null` when Wix doesn't return one.
    - `bank_transfer_reference` string, nullable: Reference the bank shows for the transfer, or `null` when there isn't one yet.
    - `failure_reason` string, nullable: Wix's code for why the payout failed, or `null` when it didn't fail.
  - `records` PayoutRecord[], required: One page of the balance records the payout pays out, newest first.
    - `id` string, required: Wix Payments ID of the balance record.
    - `type` string, required: Wix balance record type, lowercased, for example `credit`. `unknown` when Wix returns none.
    - `date` string, required: Date the record was applied to the balance, as `YYYY-MM-DD`.
    - `money` PayoutMoney, required
      - `amount` integer, required: Amount in the currency's smallest unit, such as cents, so `21485` is 214.85 in USD.
      - `currency` string, required: Lowercase three-letter ISO 4217 currency code.
    - `fee` integer, required: Fee Wix took on the record, in the smallest unit of `money.currency`.
    - `net` integer, required: Amount left after the fee, in the smallest unit of `money.currency`.
    - `transaction_id` string, nullable, required: Wix Payments ID of the transaction behind the record, or `null` when the record has no transaction behind it.
    - `transaction_timestamp` string, nullable, required: When the transaction behind the record was created, as an ISO 8601 timestamp, or `null` when there's no transaction.
    - `payment_method` string, nullable, required: Wix's ID for the payment method the customer used, for example `creditCard`, or `null` when Wix doesn't return one.
  - `summary_items` PayoutSummaryItem[], required: Totals for the whole payout, one entry per record type. Only on the first page, and empty on later ones.
    - `type` string, required: Wix summary type, lowercased, for example `credits`. `unknown` when Wix returns none.
    - `amount` PayoutMoney, required
      - `amount` integer, required: Amount in the currency's smallest unit, such as cents, so `21485` is 214.85 in USD.
      - `currency` string, required: Lowercase three-letter ISO 4217 currency code.
    - `fees` PayoutMoney, required
      - `amount` integer, required: Amount in the currency's smallest unit, such as cents, so `21485` is 214.85 in USD.
      - `currency` string, required: Lowercase three-letter ISO 4217 currency code.
    - `net` PayoutMoney, required
      - `amount` integer, required: Amount in the currency's smallest unit, such as cents, so `21485` is 214.85 in USD.
      - `currency` string, required: Lowercase three-letter ISO 4217 currency code.
  - `records_total` integer, required: Total number of the payout's balance records created before the first page was read.
  - `has_more` boolean, required: Whether more records follow this page.
  - `next_cursor` string, nullable, required: Pass as `cursor` to get the next page of records, or `null` on the last page. Expires after 24 hours.

## Other responses

- `400`: `cursor` is malformed, expired, or from another app, or `limit` was sent with it (`invalid_request`). Also returned when the cursor was issued for a different payout or Wix site (`invalid_cursor`).
- `401`: Missing or invalid credentials.
- `403`: You don't have write access to the app, or your personal access token is read-only (`forbidden`). Also returned when the app's workspace doesn't allow payment management (`app_payment_management_not_allowed`).
- `404`: The payout isn't one of the app's Wix Payments payouts (`payout_not_found`), Wix Payments isn't connected to the app (`wix_payments_not_connected`), or the app is outside the credential's grant (`not_found`).
- `409`: The workspace requires an unlocked SSO session.
- `422`: `limit` isn't a whole number from 1 to 100 (`invalid_request`). `error.details.errors` lists each problem.
- `429`: Rate limit reached (`rate_limited`). The base limit is 60 requests per minute, scoped to your account rather than the workspace. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-21** `c23775445de2`: 3 breaking, 2 warning, 1 info
  - `query` request parameter `cursor` list-of-types was narrowed by removing types `null`
  - `query` request parameter `limit` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `limit`, the type changed from no type to `integer`
  - for the `query` request parameter `limit`, the max was set to `100.00`
  - …2 more
- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-09** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/payments/wix/payouts/:payout_id/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)