Reading the numbers · Airaa Docs

Several field names here hold something different from what they promise. The three that catch people out are money, views and which username you are looking at.

Money

A submission's money splits across five fields. The question each one answers is whether the amount has already left your budget.

Field	Already sent?	What it is
`estimatedPayout`	No	What this submission would earn at its current view count.
`basePaidAmount`	Yes	Paid out from the per-view rate.
`bonusPaidAmount`	Yes	Paid out from hitting view milestones.
`totalPaidAmount`	Yes	`basePaidAmount` + `bonusPaidAmount`. Money that has left the budget.
`accruedUnpaid`	No	Owed to the creator but not yet sent. Splits into `accruedBaseAmount` and `accruedBonusAmount`.

What a creator has received is totalPaidAmount. What you still owe them is accruedUnpaid. estimatedPayout overlaps with neither and should not be added to either.

cumulativePaidAmount is the same number as totalPaidAmount. The payout ledger in submissionActions is the audit trail behind these totals: one row per approval, payment or milestone bonus, newest first, each stamped with the view count at the time.

At campaign level, budget.remainingPool is what has not been committed yet, and budget.accruedUnpaid is what is owed across every row in that campaign.

Views

Creators are paid on the views a clip gained after it was submitted, not on its lifetime total.

initialViews is the view count when the clip was submitted.
currentViews is the view count now.
deltaViews is currentViews minus initialViews. This is the part that pays.
viewCount is an alias for deltaViews, not for currentViews.

The same split appears on a campaign's clippingOwner.overview as initialReach, currentReach and reach. There, reach is the paying figure.

Identity

Two different things are called username, and which one you get depends on the endpoint.

Endpoint	`username` is	Airaa username is
`get_bounty_campaign_submissions`	the handle on the posting platform	`userUsername`
`get_video_campaign_submissions`	not present	`creatorUsername`
`get_project_members_detailed`	the Airaa username	`username`
`get_project_earnings_leaderboard`	the Airaa username	`username`
`get_chat_threads`	the Airaa username	`username`

Platform handles, meaning the creator's name on X, TikTok, Instagram or YouTube, always live in platforms[].externalUsername or socialConnections[].externalUsername where a response carries them.

To join rows across endpoints, use the ids rather than any name: userId on bounty submissions and members, creatorUserId on video submissions and chat.

→ See these fields on a real submission