---
title: "GET /balance/payouts"
method: GET
path: "/balance/payouts"
---

# GET /balance/payouts

`GET /balance/payouts`

Retrieve a list of payouts created within a specific time range, with support for filtering and pagination. This endpoint allows you to track and analyse all payout transactions to your account. It's useful for building dashboards, reconciling payouts, or reviewing recent payout transactions programmatically.

## Query parameters

- `startTime` integer
- `endTime` integer
- `limit` integer
- `offset` string

## Response `200`

Successful response with payouts and pagination cursor.

- GetPayoutsResponse
  - `data` Payout[], required
    - `payoutId` string, required — Unique identifier of the payout
    - `amount` integer, required — Amount in cents (USD)
    - `status` 'INITIATED' | 'SUCCESS' | 'FAILED', required — Current status of the payout
    - `createdAt` integer, required — Epoch timestamp in milliseconds of when the payout was created
  - `metadata` object, required
    - `offset` string — Pagination cursor for fetching the next page of results. Use this exact string as the `offset` parameter in your next API request. When this field is missing or null, you've reached the end of the results. For detailed pagination implementation guide, see [Pagination Guide](/developer-resources/pagination).

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/xpaycheckout/apis/xpay-api-store.md) · [All operations](https://skmtc.net/xpaycheckout/apis/xpay-api-store/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpaycheckout/xpay-api-store/versions/6329a7c694bc/schema)