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

# API Bounties

> Une Bounty est une tâche rémunérée publiée par un compte ou un utilisateur.

La récompense est placée sous séquestre lors de la publication de la bounty, les travailleurs soumettent une preuve du travail effectué, et chaque soumission acceptée est payée jusqu'à ce que toutes les places de gagnants soient pourvues.

Utilisez l'API Bounties pour créer et publier une bounty, lister les bounties d'un compte pour le reporting ou les tableaux de bord, lister les bounties sur lesquelles un utilisateur peut travailler ou auxquelles il a participé, et récupérer une bounty par son ID.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les bounties](https://docs.whop.com/fr/api-reference/bounties/list-bounties.md) | GET `/bounties` |
| [Récupérer une bounty](https://docs.whop.com/fr/api-reference/bounties/retrieve-bounty.md) | GET `/bounties/{id}` |
| [Lister les soumissions publiques](https://docs.whop.com/fr/api-reference/bounties/list-public-submissions.md) | GET `/bounties/{bounty_id}/submissions` |
| [Récupérer une soumission publique](https://docs.whop.com/fr/api-reference/bounties/retrieve-public-submission.md) | GET `/bounties/{bounty_id}/submissions/{id}` |
| [Créer une bounty](https://docs.whop.com/fr/api-reference/bounties/create-bounty.md) | POST `/bounties` |
| [Annuler](https://docs.whop.com/fr/api-reference/bounties/cancel.md) | POST `/bounties/{id}/cancel` |
| [Mettre à jour une bounty](https://docs.whop.com/fr/api-reference/bounties/update-bounty.md) | PATCH `/bounties/{id}` |

## Attributs

**id** `string` *required*

ID de la bounty, préfixé par `bnty_`.

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

Les formes de livrables acceptées par cette bounty. Chaque bounty accepte n'importe quelle combinaison de `content_url` (liens publiés) et `media` (fichiers importés), sauf les bounties `data_capture`, dont la preuve consiste en des clips enregistrés dans l'app Whop qui s'accumulent sur la tentative.

Options disponibles : `content_url`, `media`, `data_capture`

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

Soumissions acceptées jusqu'à présent.

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

Nombre de soumissions pouvant être acceptées (places de gagnants).

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

Nombre de places de gagnants qu'un même travailleur peut remporter. `1` par
défaut. Les victoires plus les preuves en attente d'examen ne dépassent jamais
ce nombre, et un travailleur ne mène qu'une tentative à la fois. Ne peut pas
dépasser `accepted_submissions_limit`.

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

Livestreams de preuve actuellement en direct sur cette bounty, du plus récent au plus ancien — des travailleurs qui diffusent leurs tentatives. Vide lorsque rien n'est en direct.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du flux de livestream.
>
> **host** `object | null` *required*
>
> Utilisateur qui anime le livestream de preuve — le travailleur qui diffuse sa tentative. `null` si le compte de l'hôte n'existe plus.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID de l'utilisateur, préfixé par `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nom d'affichage.
> >
> > **profile\_picture** `object` *required*
> >
> > Conteneur de l'avatar. Son `url` est toujours présente et correspond à une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
> >
> > > [accordion] Propriétés
> > >
> > > **url** `string` *required*
> > >
> > > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
> >
> > **username** `string` *required*
> >
> > Nom d'utilisateur public.
>
> **title** `string` *required*
>
> Titre d'affichage du livestream de preuve.

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

Ce que gagne un parrain par soumission acceptée lorsque le travailleur est
arrivé via son lien d'affiliation, en unités monétaires entières, au taux de
frais standard de la plateforme. Prélevé sur la récompense du travailleur
après frais plutôt qu'ajouté en plus. `0` lorsque la bounty ne verse aucune
part d'affiliation, y compris pour les bounties liées à aucun compte, qui ne
peuvent pas enregistrer de parrainage.

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

Pays dont les résidents peuvent travailler sur la bounty, sous forme de codes
ISO 3166 alpha-2. Vide signifie dans le monde entier.

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

Soumissions livrées et en attente d'examen. Un sous-ensemble de
`unresolved_submissions_count`, qui compte également les tentatives encore en
cours.

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

Budget brut total engagé pour la bounty : `gross_reward_amount` multiplié par
`accepted_submissions_limit`.

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

Ce que l'auteur de la publication souhaite que le travail accomplisse, déclaré une seule fois lors de la création. `null` pour les bounties créées avant le déploiement de cette taxonomie.

Options disponibles : `clipping`, `post_engagement`, `owned_account_growth`, `ugc_content`, `local_activation`, `data_capture`, `other`

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

Date à laquelle l'annulation a été demandée, sous forme d'horodatage ISO 8601.
Sur une bounty `closed`, cela signifie que l'annulation est en attente : les
soumissions sont arrêtées et la bounty est annulée une fois les soumissions en
cours résolues. Sur une bounty `canceled`, cela enregistre la date de la
demande d'annulation. `null` lorsqu'aucune annulation n'a jamais été demandée.

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

Le cahier des charges technique selon lequel les images doivent être enregistrées. Présent uniquement sur les bounties `data_capture` ; `null` pour tous les autres types d'objectifs.

> [accordion] Propriétés
>
> **filename\_pattern** `string` *required*
>
> La convention de nommage des fichiers importés, construite à partir des champs
> de métadonnées requis.
>
> **imu** `object` *required*
>
> Exigences d'enregistrement de la centrale inertielle (IMU).
>
> > [accordion] Propriétés
> >
> > **device\_motion\_units** `string` *required*
> >
> > Unités des canaux de mouvement de l'appareil, sous forme de chaîne compacte
> > clé=unité.
> >
> > **magnetometer\_units** `string` *required*
> >
> > Unités du canal du magnétomètre.
> >
> > **min\_rate\_hz** `number` *required*
> >
> > Fréquence d'échantillonnage IMU minimale soutenue, en hertz, pour qu'un clip
> > passe la validation.
> >
> > **target\_rate\_hz** `integer` *required*
> >
> > Fréquence d'échantillonnage IMU cible, en hertz.
> >
> > **warmup\_min\_rate\_hz** `number` *required*
> >
> > Fréquence d'échantillonnage IMU minimale tolérée, en hertz, pendant la période
> > de préchauffage.
> >
> > **warmup\_ns** `integer` *required*
> >
> > Période de démarrage, en nanosecondes, pendant laquelle la fréquence de préchauffage assouplie s'applique.
>
> **manifest\_schema\_version** `integer` *required*
>
> Version du schéma que le client doit indiquer sur le manifeste de capture
> qu'il importe.
>
> **min\_clip\_duration\_seconds** `integer` *required*
>
> Durée minimale d'un clip, en secondes.
>
> **min\_total\_verified\_duration\_seconds** `integer` *required*
>
> Total d'images vérifiées qu'une soumission doit accumuler sur l'ensemble de
> ses clips avant de pouvoir être soumise, en secondes. Toujours un nombre
> entier d'heures.
>
> **required\_metadata\_fields** `string[]` *required*
>
> Champs de métadonnées qu'une soumission doit fournir, correspondant à l'objet
> `metadata` de l'API des soumissions.
>
> **single\_continuous\_take** `boolean` *required*
>
> Indique si chaque clip doit être un enregistrement ininterrompu plutôt que des
> segments assemblés.
>
> **video** `object` *required*
>
> Exigences d'enregistrement vidéo.
>
> > [accordion] Propriétés
> >
> > **bitrate\_ceiling\_mbps** `integer` *required*
> >
> > Débit moyen maximal acceptable, en mégabits par seconde.
> >
> > **bitrate\_floor\_mbps** `integer` *required*
> >
> > Débit moyen minimal acceptable, en mégabits par seconde.
> >
> > **bitrate\_target\_mbps** `integer` *required*
> >
> > Débit moyen d'encodage recommandé, en mégabits par seconde.
> >
> > **camera\_lens** `string` *required*
> >
> > Objectif physique à utiliser pour l'enregistrement.
> >
> > **codecs** `string[]` *required*
> >
> > Codecs vidéo acceptés, par ordre de préférence.
> >
> > **embed\_camera\_metadata** `boolean` *required*
> >
> > Indique si le client doit également écrire la marque et le modèle de la caméra
> > dans les métadonnées du conteneur vidéo. Lorsque `false`, ce sont le manifeste
> > de capture et le CSV d'export qui portent les métadonnées.
> >
> > **fps** `integer` *required*
> >
> > Fréquence d'images de capture cible.
> >
> > **frame\_gap\_tolerance\_ms** `integer` *required*
> >
> > Blocage le plus long entre deux images consécutives qu'un clip peut contenir
> > avant que le client ne le rejette, en millisecondes. Chaque image est
> > horodatée dans le journal des images, de sorte qu'un blocage reste alignable
> > en aval — cette valeur limite le degré d'altération d'une capture, et non la
> > régularité de son rythme.
> >
> > **height** `integer` *required*
> >
> > Hauteur d'image requise en pixels — les images enregistrées doivent
> > correspondre exactement.
> >
> > **min\_fov\_degrees** `integer` *required*
> >
> > Champ de vision horizontal minimal acceptable, en degrés.
> >
> > **orientation** `string` *required*
> >
> > Orientation de l'appareil pour l'enregistrement.
> >
> > **preferred\_fov\_degrees** `integer` *required*
> >
> > Champ de vision horizontal préféré, en degrés.
> >
> > **stabilization\_mode** `string` *required*
> >
> > La manière dont le client doit configurer la stabilisation vidéo : `off` désactive l'EIS afin de préserver le mouvement brut pour l'extraction de pose, `on` l'exige, `any` conserve le réglage par défaut de l'appareil.
> >
> > Options disponibles : `off`, `on`, `any`
> >
> > **stabilization\_required** `boolean` *required*
> >
> > Indique si la stabilisation matérielle/logicielle doit être activée. Vrai
> > exactement lorsque stabilization\_mode vaut `on`.
> >
> > **width** `integer` *required*
> >
> > Largeur d'image requise en pixels — les images enregistrées doivent correspondre exactement.

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

Date de création de la bounty, sous forme d'horodatage ISO 8601.

**currency** `string` *required*

Devise de tous les montants de la bounty, sous forme de code ISO 4217 en minuscules.

Options disponibles : `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*

Soumissions examinées et refusées.

**description** `string` *required*

Instructions complètes de la tâche affichées aux travailleurs.

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

Expérience dans laquelle se trouve le fil de discussion de la bounty, préfixée
par `exp_`. Lisez ce champ — et non `experience_id` — pour ouvrir le fil : une
bounty à l'échelle de la plateforme n'a pas d'expérience d'hébergement propre,
mais sa discussion se trouve tout de même dans une expérience.

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

Flux de forum contenant le fil de discussion de la bounty. `null` pour une
bounty sans publication de forum.

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

Publication de forum servant d'ancre au fil de discussion de la bounty. À lire
avec `discussion_experience_id` pour adresser le fil. `null` pour une bounty
sans publication de forum.

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

Expérience dans laquelle la bounty est hébergée, préfixée par `exp_`. `null`
pour les bounties à l'échelle de la plateforme ; peut appartenir à un compte
différent de celui qui finance.

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

Compte dont le solde finance la cagnotte de la bounty, ou `null` lorsqu'un utilisateur la finance personnellement. Peut différer du compte qui héberge `experience_id`.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

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

Montant brut versé depuis la cagnotte de la bounty pour l'ensemble des
soumissions acceptées — paiements aux travailleurs, frais de plateforme et
parts d'affiliation confondus. Les pourboires et les récompenses des
examinateurs sont exclus.

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

Montant brut de la cagnotte de la bounty alloué par soumission acceptée, en
unités monétaires entières.

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

Compte qui héberge le forum de la bounty — celui dont la `route` et l'`experience_id` adressent son fil de discussion, et où se trouve son tableau de bord des soumissions. `null` pour une bounty à l'échelle de la plateforme sans hôte. Peut différer de `funding_account`.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL de l'image du logo du compte. `null` lorsque le compte n'en a pas défini.
>
> **route** `string` *required*
>
> Identifiant de route publique du compte, utilisé dans le chemin de la vitrine
> `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

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

Total d'images vérifiées qu'une soumission doit accumuler avant de pouvoir être
soumise, en secondes. Toujours un nombre entier d'heures. Présent uniquement
sur les bounties `data_capture` — c'est ce que rémunère `net_reward_amount`,
donc les affichages de taux divisent par cette valeur. `null` pour tous les
autres types d'objectifs.

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

Ce qui est annoncé à un travailleur par soumission acceptée après les frais de
plateforme, en unités monétaires entières. Le montant exact après frais, au
taux de frais standard de la plateforme — un travailleur qui a verrouillé un
taux différent, ou qui est arrivé via un lien d'affiliation, perçoit un
montant différent.

**poster** `object` *required*

Utilisateur qui a publié la bounty — le propriétaire du compte lorsqu'elle est créée avec une clé API de compte.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présente et correspond à une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

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

Fréquence à laquelle la planification crée une nouvelle bounty. Chaque occurrence est une bounty distincte ; l'originale n'est pas republiée.

Options disponibles : `once`, `hourly`, `daily`, `weekly`, `monthly`

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

Date de publication d'une bounty planifiée, sous forme d'horodatage ISO 8601.
`null` une fois publiée, pour les bounties qui n'ont jamais été planifiées, et
pour les brouillons en échec définitif mis de côté pour une replanification
manuelle.

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

Capacité de gagnants non pourvue : `accepted_submissions_limit` moins
`accepted_submissions_count`, ramenée à zéro au minimum. Ce n'est pas à lui
seul un signal indiquant que la bounty accepte de nouvelles revendications —
lisez `status` pour cela : seule une bounty `open` accepte de nouvelles
soumissions.

**status** `string` *required*

État du cycle de vie. Les bounties `scheduled` sont des brouillons non publiés, visibles par leur auteur et par les gestionnaires autorisés du compte ; les bounties `open` acceptent de nouvelles soumissions ; les bounties `closed` sont en ligne mais n'acceptent plus de nouvelles soumissions ; les bounties `completed` ont payé toutes les places de gagnants ; les bounties `canceled` se sont terminées avant que leurs places ne soient pourvues.

Options disponibles : `scheduled`, `open`, `closed`, `completed`, `canceled`

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

Date à laquelle les nouvelles soumissions ont cessé d'être acceptées, sous
forme d'horodatage ISO 8601. Défini lorsqu'une annulation est demandée sur une
bounty dont du travail est en cours, afin que les soumissions en cours
puissent être résolues avant l'annulation de la bounty. `null` lorsque les
soumissions n'ont jamais été arrêtées — y compris pour les bounties terminées
qui ont simplement pourvu toutes les places de gagnants.

**title** `string` *required*

Nom court de la tâche affiché aux travailleurs.

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

Soumissions toujours en attente d'un résultat : en cours ou en attente
d'examen.

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

Date de dernière mise à jour de la bounty, sous forme d'horodatage ISO 8601.

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

Nombre de places de gagnants que l'utilisateur authentifié a déjà remportées
sur cette bounty. À comparer avec `accepted_submissions_per_user_limit` pour
montrer à un travailleur ce qu'il lui reste. `0` lorsque la requête n'a pas
d'utilisateur authentifié.

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

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