Skip to main content
Use this endpoint to retrieve a full list of all withdrawal requests you have ever made from your Tip Stack account. Each record shows the NGN amount, the equivalent USDC value, the current processing status, and the reference you can use to follow up with support or Fossa Pay.

Endpoint

GET https://tipstack.fun/api/payouts/history

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 by createdAt descending (most recent first), up to the 50 most recent entries.

Response

success
boolean
true when the request completed successfully.
history
array
An array of payout records. Sorted newest-first, capped at 50 entries.

Status Values

StatusMeaning
pendingRecorded in the Tip Stack ledger; not yet sent to the payout provider.
submittedAccepted by Fossa Pay and queued for processing.
processingThe bank transfer is actively in progress.
completedFunds have been credited to your bank account.
failedThe payout was rejected or encountered an error. Contact support with the reference.

Example

Request

curl "https://tipstack.fun/api/payouts/history" \
  -b "session=YOUR_SESSION_COOKIE"

Response

{
  "success": true,
  "history": [
    {
      "id": 42,
      "reference": "FOSSA-1a2b3c4d5e6f7890",
      "amountUSDC": 50.00,
      "amountNGN": 80000,
      "status": "completed",
      "date": "2024-06-15T09:30:00.000Z"
    },
    {
      "id": 37,
      "reference": "FOSSA-9z8y7x6w5v4u3210",
      "amountUSDC": 20.00,
      "amountNGN": 32000,
      "status": "failed",
      "date": "2024-06-10T14:15:22.000Z"
    },
    {
      "id": 31,
      "reference": "FOSSA-abcdef1234567890",
      "amountUSDC": 100.00,
      "amountNGN": 160000,
      "status": "completed",
      "date": "2024-05-28T11:02:45.000Z"
    }
  ]
}
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

StatusErrorCause
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.