> ## 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

> En Bounty er en betalt opgave, der er oprettet af en konto eller bruger.

Belønningen holdes i escrow, når bountyen publiceres, arbejdere indsender bevis på udført arbejde, og hver accepteret indsendelse udbetales, indtil alle vinderpladser er fyldt.

Brug Bounties API'et til at oprette og publicere en bounty, liste en kontos bounties til rapportering eller dashboards, liste de bounties, en bruger kan arbejde på eller har deltaget i, og hente en enkelt bounty efter ID.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [List bounties](https://docs.whop.com/da/api-reference/bounties/list-bounties.md) | GET `/bounties` |
| [Hent bounty](https://docs.whop.com/da/api-reference/bounties/retrieve-bounty.md) | GET `/bounties/{id}` |
| [List offentlige indsendelser](https://docs.whop.com/da/api-reference/bounties/list-public-submissions.md) | GET `/bounties/{bounty_id}/submissions` |
| [Hent offentlig indsendelse](https://docs.whop.com/da/api-reference/bounties/retrieve-public-submission.md) | GET `/bounties/{bounty_id}/submissions/{id}` |
| [Opret bounty](https://docs.whop.com/da/api-reference/bounties/create-bounty.md) | POST `/bounties` |
| [Annuller](https://docs.whop.com/da/api-reference/bounties/cancel.md) | POST `/bounties/{id}/cancel` |
| [Opdater bounty](https://docs.whop.com/da/api-reference/bounties/update-bounty.md) | PATCH `/bounties/{id}` |

## Attributter

**id** `string` *required*

Bounty-ID med præfikset `bnty_`.

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

De leveranceformer, denne bounty accepterer. Alle bounties accepterer enhver kombination af `content_url` (postede links) og `media` (uploadede filer), undtagen `data_capture`-bounties, hvis bevis er klip optaget i Whop-appen, som akkumuleres på forsøget.

Tilgængelige muligheder: `content_url`, `media`, `data_capture`

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

Indsendelser accepteret indtil videre.

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

Antal indsendelser, der kan accepteres (vinderpladser).

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

Hvor mange vinderpladser én arbejder kan vinde. Standard er `1`. Gevinster plus beviser, der afventer gennemgang, overstiger aldrig dette tal, og en arbejder kører ét forsøg ad gangen. Kan ikke overstige `accepted_submissions_limit`.

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

Bevis-livestreams, der er live på denne bounty lige nu, nyeste først — arbejdere, der streamer deres forsøg. Tom, når intet er live.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Livestream-feed-ID.
>
> **host** `object | null` *required*
>
> Bruger, der er vært for bevis-livestreamen — arbejderen, der streamer sit forsøg. `null`, hvis værtskontoen ikke længere findes.
>
> > [accordion] Egenskaber
> >
> > **id** `string` *required*
> >
> > Bruger-ID med præfikset `user_`.
> >
> > **name** `string | null` *required*
> >
> > Visningsnavn.
> >
> > **profile\_picture** `object` *required*
> >
> > Avatar-wrapper. Dens `url` er altid til stede og er en genereret pladsholder, når brugeren ikke har angivet et billede.
> >
> > > [accordion] Egenskaber
> > >
> > > **url** `string` *required*
> > >
> > > Avatarbillede-URL. Altid til stede. Det er en genereret pladsholder, når brugeren ikke har angivet et billede.
> >
> > **username** `string` *required*
> >
> > Offentligt brugernavn.
>
> **title** `string` *required*
>
> Visningstitel for bevis-livestreamen.

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

Hvad en henviser tjener pr. accepteret indsendelse, når arbejderen kom via deres affiliate-link, i hele valutaenheder, ved standardplatformsgebyrsatsen. Trækkes fra arbejderens belønning efter gebyr i stedet for at blive lagt oveni. `0`, når bountyen ikke betaler nogen affiliate-andel, herunder bounties uden tilknyttet konto, som ikke kan registrere en henvisning.

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

Lande, hvis indbyggere kan arbejde på bountyen, som ISO 3166 alpha-2-koder. Tom betyder hele verden.

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

Indsendelser leveret og afventende gennemgang. En delmængde af `unresolved_submissions_count`, som også tæller forsøg, der stadig er i gang.

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

Samlet bruttobudget forpligtet til bountyen: `gross_reward_amount` gange `accepted_submissions_limit`.

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

Hvad opretteren ønsker, at arbejdet skal opnå, angivet én gang ved oprettelse. `null` for bounties oprettet før taksonomien blev udrullet.

Tilgængelige muligheder: `clipping`, `post_engagement`, `owned_account_growth`, `ugc_content`, `local_activation`, `data_capture`, `other`

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

Hvornår annullering blev anmodet, som et ISO 8601-tidsstempel. På en `closed` bounty betyder det, at annulleringen afventer: indsendelser er stoppet, og bountyen annulleres, når igangværende indsendelser er afgjort. På en `canceled` bounty registrerer det, hvornår annulleringen blev anmodet. `null`, når der aldrig er anmodet om annullering.

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

Den tekniske kontrakt, som optagelser skal optages efter. Kun til stede på `data_capture`-bounties; `null` for alle andre måltyper.

> [accordion] Egenskaber
>
> **filename\_pattern** `string` *required*
>
> Navnekonventionen for uploadede filer, bygget ud fra de påkrævede metadatafelter.
>
> **imu** `object` *required*
>
> Krav til optagelse fra inertimåleenhed (IMU).
>
> > [accordion] Egenskaber
> >
> > **device\_motion\_units** `string` *required*
> >
> > Enheder for enhedsbevægelseskanalerne som en kompakt nøgle=enhed-streng.
> >
> > **magnetometer\_units** `string` *required*
> >
> > Enheder for magnetometerkanalen.
> >
> > **min\_rate\_hz** `number` *required*
> >
> > Minimal vedvarende IMU-samplingsrate i hertz, for at et klip kan bestå validering.
> >
> > **target\_rate\_hz** `integer` *required*
> >
> > Mål-IMU-samplingsrate i hertz.
> >
> > **warmup\_min\_rate\_hz** `number` *required*
> >
> > Minimal IMU-samplingsrate i hertz, der tolereres under opvarmningsvinduet.
> >
> > **warmup\_ns** `integer` *required*
> >
> > Opstartsvindue i nanosekunder, hvor den lempede opvarmningsrate gælder.
>
> **manifest\_schema\_version** `integer` *required*
>
> Skemaversion, som klienten skal stemple på det capture-manifest, den uploader.
>
> **min\_clip\_duration\_seconds** `integer` *required*
>
> Minimal længde af et enkelt klip i sekunder.
>
> **min\_total\_verified\_duration\_seconds** `integer` *required*
>
> Samlet verificeret optagelse, en indsendelse skal akkumulere på tværs af alle sine klip, før den kan indsendes, i sekunder. Altid et helt antal timer.
>
> **required\_metadata\_fields** `string[]` *required*
>
> Metadatafelter, en indsendelse skal angive, svarende til `metadata`-objektet i submissions-API'et.
>
> **single\_continuous\_take** `boolean` *required*
>
> Om hvert klip skal være én uafbrudt optagelse frem for sammensatte segmenter.
>
> **video** `object` *required*
>
> Krav til videooptagelse.
>
> > [accordion] Egenskaber
> >
> > **bitrate\_ceiling\_mbps** `integer` *required*
> >
> > Maksimal acceptabel gennemsnitlig bitrate i megabit pr. sekund.
> >
> > **bitrate\_floor\_mbps** `integer` *required*
> >
> > Minimal acceptabel gennemsnitlig bitrate i megabit pr. sekund.
> >
> > **bitrate\_target\_mbps** `integer` *required*
> >
> > Anbefalet gennemsnitlig bitrate at kode med i megabit pr. sekund.
> >
> > **camera\_lens** `string` *required*
> >
> > Hvilken fysisk linse der skal optages med.
> >
> > **codecs** `string[]` *required*
> >
> > Accepterede videocodecs i prioriteret rækkefølge.
> >
> > **embed\_camera\_metadata** `boolean` *required*
> >
> > Om klienten også skal skrive kameraets mærke og model ind i videocontainerens metadata. Når `false`, er capture-manifestet og eksport-CSV'en bærere af metadata.
> >
> > **fps** `integer` *required*
> >
> > Mål-billedhastighed for optagelse.
> >
> > **frame\_gap\_tolerance\_ms** `integer` *required*
> >
> > Længste stop mellem på hinanden følgende billeder, et klip må indeholde, før klienten afviser det, i millisekunder. Hvert billede er tidsstemplet i billedloggen, så et stop forbliver justerbart nedstrøms — dette begrænser, hvor ødelagt en optagelse må være, ikke hvor jævnt den skal være.
> >
> > **height** `integer` *required*
> >
> > Påkrævet billedhøjde i pixels — optagelserne skal matche præcist.
> >
> > **min\_fov\_degrees** `integer` *required*
> >
> > Minimalt acceptabelt horisontalt synsfelt i grader.
> >
> > **orientation** `string` *required*
> >
> > Enhedsorientering, der skal optages i.
> >
> > **preferred\_fov\_degrees** `integer` *required*
> >
> > Foretrukket horisontalt synsfelt i grader.
> >
> > **stabilization\_mode** `string` *required*
> >
> > Hvordan klienten skal konfigurere videostabilisering: `off` deaktiverer EIS, så rå bevægelse bevares til positionsudtrækning, `on` kræver det, `any` bevarer enhedens standard.
> >
> > Tilgængelige muligheder: `off`, `on`, `any`
> >
> > **stabilization\_required** `boolean` *required*
> >
> > Om hardware-/softwarestabilisering skal være aktiveret. Sand præcis når stabilization\_mode er `on`.
> >
> > **width** `integer` *required*
> >
> > Påkrævet billedbredde i pixels — optagelserne skal matche præcist.

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

Hvornår bountyen blev oprettet, som et ISO 8601-tidsstempel.

**currency** `string` *required*

Valuta for alle beløb på bountyen som en ISO 4217-kode med små bogstaver.

Tilgængelige muligheder: `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*

Indsendelser gennemgået og afvist.

**description** `string` *required*

Fulde opgaveinstruktioner vist til arbejdere.

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

Experience, som bountyens diskussionstråd findes i, med præfikset `exp_`. Læs denne — ikke `experience_id` — for at åbne tråden: en platformsdækkende bounty har ingen egen værts-experience, men dens diskussion findes stadig i én.

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

Forum-feed, der indeholder bountyens diskussionstråd. `null` for en bounty uden forumopslag.

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

Forumopslag, der forankrer bountyens diskussionstråd. Læses sammen med `discussion_experience_id` for at adressere tråden. `null` for en bounty uden forumopslag.

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

Experience, som bountyen er hostet i, med præfikset `exp_`. `null` for platformsdækkende bounties; kan tilhøre en anden konto end finansieringskontoen.

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

Konto, hvis saldo finansierer bounty-puljen, eller `null`, når en bruger finansierer den personligt. Kan afvige fra kontoen, der hoster `experience_id`.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

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

Bruttobeløb udbetalt fra bounty-puljen på tværs af accepterede indsendelser — udbetalinger til arbejdere, platformsgebyrer og affiliate-andele tilsammen. Drikkepenge og belønninger til gennemgåere er ikke medregnet.

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

Bruttobeløb fra bounty-puljen allokeret pr. accepteret indsendelse i hele valutaenheder.

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

Konto, der hoster bountyens forum — den, hvis `route` og `experience_id` adresserer dens diskussionstråd, og hvor dens indsendelses-dashboard findes. `null` for en platformsdækkende bounty uden vært. Kan afvige fra `funding_account`.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **logo\_url** `string | null` *required*
>
> Kontoens logobillede-URL. `null`, når kontoen ikke har angivet et.
>
> **route** `string` *required*
>
> Kontoens offentlige rute-identifikator, brugt i butiksstien `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

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

Samlet verificeret optagelse, en indsendelse skal akkumulere, før den kan indsendes, i sekunder. Altid et helt antal timer. Kun til stede på `data_capture`-bounties — det er, hvad `net_reward_amount` betaler for, så satsvisninger dividerer med det. `null` for alle andre måltyper.

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

Hvad en arbejder tilbydes pr. accepteret indsendelse efter platformsgebyret i hele valutaenheder. Det præcise tal efter gebyr ved standardplatformsgebyrsatsen — en arbejder, der har låst en anden sats, eller som kom via et affiliate-link, får udbetalt et andet beløb.

**poster** `object` *required*

Bruger, der oprettede bountyen — kontoejeren, når den er oprettet med en konto-API-nøgle.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Bruger-ID med præfikset `user_`.
>
> **name** `string | null` *required*
>
> Visningsnavn.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. Dens `url` er altid til stede og er en genereret pladsholder, når brugeren ikke har angivet et billede.
>
> > [accordion] Egenskaber
> >
> > **url** `string` *required*
> >
> > Avatarbillede-URL. Altid til stede. Det er en genereret pladsholder, når brugeren ikke har angivet et billede.
>
> **username** `string` *required*
>
> Offentligt brugernavn.

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

Hvor ofte planen opretter en ny bounty. Hver forekomst er en separat bounty; den oprindelige genpubliceres ikke.

Tilgængelige muligheder: `once`, `hourly`, `daily`, `weekly`, `monthly`

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

Hvornår en planlagt bounty publiceres, som et ISO 8601-tidsstempel. `null` når den er publiceret, for bounties der aldrig blev planlagt, og for endeligt mislykkede kladder, der er parkeret til manuel omplanlægning.

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

Uudfyldt vinderkapacitet: `accepted_submissions_limit` minus `accepted_submissions_count`, begrænset til nul. Ikke i sig selv et signal om, at bountyen accepterer nye krav — læs `status` for det: kun en `open` bounty modtager nye indsendelser.

**status** `string` *required*

Livscyklustilstand. `scheduled` bounties er upublicerede kladder, synlige for deres opretter og kontoens autoriserede administratorer; `open` bounties accepterer nye indsendelser; `closed` bounties er live, men accepterer ikke længere nye indsendelser; `completed` bounties har udbetalt alle vinderpladser; `canceled` bounties sluttede, før deres pladser blev fyldt.

Tilgængelige muligheder: `scheduled`, `open`, `closed`, `completed`, `canceled`

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

Hvornår nye indsendelser holdt op med at blive accepteret, som et ISO 8601-tidsstempel. Sættes, når der anmodes om annullering af en bounty med igangværende arbejde, så igangværende indsendelser kan afgøres, før bountyen annulleres. `null`, når indsendelser aldrig blev stoppet — herunder fuldførte bounties, der blot fyldte alle vinderpladser.

**title** `string` *required*

Kort navn på opgaven vist til arbejdere.

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

Indsendelser, der stadig afventer et udfald: i gang eller afventer gennemgang.

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

Hvornår bountyen sidst blev opdateret, som et ISO 8601-tidsstempel.

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

Hvor mange vinderpladser den godkendte bruger allerede har vundet på denne bounty. Læses i forhold til `accepted_submissions_per_user_limit` for at vise en arbejder deres resterende kvote. `0`, når anmodningen ikke har nogen godkendt bruger.

```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/da/api-reference/bounty-submissions/bounty-submission.md)
- [Create bounty](https://docs.whop.com/da/api-reference/legacy/bounties/create-bounty.md)
- [List bounties](https://docs.whop.com/da/api-reference/legacy/bounties/list-bounties.md)
