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

# Bounty Submissions API

> Een Bounty Submission is de poging van één uitvoerder op een bounty.

Ze begint als een lopende poging, komt in de beoordelingswachtrij wanneer bewijs wordt ingediend, en eindigt als goedgekeurd (betaald uit de in escrow gehouden pot van de bounty) of afgewezen.

Gebruik de Bounty Submissions API om bewijs van voltooid werk in te dienen bij een bounty, de inzendingen weer te geven die je zelf hebt gemaakt, en de inzendingen op je bounties te beoordelen — over alle bounties heen of beperkt tot één.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Bounty-inzendingen weergeven](https://docs.whop.com/nl/api-reference/bounty-submissions/list-bounty-submissions.md) | GET `/bounty_submissions` |
| [Bounty-inzending ophalen](https://docs.whop.com/nl/api-reference/bounty-submissions/retrieve-bounty-submission.md) | GET `/bounty_submissions/{id}` |
| [Bounty-inzending aanmaken](https://docs.whop.com/nl/api-reference/bounty-submissions/create-bounty-submission.md) | POST `/bounty_submissions` |
| [Bounty-inzending indienen](https://docs.whop.com/nl/api-reference/bounty-submissions/submit-bounty-submission.md) | POST `/bounty_submissions/{id}/submit` |
| [Bounty-inzending annuleren](https://docs.whop.com/nl/api-reference/bounty-submissions/cancel-bounty-submission.md) | DELETE `/bounty_submissions/{id}` |

## Attributen

**id** `string` *required*

Inzendings-ID, met prefix `btys_`.

**bounty\_id** `string` *required*

De bounty waarbij het werk is ingediend, met prefix `bnty_`.

**capture\_clips** `object[] | null` *required*

De capture-clips van de inzending in opnamevolgorde, elk met een eigen beoordelings-`status` en tijdelijke ondertekende artefact-URL's. De volledige oplevering wanneer `deliverable_type` `data_capture` is, alleen gevuld bij het ophalen van één inzending; `null` in lijstresponses (gebruik `captured_clip_count` en `captured_duration_seconds` voor de samenvatting) en voor andere opleveringstypen. Een poging die nog bezig is, toont elke clip die ze heeft opgenomen, inclusief mislukte; na indiening worden alleen clips getoond die de validatie hebben doorstaan, omdat alleen die als bewijs gelden.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Capture-clip-ID, met prefix `bclip_`.
>
> **bounty\_submission\_id** `string` *required*
>
> De bounty-inzending (poging) waartoe deze clip behoort, met prefix `btys_`.
>
> **created\_at** `string` *required*
>
> Wanneer de clip is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `integer | null` *required*
>
> Door de server gevalideerde clipduur in hele seconden. `null` totdat de
> validatie is voltooid.
>
> **failure\_code** `string | null` *required*
>
> Stabiele validatiefoutcode. `null` tenzij `status` `failed` is.
>
> **failure\_message** `string | null` *required*
>
> Leesbare reden voor de validatiefout. `null` tenzij `status` `failed` is.
>
> **frames\_url** `string | null` *required*
>
> Tijdelijke ondertekende URL voor de log met tijdstempels van videoframes.
> Alleen geretourneerd bij het ophalen van één clip voor een geautoriseerde
> kijker; `null` in lijstresponses of totdat het artefact is toegevoegd.
>
> **imu\_url** `string | null` *required*
>
> Tijdelijke ondertekende URL voor de IMU-log (accelerometer + gyroscoop).
> Alleen geretourneerd bij het ophalen van één clip voor een geautoriseerde
> kijker; `null` in lijstresponses of totdat het artefact is toegevoegd.
>
> **manifest\_url** `string | null` *required*
>
> Tijdelijke ondertekende URL voor het capture-manifest. Alleen geretourneerd bij
> het ophalen van één clip voor een geautoriseerde kijker; `null` in
> lijstresponses of totdat het artefact is toegevoegd.
>
> **ready\_at** `string | null` *required*
>
> Wanneer de validatie aan serverzijde succesvol is voltooid, als ISO
> 8601-tijdstempel. Tot dan `null`.
>
> **sequence** `integer` *required*
>
> De stabiele volgorde van de clip binnen de poging, beginnend bij 1.
>
> **status** `string` *required*
>
> Opname- en validatiestatus. `recording` is nog aan het opnemen; `verifying` ondergaat validatie aan serverzijde; `ready` heeft de validatie doorstaan en telt mee voor de uitbetalingsdrempel voor geverifieerde duur; `failed` is niet gevalideerd.
>
> Beschikbare opties: `recording`, `verifying`, `ready`, `failed`
>
> **updated\_at** `string` *required*
>
> Wanneer de clip voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.
>
> **video\_url** `string | null` *required*
>
> Tijdelijke ondertekende URL voor de gesynchroniseerde MP4-video. Alleen geretourneerd bij het ophalen van één clip voor een geautoriseerde kijker; `null` in lijstresponses of totdat het artefact is toegevoegd.

**capture\_filename** `string | null` *required*

De stam van de leveranciersbestandsnaam `Country_City_Site_Station_Operator`,
afgeleid uit de capture-metadata. `null` totdat elk onderdeel aanwezig is.

**captured\_clip\_count** `integer` *required*

Aantal geverifieerde capture-clips dat tot nu toe voor deze inzending is
geaccepteerd. `0` voor inzendingen waarvan de oplevering geen clips verzamelt.

**captured\_duration\_seconds** `integer` *required*

Totale geverifieerde duur van geaccepteerde capture-clips, in hele seconden.
`0` voor inzendingen waarvan de oplevering geen clips verzamelt.

**city** `string | null` *required*

Capture-metadata: stad waarin de beelden zijn opgenomen. `null` tenzij
capture-metadata is opgegeven.

**claimed\_at** `string | null` *required*

Wanneer de uitvoerder de inzending heeft geclaimd, als ISO 8601-tijdstempel.

**content** `string | null` *required*

Geschreven bewijs dat de uitvoerder bij het werk heeft ingediend.

**country** `string | null` *required*

Capture-metadata: land waarin de beelden zijn opgenomen. `null` tenzij
capture-metadata is opgegeven.

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

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

**deliverable\_type** `string | null` *required*

Hoe het werk binnenkwam wanneer het in één keer via de API werd aangeleverd, alleen ter informatie — lees het werk rechtstreeks uit `deliverable_urls`, `files` en `capture_clips`. `null` voor inzendingen waarvan het bewijs een livestreamopname is, inclusief inzendingen die bij het indienen links of bestanden hebben toegevoegd.

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

**deliverable\_urls** `string[] | null` *required*

Links die als werk zijn ingediend, gevolgd door tijdelijke download-URL's voor
de geüploade bestanden. `null` wanneer de inzending geen van beide bevat.

**denial\_reason** `string | null` *required*

Waarom de inzending is afgewezen, wanneer er een presenteerbare reden is.
Altijd `null` tenzij `status` `denied` is.

**device** `string | null` *required*

Capture-metadata: apparaat waarop de beelden zijn opgenomen. `null` tenzij
capture-metadata is opgegeven.

**files** `object[]` *required*

Bestanden die als onderdeel van het werk zijn geüpload, in uploadvolgorde. Leeg wanneer de inzending er geen heeft.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Bestands-ID, met prefix `file_`.
>
> **attachment\_type** `string | null` *required*
>
> Globale soort bestand.
>
> Beschikbare opties: `image`, `video`, `audio`, `other`
>
> **content\_type** `string | null` *required*
>
> MIME-type van het bestand.
>
> **filename** `string | null` *required*
>
> Naam waarmee het bestand is geüpload.
>
> **url** `string | null` *required*
>
> Tijdelijke download-URL voor het bestand.

**fov** `integer | null` *required*

Capture-metadata: horizontaal gezichtsveld in graden. `null` wanneer niet
gerapporteerd.

**latest\_proof\_livestream\_feed** `object | null` *required*

Meest recente openbare bewijs-livestream die aan de inzending is gekoppeld.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Livestream-feed-ID.
>
> **ended\_at** `string | null` *required*
>
> Wanneer de bewijs-livestream is geëindigd, als ISO 8601-tijdstempel. `null`
> zolang deze nog live is — een feed met een `started_at` en zonder `ended_at`
> streamt op dit moment.
>
> **recording\_status** `string | null` *required*
>
> Levenscyclusstatus van de opname.
>
> Beschikbare opties: `recording`, `processing`, `completed`, `failed`
>
> **recording\_url** `string | null` *required*
>
> Afspeel-URL voor een voltooide bewijsopname, indien beschikbaar.
>
> **started\_at** `string | null` *required*
>
> Wanneer de bewijs-livestream live ging, als ISO 8601-tijdstempel. `null`
> voordat deze begint.
>
> **thumbnail\_url** `string | null` *required*
>
> Huidige URL van de bewijsthumbnail, indien beschikbaar.
>
> **title** `string` *required*
>
> Weergavetitel van de bewijs-livestream.

**operator** `string | null` *required*

Capture-metadata: identificatie van de persoon die de beelden heeft opgenomen.
`null` tenzij capture-metadata is opgegeven.

**resolved\_at** `string | null` *required*

Wanneer de inzending is goedgekeurd of afgewezen, als ISO 8601-tijdstempel.
Tot dan `null`.

**site** `string | null` *required*

Capture-metadata: locatie of plaats waar de beelden zijn opgenomen. `null`
tenzij capture-metadata is opgegeven.

**station** `string | null` *required*

Capture-metadata: station of positie binnen de locatie. `null` tenzij
capture-metadata is opgegeven.

**status** `string | null` *required*

Levenscyclusstatus. `in_progress`-inzendingen zijn actieve pogingen die nog geen bewijs hebben ingediend; `submitted`-inzendingen wachten op beoordeling; `approved`-inzendingen zijn geaccepteerd en betaald; `denied`-inzendingen zijn afgewezen. `null` wanneer de poging zonder bewijs is geëindigd, waardoor ze uit de openbare levenscyclus valt — die pogingen ontbreken in elke openbare lijst en elk openbaar ophaalverzoek.

Beschikbare opties: `in_progress`, `submitted`, `approved`, `denied`

**submitted\_at** `string | null` *required*

Wanneer bewijs ter beoordeling is ingediend, als ISO 8601-tijdstempel. `null`
zolang de poging bezig is.

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

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

**worker** `object` *required*

Gebruiker die het werk heeft ingediend.

> [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.

```json BountySubmission theme={null}
{
	"id": "btys_xxxxxxxxxxxxxx",
	"bounty_id": "bnty_xxxxxxxxxxxxxx",
	"capture_clips": null,
	"capture_filename": null,
	"captured_clip_count": 0,
	"captured_duration_seconds": 0,
	"city": null,
	"claimed_at": "2026-09-10T09:00:00.000Z",
	"content": "Ceramic coating reveal, filmed at the Burnet Rd bay.",
	"country": null,
	"created_at": "2026-09-10T09:00:00.000Z",
	"deliverable_type": "content_url",
	"deliverable_urls": [
		"https://www.tiktok.com/@shinetime/video/7412345678901234567"
	],
	"denial_reason": null,
	"device": null,
	"files": [
		{
			"id": "file_xxxxxxxxxxxxxx",
			"attachment_type": "image",
			"content_type": "image/png",
			"filename": "ceramic-coating-reveal.png",
			"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-09-12/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
		}
	],
	"fov": null,
	"latest_proof_livestream_feed": null,
	"operator": null,
	"resolved_at": "2026-09-13T11:20:00.000Z",
	"site": null,
	"station": null,
	"status": "approved",
	"submitted_at": "2026-09-12T18:45:00.000Z",
	"updated_at": "2026-09-13T11:20:00.000Z",
	"worker": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"profile_picture": {
			"url": "https://ui-avatars.com/api/"
		},
		"username": "danawhitfield"
	}
}
```


## Related topics

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