Payouts · Payout Requests

List Payouts

Your payouts, newest first.

GET request

URL: https://uat-api.vizodigital.com/api/v1/payouts

Include a valid Bearer token with every request

Code sample

curl -X GET "https://uat-api.vizodigital.com/api/v1/payouts" \
  -H "X-API-Key: YOUR_API_KEY_OR_TOKEN" \
  -H "X-Timestamp: $(TZ=Asia/Kolkata date '+%Y-%m-%d %H:%M:%S')"

Success Response

{
    "status": "success",
    "message": "Your payouts, newest first.",
    "data": [
        {
            "reference_id": "PO2026101400001",
            "amount": "1000.00",
            "fee": "10.00",
            "net_amount": "990.00",
            "status": "pending",
            "bank_account": {
                "id": 12,
                "account_last4": "0000"
            },
            "utr": null,
            "reject_reason": null,
            "created_at": "2026-10-14T11:20:00+05:30",
            "processed_at": null
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "per_page": 25,
        "total": 1
    }
}

Failure response

{
    "message": "Invalid or revoked API key."
}

Overview

Returns 25 payouts per page. Add ?page=2 for the next page and ?status=pending (or paid, rejected, cancelled) to filter.

Headers

X-API-Key · string required

Your credential: either your `rr_live_` API key, or the Bearer token from `POST /api/v1/auth/client-credentials` (the same token every other API uses). The token may instead be sent as `Authorization: Bearer <token>`. A token follows the same IP whitelist as your keys, and all your tokens share one requests-per-minute allowance.

Example: rr_live_xxxxxxxxxxxxx
X-Timestamp · string required

Current time in IST as `YYYY-MM-DD HH:MM:SS` (or `YYYY-MM-DDTHH:MM:SS`). Do not add a timezone suffix such as `+05:30`. Must be within 15 seconds of our server time.

Example: 2026-10-03 10:30:45

Responses

200 · application/json default

Success

Example

{
    "status": "success",
    "message": "Your payouts, newest first.",
    "data": [
        {
            "reference_id": "PO2026101400001",
            "amount": "1000.00",
            "fee": "10.00",
            "net_amount": "990.00",
            "status": "pending",
            "bank_account": {
                "id": 12,
                "account_last4": "0000"
            },
            "utr": null,
            "reject_reason": null,
            "created_at": "2026-10-14T11:20:00+05:30",
            "processed_at": null
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "per_page": 25,
        "total": 1
    }
}

401 · application/json

Failed or rejected

Example

{
    "message": "Invalid or revoked API key."
}

Errors

INVALID_API_KEY · HTTP 401

Invalid or revoked API key.
```
{
    "message": "Invalid or revoked API key."
}
```
TIMESTAMP_OUT_OF_RANGE · HTTP 400

Request timestamp is outside the ±15 second window.
```
{
    "message": "Request timestamp is outside the ±15 second window."
}
```
RATE_LIMITED · HTTP 429

Rate limit exceeded.
```
{
    "message": "Rate limit exceeded."
}
```

Rate Limits

100/min