Endpoint
Authentication
This endpoint requires an active creator session. You must be logged in — the API reads your identity from the session cookie set when you signed into your Tip Stack account. There is no Bearer token option for this endpoint.Query Parameters
This endpoint does not accept any query parameters. All payout records for the authenticated creator are returned, ordered bycreatedAt descending (most recent first), up to the 50 most recent entries.
Response
true when the request completed successfully.An array of payout records. Sorted newest-first, capped at 50 entries.
Status Values
| Status | Meaning |
|---|---|
pending | Recorded in the Tip Stack ledger; not yet sent to the payout provider. |
submitted | Accepted by Fossa Pay and queued for processing. |
processing | The bank transfer is actively in progress. |
completed | Funds have been credited to your bank account. |
failed | The payout was rejected or encountered an error. Contact support with the reference. |
Example
Request
Response
The
amountUSDC field is an approximation back-calculated from amountNGN using a fixed reference rate. It may differ from the exact USD amount you originally requested. For the precise withdrawal amount, refer to your original withdrawal request.Error Responses
| Status | Error | Cause |
|---|---|---|
401 Unauthorized | "Unauthorized" | No active session cookie was found, or your session has expired. |
500 Server Error | "Internal Server Error" | An unexpected error occurred on the server. |
