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

> Une Bounty Submission est la tentative d'un travailleur sur une bounty.

Elle commence comme une tentative en cours, entre dans la file de vérification lorsque la preuve est soumise, et se termine approuvée (payée à partir de la cagnotte placée sous séquestre de la bounty) ou refusée.

Utilisez l'API Bounty Submissions pour soumettre une preuve de travail terminé à une bounty, lister les soumissions dont vous êtes l'auteur et examiner les soumissions reçues sur vos bounties — sur l'ensemble des bounties ou sur une seule.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les soumissions de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/list-bounty-submissions.md) | GET `/bounty_submissions` |
| [Récupérer une soumission de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/retrieve-bounty-submission.md) | GET `/bounty_submissions/{id}` |
| [Créer une soumission de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/create-bounty-submission.md) | POST `/bounty_submissions` |
| [Soumettre une soumission de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/submit-bounty-submission.md) | POST `/bounty_submissions/{id}/submit` |
| [Annuler une soumission de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/cancel-bounty-submission.md) | DELETE `/bounty_submissions/{id}` |

## Attributs

**id** `string` *required*

ID de la soumission, préfixé par `btys_`.

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

La bounty à laquelle le travail a été soumis, préfixée par `bnty_`.

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

Les clips de capture de la soumission dans l'ordre d'enregistrement, chacun avec son propre `status` de vérification et des URL d'artefacts signées temporaires. Il s'agit du livrable complet lorsque `deliverable_type` vaut `data_capture`, renseigné uniquement lors de la lecture d'une seule soumission ; `null` dans les réponses de liste (utilisez `captured_clip_count` et `captured_duration_seconds` pour le résumé) et pour les autres types de livrables. Une tentative encore en cours liste tous les clips qu'elle a enregistrés, y compris ceux en échec ; une fois soumise, seuls les clips ayant passé la validation sont listés, car seuls ceux-ci constituent une preuve.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du clip de capture, préfixé par `bclip_`.
>
> **bounty\_submission\_id** `string` *required*
>
> La soumission de bounty (tentative) à laquelle appartient ce clip, préfixée
> par `btys_`.
>
> **created\_at** `string` *required*
>
> Date de création du clip, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `integer | null` *required*
>
> Durée du clip validée par le serveur, en secondes entières. `null` jusqu'à la
> fin de la validation.
>
> **failure\_code** `string | null` *required*
>
> Code stable d'échec de validation. `null` sauf si `status` vaut `failed`.
>
> **failure\_message** `string | null` *required*
>
> Motif lisible de l'échec de validation. `null` sauf si `status` vaut `failed`.
>
> **frames\_url** `string | null` *required*
>
> URL signée temporaire du journal des horodatages des images vidéo. Renvoyée
> uniquement lors de la lecture d'un seul clip pour un utilisateur autorisé ;
> `null` dans les réponses de liste ou tant que l'artefact n'est pas joint.
>
> **imu\_url** `string | null` *required*
>
> URL signée temporaire du journal IMU (accéléromètre + gyroscope). Renvoyée
> uniquement lors de la lecture d'un seul clip pour un utilisateur autorisé ;
> `null` dans les réponses de liste ou tant que l'artefact n'est pas joint.
>
> **manifest\_url** `string | null` *required*
>
> URL signée temporaire du manifeste de capture. Renvoyée uniquement lors de la
> lecture d'un seul clip pour un utilisateur autorisé ; `null` dans les réponses
> de liste ou tant que l'artefact n'est pas joint.
>
> **ready\_at** `string | null` *required*
>
> Date à laquelle la validation côté serveur s'est terminée avec succès, sous
> forme d'horodatage ISO 8601. `null` jusque-là.
>
> **sequence** `integer` *required*
>
> L'ordre stable du clip au sein de la tentative, à partir de 1.
>
> **status** `string` *required*
>
> État d'enregistrement et de validation. `recording` est encore en cours de capture ; `verifying` est en cours de validation côté serveur ; `ready` a passé la validation et compte pour le seuil de paiement basé sur la durée vérifiée ; `failed` n'a pas été validé.
>
> Options disponibles : `recording`, `verifying`, `ready`, `failed`
>
> **updated\_at** `string` *required*
>
> Date de dernière mise à jour du clip, sous forme d'horodatage ISO 8601.
>
> **video\_url** `string | null` *required*
>
> URL signée temporaire de la vidéo MP4 synchronisée. Renvoyée uniquement lors de la lecture d'un seul clip pour un utilisateur autorisé ; `null` dans les réponses de liste ou tant que l'artefact n'est pas joint.

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

La racine du nom de fichier fournisseur `Country_City_Site_Station_Operator`,
dérivée des métadonnées de capture. `null` tant que tous les composants ne
sont pas présents.

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

Nombre de clips de capture vérifiés acceptés jusqu'à présent pour cette
soumission. `0` pour les soumissions dont le livrable n'accumule pas de clips.

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

Durée totale vérifiée des clips de capture acceptés, en secondes entières. `0`
pour les soumissions dont le livrable n'accumule pas de clips.

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

Métadonnées de capture : ville dans laquelle les images ont été enregistrées.
`null` sauf si des métadonnées de capture ont été fournies.

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

Date à laquelle le travailleur a revendiqué la soumission, sous forme
d'horodatage ISO 8601.

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

Preuve écrite que le travailleur a soumise avec son travail.

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

Métadonnées de capture : pays dans lequel les images ont été enregistrées.
`null` sauf si des métadonnées de capture ont été fournies.

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

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

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

La manière dont le travail est arrivé lorsqu'il a été transmis en une seule fois via l'API, à titre informatif uniquement — lisez le travail directement depuis `deliverable_urls`, `files` et `capture_clips`. `null` pour les soumissions dont la preuve est l'enregistrement d'un livestream, y compris celles qui ont joint des liens ou des fichiers lors de la soumission.

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

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

Liens soumis en tant que travail, suivis des URL de téléchargement temporaires
des fichiers importés. `null` lorsque la soumission ne contient ni l'un ni
l'autre.

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

La raison du refus de la soumission, lorsqu'un motif présentable existe.
Toujours `null` sauf si `status` vaut `denied`.

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

Métadonnées de capture : appareil sur lequel les images ont été enregistrées.
`null` sauf si des métadonnées de capture ont été fournies.

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

Fichiers importés dans le cadre du travail, dans l'ordre d'importation. Vide lorsque la soumission n'en contient aucun.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du fichier, préfixé par `file_`.
>
> **attachment\_type** `string | null` *required*
>
> Catégorie générale du fichier.
>
> Options disponibles : `image`, `video`, `audio`, `other`
>
> **content\_type** `string | null` *required*
>
> Type MIME du fichier.
>
> **filename** `string | null` *required*
>
> Nom avec lequel le fichier a été importé.
>
> **url** `string | null` *required*
>
> URL de téléchargement temporaire du fichier.

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

Métadonnées de capture : champ de vision horizontal en degrés. `null` lorsqu'il
n'est pas communiqué.

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

Dernier livestream de preuve public joint à la soumission.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du flux de livestream.
>
> **ended\_at** `string | null` *required*
>
> Date de fin du livestream de preuve, sous forme d'horodatage ISO 8601. `null`
> tant qu'il est encore en direct — un flux avec un `started_at` et sans
> `ended_at` est en cours de diffusion.
>
> **recording\_status** `string | null` *required*
>
> État du cycle de vie de l'enregistrement.
>
> Options disponibles : `recording`, `processing`, `completed`, `failed`
>
> **recording\_url** `string | null` *required*
>
> URL de lecture d'un enregistrement de preuve terminé, lorsqu'elle est
> disponible.
>
> **started\_at** `string | null` *required*
>
> Date à laquelle le livestream de preuve a démarré, sous forme d'horodatage ISO
> 8601\. `null` avant son démarrage.
>
> **thumbnail\_url** `string | null` *required*
>
> URL actuelle de la miniature de la preuve, lorsqu'elle est disponible.
>
> **title** `string` *required*
>
> Titre d'affichage du livestream de preuve.

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

Métadonnées de capture : identifiant de la personne qui a enregistré les
images. `null` sauf si des métadonnées de capture ont été fournies.

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

Date à laquelle la soumission a été approuvée ou refusée, sous forme
d'horodatage ISO 8601. `null` jusque-là.

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

Métadonnées de capture : site ou lieu où les images ont été enregistrées.
`null` sauf si des métadonnées de capture ont été fournies.

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

Métadonnées de capture : poste ou position au sein du site. `null` sauf si des
métadonnées de capture ont été fournies.

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

État du cycle de vie. Les soumissions `in_progress` sont des tentatives actives qui n'ont pas encore soumis de preuve ; les soumissions `submitted` attendent d'être examinées ; les soumissions `approved` ont été acceptées et payées ; les soumissions `denied` ont été rejetées. `null` lorsque la tentative s'est terminée sans preuve, ce qui la retire du cycle de vie public — ces tentatives sont absentes de toutes les listes et lectures publiques.

Options disponibles : `in_progress`, `submitted`, `approved`, `denied`

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

Date à laquelle la preuve a été soumise pour examen, sous forme d'horodatage
ISO 8601. `null` tant que la tentative est en cours.

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

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

**worker** `object` *required*

Utilisateur qui a soumis le travail.

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

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

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