Endpoints
Attributes
string
required
Bounty ID, prefixed
bnty_.string[]
required
The deliverable shapes this bounty accepts. Every bounty accepts any combination of
content_url (posted links) and media (uploaded files), except data_capture bounties, whose proof is clips recorded in the Whop app that accumulate on the attempt.Available options: content_url, media, data_captureinteger
required
Submissions accepted so far.
integer
required
Number of submissions that can be accepted (winner slots).
What a referrer earns per accepted submission when the worker arrived through
their affiliate link, in whole currency units, at the standard platform fee
rate. Taken out of the worker’s post-fee reward rather than added on top.
0
when the bounty pays no affiliate share, including bounties tied to no
account, which cannot record a referral.string[]
required
Countries whose residents can work the bounty, as ISO 3166 alpha-2 codes.
Empty means worldwide.
number
required
Total gross budget committed to the bounty:
gross_reward_amount times
accepted_submissions_limit.string | null
required
What the poster wants the work to achieve, declared once at create.
null for bounties created before the taxonomy rolled out.Available options: clipping, post_engagement, owned_account_growth, ugc_content, local_activation, data_capture, otherstring | null
required
When cancellation was requested, as an ISO 8601 timestamp. On a
closed
bounty this means the cancel is pending: submissions are stopped and the
bounty cancels once in-flight submissions resolve. On a canceled bounty it
records when the cancellation was requested. null when no cancellation was
ever requested.object | null
required
The technical contract footage must be recorded against. Present only on
data_capture bounties; null for every other goal type.Properties
Properties
string
required
The naming convention for uploaded files, built from the required metadata
fields.
object
required
Inertial measurement unit (IMU) recording requirements.
Properties
Properties
string
required
Units for the device-motion channels, as a compact key=unit string.
string
required
Units for the magnetometer channel.
number
required
Minimum sustained IMU sample rate in hertz for a clip to pass validation.
integer
required
Target IMU sample rate in hertz.
number
required
Minimum IMU sample rate in hertz tolerated during the warmup window.
integer
required
Startup window, in nanoseconds, during which the relaxed warmup rate applies.
integer
required
Schema version the client must stamp on the capture manifest it uploads.
integer
required
Minimum length of a single clip, in seconds.
string[]
required
Metadata fields a submission must provide, matching the
metadata object on
the submissions API.boolean
required
Whether each clip must be one uninterrupted recording rather than stitched
segments.
object
required
Video recording requirements.
Properties
Properties
integer
required
Maximum acceptable average bitrate, in megabits per second.
integer
required
Minimum acceptable average bitrate, in megabits per second.
integer
required
Recommended average bitrate to encode at, in megabits per second.
string
required
Which physical lens to record with.
string[]
required
Accepted video codecs, in preference order.
boolean
required
Whether the client must also write the camera make and model into the video
container’s metadata. When
false, the capture manifest and export CSV are
the metadata carrier.integer
required
Target capture frame rate.
integer
required
Required frame height in pixels — recorded footage must match exactly.
integer
required
Minimum acceptable horizontal field of view, in degrees.
string
required
Device orientation to record in.
integer
required
Preferred horizontal field of view, in degrees.
string
required
How the client must configure video stabilization:
off disables EIS so raw motion is preserved for pose extraction, on requires it, any leaves the device default.Available options: off, on, anyboolean
required
Whether hardware/software stabilization must be enabled. True exactly when
stabilization_mode is
on.integer
required
Required frame width in pixels — recorded footage must match exactly.
string
required
When the bounty was created, as an ISO 8601 timestamp.
string
required
Currency for all amounts on the bounty, as a lowercase ISO 4217 code.Available options:
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, cny, kzt, awgstring
required
Full task instructions shown to workers.
string | null
required
Experience the bounty is hosted in, prefixed
exp_. null for platform-wide
bounties; may belong to a different account than the funder.object | null
required
number
required
Gross amount paid out from the bounty pool across accepted submissions —
worker payouts, platform fees, and affiliate shares together. Tips and
reviewer rewards are excluded.
number
required
Gross bounty-pool amount allocated per accepted submission, in whole currency
units.
number
required
What a worker is quoted per accepted submission after the platform fee, in
whole currency units. The exact post-fee figure, at the standard platform fee
rate — a worker who locked a different rate, or who arrived through an
affiliate link, is paid a different amount.
object
required
User who posted the bounty — the account owner when created with an account API key.
Properties
Properties
string
required
User ID, prefixed
user_.string | null
required
Display name.
object
required
Avatar wrapper; its
url is always present, using a generated placeholder when the user set no picture.Properties
Properties
string
required
Avatar image URL. Always present — a generated placeholder when the user set no picture.
string
required
Public username.
string | null
required
How often the schedule creates a new bounty. Each occurrence is a separate bounty; the original is not republished.Available options:
once, hourly, daily, weekly, monthlystring | null
required
When a scheduled bounty will publish, as an ISO 8601 timestamp.
null once
published, for bounties that were never scheduled, and for terminally failed
drafts parked for manual rescheduling.integer
required
Unfilled winner capacity:
accepted_submissions_limit minus
accepted_submissions_count, clamped to zero. Not a signal that the bounty
currently accepts new claims.string
required
Lifecycle state.
scheduled bounties are unpublished drafts, visible to their poster and the account’s authorized managers; open bounties accept new submissions; closed bounties are live but no longer accept new submissions; completed bounties paid out every winner slot; canceled bounties ended before filling their slots.Available options: scheduled, open, closed, completed, canceledstring | null
required
When new submissions stopped being accepted, as an ISO 8601 timestamp. Set
when a cancellation is requested on a bounty with work in flight, so in-flight
submissions can resolve before the bounty cancels.
null when submissions
were never stopped — including completed bounties that simply filled every
winner slot.string
required
Short name of the task shown to workers.
integer
required
Submissions still awaiting an outcome: in progress or pending review.
string
required
When the bounty was last updated, as an ISO 8601 timestamp.
Bounty