Get Bags Payout History

List the payouts of a token, newest first, with cursor pagination. Claims are not populated in history pages; use the single payout endpoint for them.

The status filter takes a comma-separated list of payout statuses and/or the groups in_progress, done and attention. Unknown query parameters are rejected.

GET /bags-payout/history

Get Bags payout history

cURL

curl --request GET \
  --url https://public-api-v2.bags.fm/api/v1/bags-payout/history \
  --header 'x-api-key: <api-key>'

200

{
  "success": true,
  "response": {
    "items": [
      {
        "id": "<string>",
        "tokenMint": "<string>",
        "origin": "claims",
        "status": "pending",
        "statusGroup": "in_progress",
        "statusLabel": "<string>",
        "cashoutMethod": "venmo",
        "username": "<string>",
        "claimCount": 123,
        "totalClaimedLamports": "<string>",
        "bridge": {
          "state": "pending",
          "amountInLamports": "<string>",
          "expectedOutRaw": "<string>",
          "minimumOutRaw": "<string>",
          "usdcReceivedRaw": "<string>",
          "relayRequestId": "<string>",
          "depositSignature": "<string>",
          "depositConfirmedAt": "<string>",
          "depositFeeLamports": "<string>",
          "fillTxHashes": [
            "<string>"
          ],
          "filledAt": "<string>",
          "retries": 123,
          "attempts": [
            {
              "outcome": "expired",
              "at": "<string>",
              "depositSignature": "<string>",
              "refundedLamports": "<string>"
            }
          ]
        },
        "order": {
          "depositId": "<string>",
          "amountRaw": "<string>",
          "carryInRaw": "<string>",
          "filledRaw": "<string>",
          "pendingRaw": "<string>",
          "returnedRaw": "<string>",
          "createTxHash": "<string>",
          "accessPolicyTxHashes": [
            "<string>"
          ],
          "withdrawTxHashes": [
            "<string>"
          ],
          "discountBps": 123,
          "discountTxHashes": [
            "<string>"
          ],
          "carryInFromPayoutIds": [
            "<string>"
          ],
          "listedAt": "<string>",
          "closedAt": "<string>",
          "fills": [
            {
              "status": "<string>",
              "amountRaw": "<string>",
              "fiatPaidCents": "<string>",
              "paidAt": "<string>",
              "signaledAt": "<string>",
              "fulfilledAt": "<string>"
            }
          ]
        },
        "usdcPaidRaw": "<string>",
        "fiatPaidCents": "<string>",
        "carryOutRaw": "<string>",
        "carryAppliedToPayoutId": "<string>",
        "claims": [
          {
            "signature": "<string>",
            "claimedLamports": "<string>",
            "slot": 123,
            "confirmedAt": "<string>"
          }
        ],
        "manualReviewReason": "relay_failed",
        "timeline": [
          {
            "status": "pending",
            "at": "<string>",
            "note": "<string>"
          }
        ],
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "completedAt": "<string>"
      }
    ],
    "hasMore": true,
    "nextCursor": "<string>"
  }
}

Authorizations

x-api-key · string · header · required

API key authentication. Provide your API key as the header value.

Query Parameters

tokenMint · string · required

Token mint address

limit · integer · default: 20

Number of payouts to return (1 to 50, default 20)

Required range: 1 <= x <= 50

cursor · string

Pagination cursor: the nextCursor of the previous page (24 hex characters)

Pattern: ^[0-9a-fA-F]{24}$

status · string

Comma-separated payout statuses and/or groups (in_progress, done, attention). Statuses: pending, bridging, bridged, listing, awaiting_buyer, matched, partially_paid, paid, closed, manual_review, cancelled. Omit for no filter.

Maximum string length: 256

Response

200

application/json

Successfully retrieved payout history

success · boolean · required

Example:

true

response · object

Show child attributes