> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Bounties API

> Een Bounty is een betaalde taak die is geplaatst door een account of gebruiker.

De beloning wordt in escrow gehouden wanneer de bounty wordt gepubliceerd, uitvoerders dienen bewijs van voltooid werk in, en elke geaccepteerde inzending wordt uitbetaald totdat alle winnaarsplekken gevuld zijn.

Gebruik de Bounties API om een bounty aan te maken en te publiceren, de bounties van een account weer te geven voor rapportages of dashboards, de bounties weer te geven waaraan een gebruiker kan werken of heeft deelgenomen, en één bounty op te halen via ID.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Bounties weergeven](https://docs.whop.com/nl/api-reference/bounties/list-bounties.md) | GET `/bounties` |
| [Bounty ophalen](https://docs.whop.com/nl/api-reference/bounties/retrieve-bounty.md) | GET `/bounties/{id}` |
| [Openbare inzendingen weergeven](https://docs.whop.com/nl/api-reference/bounties/list-public-submissions.md) | GET `/bounties/{bounty_id}/submissions` |
| [Openbare inzending ophalen](https://docs.whop.com/nl/api-reference/bounties/retrieve-public-submission.md) | GET `/bounties/{bounty_id}/submissions/{id}` |
| [Bounty aanmaken](https://docs.whop.com/nl/api-reference/bounties/create-bounty.md) | POST `/bounties` |
| [Annuleren](https://docs.whop.com/nl/api-reference/bounties/cancel.md) | POST `/bounties/{id}/cancel` |
| [Bounty bijwerken](https://docs.whop.com/nl/api-reference/bounties/update-bounty.md) | PATCH `/bounties/{id}` |

## Attributen

**id** `string` *required*

Bounty-ID, met prefix `bnty_`.

**accepted\_deliverable\_types** `string[]` *required*

De soorten opleveringen die deze bounty accepteert. Elke bounty accepteert elke combinatie van `content_url` (geplaatste links) en `media` (geüploade bestanden), behalve `data_capture`-bounties, waarvan het bewijs bestaat uit clips die in de Whop-app zijn opgenomen en zich op de poging verzamelen.

Beschikbare opties: `content_url`, `media`, `data_capture`

**accepted\_submissions\_count** `integer` *required*

Tot nu toe geaccepteerde inzendingen.

**accepted\_submissions\_limit** `integer` *required*

Aantal inzendingen dat kan worden geaccepteerd (winnaarsplekken).

**accepted\_submissions\_per\_user\_limit** `integer` *required*

Hoeveel winnaarsplekken één uitvoerder kan winnen. Standaard `1`. Winsten plus
bewijzen die op beoordeling wachten overschrijden dit aantal nooit, en een
uitvoerder doet één poging tegelijk. Kan `accepted_submissions_limit` niet
overschrijden.

**active\_proof\_livestream\_feeds** `object[]` *required*

Bewijs-livestreams die nu live zijn op deze bounty, nieuwste eerst — uitvoerders die hun poging streamen. Leeg wanneer er niets live is.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Livestream-feed-ID.
>
> **host** `object | null` *required*
>
> Gebruiker die de bewijs-livestream host — de uitvoerder die zijn poging streamt. `null` als het host-account niet meer bestaat.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Gebruikers-ID, met prefix `user_`.
> >
> > **name** `string | null` *required*
> >
> > Weergavenaam.
> >
> > **profile\_picture** `object` *required*
> >
> > Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
> >
> > > [accordion] Eigenschappen
> > >
> > > **url** `string` *required*
> > >
> > > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
> >
> > **username** `string` *required*
> >
> > Openbare gebruikersnaam.
>
> **title** `string` *required*
>
> Weergavetitel van de bewijs-livestream.

**affiliate\_share\_amount** `number` *required*

Wat een doorverwijzer verdient per geaccepteerde inzending wanneer de
uitvoerder via zijn affiliatelink binnenkwam, in hele valuta-eenheden, tegen
het standaard platformkostentarief. Wordt afgetrokken van de beloning van de
uitvoerder na kosten in plaats van erbovenop te komen. `0` wanneer de bounty
geen affiliate-aandeel uitbetaalt, inclusief bounties die aan geen account zijn
gekoppeld en dus geen doorverwijzing kunnen registreren.

**allowed\_country\_codes** `string[]` *required*

Landen waarvan de inwoners aan de bounty kunnen werken, als ISO 3166
alpha-2-codes. Leeg betekent wereldwijd.

**awaiting\_review\_submissions\_count** `integer` *required*

Inzendingen die zijn opgeleverd en op beoordeling wachten. Een deelverzameling
van `unresolved_submissions_count`, dat ook pogingen telt die nog bezig zijn.

**budget\_amount** `number` *required*

Totaal bruto budget dat aan de bounty is toegewezen: `gross_reward_amount` maal
`accepted_submissions_limit`.

**business\_goal\_type** `string | null` *required*

Wat de plaatser met het werk wil bereiken, eenmalig opgegeven bij het aanmaken. `null` voor bounties die zijn aangemaakt voordat de taxonomie werd ingevoerd.

Beschikbare opties: `clipping`, `post_engagement`, `owned_account_growth`, `ugc_content`, `local_activation`, `data_capture`, `other`

**cancel\_requested\_at** `string | null` *required*

Wanneer annulering werd aangevraagd, als ISO 8601-tijdstempel. Bij een
`closed`-bounty betekent dit dat de annulering in behandeling is: inzendingen
zijn gestopt en de bounty wordt geannuleerd zodra lopende inzendingen zijn
afgehandeld. Bij een `canceled`-bounty registreert het wanneer de annulering
werd aangevraagd. `null` wanneer er nooit annulering is aangevraagd.

**capture\_spec** `object | null` *required*

Het technische contract waaraan opgenomen beelden moeten voldoen. Alleen aanwezig bij `data_capture`-bounties; `null` voor elk ander doeltype.

> [accordion] Eigenschappen
>
> **filename\_pattern** `string` *required*
>
> De naamgevingsconventie voor geüploade bestanden, opgebouwd uit de vereiste
> metadatavelden.
>
> **imu** `object` *required*
>
> Opnamevereisten voor de inertiële meeteenheid (IMU).
>
> > [accordion] Eigenschappen
> >
> > **device\_motion\_units** `string` *required*
> >
> > Eenheden voor de device-motion-kanalen, als compacte key=unit-string.
> >
> > **magnetometer\_units** `string` *required*
> >
> > Eenheden voor het magnetometerkanaal.
> >
> > **min\_rate\_hz** `number` *required*
> >
> > Minimale aanhoudende IMU-samplefrequentie in hertz waarmee een clip de
> > validatie doorstaat.
> >
> > **target\_rate\_hz** `integer` *required*
> >
> > Beoogde IMU-samplefrequentie in hertz.
> >
> > **warmup\_min\_rate\_hz** `number` *required*
> >
> > Minimale IMU-samplefrequentie in hertz die tijdens het opwarmvenster wordt
> > getolereerd.
> >
> > **warmup\_ns** `integer` *required*
> >
> > Opstartvenster, in nanoseconden, waarin de versoepelde opwarmfrequentie geldt.
>
> **manifest\_schema\_version** `integer` *required*
>
> Schemaversie die de client moet vermelden in het capture-manifest dat hij
> uploadt.
>
> **min\_clip\_duration\_seconds** `integer` *required*
>
> Minimale lengte van één clip, in seconden.
>
> **min\_total\_verified\_duration\_seconds** `integer` *required*
>
> Totale geverifieerde beelden die een inzending over al haar clips moet
> verzamelen voordat ze kan worden ingediend, in seconden. Altijd een geheel
> aantal uren.
>
> **required\_metadata\_fields** `string[]` *required*
>
> Metadatavelden die een inzending moet aanleveren, overeenkomend met het
> `metadata`-object in de submissions API.
>
> **single\_continuous\_take** `boolean` *required*
>
> Of elke clip één ononderbroken opname moet zijn in plaats van aan elkaar
> geplakte segmenten.
>
> **video** `object` *required*
>
> Vereisten voor video-opname.
>
> > [accordion] Eigenschappen
> >
> > **bitrate\_ceiling\_mbps** `integer` *required*
> >
> > Maximaal toegestane gemiddelde bitrate, in megabit per seconde.
> >
> > **bitrate\_floor\_mbps** `integer` *required*
> >
> > Minimaal toegestane gemiddelde bitrate, in megabit per seconde.
> >
> > **bitrate\_target\_mbps** `integer` *required*
> >
> > Aanbevolen gemiddelde bitrate om mee te coderen, in megabit per seconde.
> >
> > **camera\_lens** `string` *required*
> >
> > Met welke fysieke lens moet worden opgenomen.
> >
> > **codecs** `string[]` *required*
> >
> > Geaccepteerde videocodecs, in volgorde van voorkeur.
> >
> > **embed\_camera\_metadata** `boolean` *required*
> >
> > Of de client ook het merk en model van de camera in de metadata van de
> > videocontainer moet schrijven. Bij `false` zijn het capture-manifest en de
> > export-CSV de dragers van de metadata.
> >
> > **fps** `integer` *required*
> >
> > Beoogde opnameframerate.
> >
> > **frame\_gap\_tolerance\_ms** `integer` *required*
> >
> > Langste haperingen tussen opeenvolgende frames die een clip mag bevatten
> > voordat de client hem afwijst, in milliseconden. Elk frame krijgt een
> > tijdstempel in de framelog, zodat een hapering later nog uitgelijnd kan
> > worden — dit begrenst hoe defect een opname mag zijn, niet hoe gelijkmatig
> > het tempo moet zijn.
> >
> > **height** `integer` *required*
> >
> > Vereiste framehoogte in pixels — opgenomen beelden moeten exact overeenkomen.
> >
> > **min\_fov\_degrees** `integer` *required*
> >
> > Minimaal toegestaan horizontaal gezichtsveld, in graden.
> >
> > **orientation** `string` *required*
> >
> > Apparaatoriëntatie waarin moet worden opgenomen.
> >
> > **preferred\_fov\_degrees** `integer` *required*
> >
> > Voorkeur voor het horizontale gezichtsveld, in graden.
> >
> > **stabilization\_mode** `string` *required*
> >
> > Hoe de client videostabilisatie moet configureren: `off` schakelt EIS uit zodat ruwe beweging behouden blijft voor pose-extractie, `on` vereist het, `any` laat de standaardinstelling van het apparaat staan.
> >
> > Beschikbare opties: `off`, `on`, `any`
> >
> > **stabilization\_required** `boolean` *required*
> >
> > Of hardware-/softwarestabilisatie ingeschakeld moet zijn. Precies true wanneer
> > stabilization\_mode `on` is.
> >
> > **width** `integer` *required*
> >
> > Vereiste framebreedte in pixels — opgenomen beelden moeten exact overeenkomen.

**created\_at** `string` *required*

Wanneer de bounty is aangemaakt, als ISO 8601-tijdstempel.

**currency** `string` *required*

Valuta voor alle bedragen op de bounty, als ISO 4217-code in kleine letters.

Beschikbare opties: `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`, `awg`, `hnl`

**denied\_submissions\_count** `integer` *required*

Inzendingen die zijn beoordeeld en afgewezen.

**description** `string` *required*

Volledige taakinstructies die aan uitvoerders worden getoond.

**discussion\_experience\_id** `string | null` *required*

Experience waarin de discussiethread van de bounty staat, met prefix `exp_`.
Lees dit — niet `experience_id` — om de thread te openen: een platformbrede
bounty heeft geen eigen hostende experience, maar de discussie staat toch in
een experience.

**discussion\_feed\_id** `string | null` *required*

Forumfeed met de discussiethread van de bounty. `null` voor een bounty zonder
forumbericht.

**discussion\_post\_id** `string | null` *required*

Forumbericht dat de discussiethread van de bounty verankert. Lees samen met
`discussion_experience_id` om de thread te adresseren. `null` voor een bounty
zonder forumbericht.

**experience\_id** `string | null` *required*

Experience waarin de bounty wordt gehost, met prefix `exp_`. `null` voor
platformbrede bounties; kan bij een ander account horen dan de financier.

**funding\_account** `object | null` *required*

Account waarvan het saldo de bountypot financiert, of `null` wanneer een gebruiker deze persoonlijk financiert. Kan verschillen van het account dat `experience_id` host.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**gross\_paid\_out\_amount** `number` *required*

Bruto bedrag dat uit de bountypot is uitbetaald over geaccepteerde inzendingen
— uitbetalingen aan uitvoerders, platformkosten en affiliate-aandelen samen.
Fooien en beloningen voor beoordelaars zijn uitgesloten.

**gross\_reward\_amount** `number` *required*

Bruto bedrag uit de bountypot dat per geaccepteerde inzending wordt
toegewezen, in hele valuta-eenheden.

**hosting\_account** `object | null` *required*

Account dat het forum van de bounty host — het account waarvan `route` en `experience_id` de discussiethread adresseren, en waar het inzendingendashboard staat. `null` voor een platformbrede bounty zonder host. Kan verschillen van `funding_account`.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL van de logoafbeelding van het account. `null` wanneer het account er geen
> heeft ingesteld.
>
> **route** `string` *required*
>
> Openbare route-identifier van het account, gebruikt in het storefront-pad
> `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**min\_total\_verified\_duration\_seconds** `integer | null` *required*

Totale geverifieerde beelden die een inzending moet verzamelen voordat ze kan
worden ingediend, in seconden. Altijd een geheel aantal uren. Alleen aanwezig
bij `data_capture`-bounties — dit is waarvoor `net_reward_amount` betaalt,
dus tariefweergaven delen erdoor. `null` voor elk ander doeltype.

**net\_reward\_amount** `number` *required*

Wat een uitvoerder per geaccepteerde inzending wordt voorgespiegeld na de
platformkosten, in hele valuta-eenheden. Het exacte bedrag na kosten, tegen
het standaard platformkostentarief — een uitvoerder die een ander tarief heeft
vastgelegd, of die via een affiliatelink binnenkwam, krijgt een ander bedrag
uitbetaald.

**poster** `object` *required*

Gebruiker die de bounty heeft geplaatst — de accounteigenaar wanneer aangemaakt met een account-API-sleutel.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

**scheduled\_frequency** `string | null` *required*

Hoe vaak het schema een nieuwe bounty aanmaakt. Elke herhaling is een aparte bounty; het origineel wordt niet opnieuw gepubliceerd.

Beschikbare opties: `once`, `hourly`, `daily`, `weekly`, `monthly`

**scheduled\_publish\_at** `string | null` *required*

Wanneer een ingeplande bounty wordt gepubliceerd, als ISO 8601-tijdstempel.
`null` na publicatie, voor bounties die nooit zijn ingepland, en voor
definitief mislukte concepten die zijn geparkeerd voor handmatig herplannen.

**spots\_remaining** `integer` *required*

Niet-gevulde winnaarscapaciteit: `accepted_submissions_limit` min
`accepted_submissions_count`, met nul als ondergrens. Op zichzelf geen signaal
dat de bounty nieuwe claims accepteert — lees daarvoor `status`: alleen een
`open`-bounty neemt nieuwe inzendingen aan.

**status** `string` *required*

Levenscyclusstatus. `scheduled`-bounties zijn ongepubliceerde concepten, zichtbaar voor de plaatser en de geautoriseerde beheerders van het account; `open`-bounties accepteren nieuwe inzendingen; `closed`-bounties zijn live maar accepteren geen nieuwe inzendingen meer; `completed`-bounties hebben elke winnaarsplek uitbetaald; `canceled`-bounties zijn beëindigd voordat hun plekken gevuld waren.

Beschikbare opties: `scheduled`, `open`, `closed`, `completed`, `canceled`

**submissions\_closed\_at** `string | null` *required*

Wanneer er geen nieuwe inzendingen meer werden geaccepteerd, als ISO
8601-tijdstempel. Wordt ingesteld wanneer annulering wordt aangevraagd voor
een bounty met lopend werk, zodat lopende inzendingen kunnen worden
afgehandeld voordat de bounty wordt geannuleerd. `null` wanneer inzendingen
nooit zijn gestopt — inclusief voltooide bounties die simpelweg elke
winnaarsplek hebben gevuld.

**title** `string` *required*

Korte naam van de taak die aan uitvoerders wordt getoond.

**unresolved\_submissions\_count** `integer` *required*

Inzendingen die nog op een uitkomst wachten: bezig of in afwachting van
beoordeling.

**updated\_at** `string` *required*

Wanneer de bounty voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.

**viewer\_accepted\_submissions\_count** `integer` *required*

Hoeveel winnaarsplekken de geauthenticeerde gebruiker al op deze bounty heeft
gewonnen. Vergelijk met `accepted_submissions_per_user_limit` om een
uitvoerder zijn resterende ruimte te tonen. `0` wanneer het verzoek geen
geauthenticeerde gebruiker heeft.

```json Bounty theme={null}
{
	"id": "bnty_xxxxxxxxxxxxx",
	"title": "Clip our Tuesday livestream",
	"description": "Record a 30-60 second clip of the stream's best moment and post it with the campaign hashtag.",
	"status": "open",
	"currency": "usd",
	"gross_reward_amount": 25,
	"net_reward_amount": 17.5,
	"affiliate_share_amount": 3.5,
	"budget_amount": 125,
	"gross_paid_out_amount": 50,
	"accepted_submissions_limit": 5,
	"accepted_submissions_per_user_limit": 2,
	"accepted_submissions_count": 2,
	"viewer_accepted_submissions_count": 1,
	"unresolved_submissions_count": 1,
	"awaiting_review_submissions_count": 1,
	"denied_submissions_count": 1,
	"spots_remaining": 3,
	"business_goal_type": "clipping",
	"accepted_deliverable_types": ["content_url", "media"],
	"capture_spec": null,
	"min_total_verified_duration_seconds": null,
	"allowed_country_codes": ["US", "MX"],
	"submissions_closed_at": null,
	"cancel_requested_at": null,
	"scheduled_publish_at": null,
	"scheduled_frequency": null,
	"experience_id": "exp_xxxxxxxxxxxxx",
	"discussion_post_id": "post_xxxxxxxxxxxxx",
	"discussion_feed_id": "feed_xxxxxxxxxxxxx",
	"discussion_experience_id": "exp_xxxxxxxxxxxxx",
	"active_proof_livestream_feeds": [
		{
			"id": "lfeed_xxxxxxxxxxxxx",
			"title": "Clipping the Tuesday stream live",
			"host": {
				"id": "user_xxxxxxxxxxxx",
				"username": "clip_worker",
				"name": "Worker Name",
				"profile_picture": {
					"url": "https://img.whop.com/worker.png"
				}
			}
		}
	],
	"hosting_account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://img.whop.com/acme-studio-logo.png"
	},
	"poster": {
		"id": "user_xxxxxxxxxxxx",
		"username": "acme_studio",
		"name": "Creator Name",
		"profile_picture": {
			"url": "https://img.whop.com/creator.png"
		}
	},
	"funding_account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio"
	},
	"created_at": "2026-07-01T00:00:00.000Z",
	"updated_at": "2026-07-08T00:00:00.000Z"
}
```


## Related topics

- [Bounty Submissions API](https://docs.whop.com/nl/api-reference/bounty-submissions/bounty-submission.md)
- [Create bounty](https://docs.whop.com/nl/api-reference/legacy/bounties/create-bounty.md)
- [List bounties](https://docs.whop.com/nl/api-reference/legacy/bounties/list-bounties.md)
