The account’s payout balance

The account's payout balance buckets in USD dollars: the creator side at the top level, plus total and sides for everything the account owns.

The top-level buckets are the creator side (own sales), unchanged since this endpoint launched. total is the full payable balance — the same numbers the Payouts page shows and a payout request pays out: creator side + agency side (income from managed creators and AI personas) + referral commission + partner shares. sides breaks total down.

Bucket semantics: pending is revenue still inside the chargeback hold window; available has cleared the hold and is what a payout request pays out; processing is inside a payout currently being executed; paidOut is the lifetime total already paid. available can be negative (a refund of money already paid out is netted against future earnings).

{
  "currency": "USD",
  "pending": 120.5,
  "available": 300.1,
  "processing": 0,
  "paidOut": 1755,
  "total": {
    "pending": 120.5,
    "available": 342.1,
    "processing": 0,
    "paidOut": 1875
  },
  "sides": {
    "creator": {
      "pending": 120.5,
      "available": 300.1,
      "processing": 0,
      "paidOut": 1755
    },
    "agency": {
      "pending": 0,
      "available": 42,
      "processing": 0,
      "paidOut": 120
    },
    "affiliate": {
      "pending": 0,
      "available": 0,
      "processing": 0,
      "paidOut": 0
    },
    "share": {
      "pending": 0,
      "available": 0,
      "processing": 0,
      "paidOut": 0
    }
  }
}

curl "https://www.dropfans.io/api/external/v1/balance" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"

const res = await fetch(`https://www.dropfans.io/api/external/v1/balance`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.dropfans.io/api/external/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())