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

> Un Bounty Submission es el intento de un trabajador en un bounty.

Comienza como un intento en curso, entra en la cola de revisión cuando se envía la prueba y termina aprobado (pagado del fondo en custodia del bounty) o rechazado.

Usa la API de Bounty Submissions para enviar pruebas del trabajo completado a un bounty, listar los envíos de los que eres autor y revisar los envíos de tus bounties, en todos los bounties o limitados a uno.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Bounty Submissions](https://docs.whop.com/es/api-reference/bounty-submissions/list-bounty-submissions.md) | GET `/bounty_submissions` |
| [Recuperar Bounty Submission](https://docs.whop.com/es/api-reference/bounty-submissions/retrieve-bounty-submission.md) | GET `/bounty_submissions/{id}` |
| [Crear Bounty Submission](https://docs.whop.com/es/api-reference/bounty-submissions/create-bounty-submission.md) | POST `/bounty_submissions` |
| [Enviar Bounty Submission](https://docs.whop.com/es/api-reference/bounty-submissions/submit-bounty-submission.md) | POST `/bounty_submissions/{id}/submit` |
| [Cancelar Bounty Submission](https://docs.whop.com/es/api-reference/bounty-submissions/cancel-bounty-submission.md) | DELETE `/bounty_submissions/{id}` |

## Atributos

**id** `string` *required*

ID del envío, con el prefijo `btys_`.

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

El bounty al que se envió el trabajo, con el prefijo `bnty_`.

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

Los clips de captura del envío en orden de grabación, cada uno con su propio `status` de revisión y URLs firmadas temporales de los artefactos. El entregable completo cuando `deliverable_type` es `data_capture`, rellenado solo en lecturas de un único envío; `null` en las respuestas de listado (usa `captured_clip_count` y `captured_duration_seconds` para el resumen) y para otros tipos de entregable. Un intento aún en curso lista todos los clips que ha grabado, incluidos los fallidos; una vez enviado, solo se listan los clips que superaron la validación, ya que solo esos constituyen evidencia.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del clip de captura, con el prefijo `bclip_`.
>
> **bounty\_submission\_id** `string` *required*
>
> El envío de bounty (intento) al que pertenece este clip, con el prefijo `btys_`.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el clip, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `integer | null` *required*
>
> Duración del clip validada por el servidor, en segundos enteros. `null` hasta que se completa la validación.
>
> **failure\_code** `string | null` *required*
>
> Código estable del fallo de validación. `null` a menos que `status` sea `failed`.
>
> **failure\_message** `string | null` *required*
>
> Motivo legible del fallo de validación. `null` a menos que `status` sea `failed`.
>
> **frames\_url** `string | null` *required*
>
> URL firmada temporal del registro de marcas de tiempo de los fotogramas del video. Solo se devuelve en lecturas de un único clip para un observador autorizado; `null` en respuestas de listado o hasta que se adjunta el artefacto.
>
> **imu\_url** `string | null` *required*
>
> URL firmada temporal del registro de la IMU (acelerómetro + giroscopio). Solo se devuelve en lecturas de un único clip para un observador autorizado; `null` en respuestas de listado o hasta que se adjunta el artefacto.
>
> **manifest\_url** `string | null` *required*
>
> URL firmada temporal del manifiesto de captura. Solo se devuelve en lecturas de un único clip para un observador autorizado; `null` en respuestas de listado o hasta que se adjunta el artefacto.
>
> **ready\_at** `string | null` *required*
>
> Cuándo se completó correctamente la validación del lado del servidor, como marca de tiempo ISO 8601. `null` hasta entonces.
>
> **sequence** `integer` *required*
>
> El orden estable del clip dentro del intento, empezando en 1.
>
> **status** `string` *required*
>
> Estado de grabación y validación. `recording` sigue capturando; `verifying` está ejecutando la validación del lado del servidor; `ready` superó la validación y cuenta para el umbral de pago por duración verificada; `failed` no superó la validación.
>
> Opciones disponibles: `recording`, `verifying`, `ready`, `failed`
>
> **updated\_at** `string` *required*
>
> Cuándo se actualizó el clip por última vez, como marca de tiempo ISO 8601.
>
> **video\_url** `string | null` *required*
>
> URL firmada temporal del video MP4 sincronizado. Solo se devuelve en lecturas de un único clip para un observador autorizado; `null` en respuestas de listado o hasta que se adjunta el artefacto.

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

La raíz del nombre de archivo del proveedor `Country_City_Site_Station_Operator`, derivada de los metadatos de captura. `null` hasta que están presentes todos los componentes.

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

Número de clips de captura verificados aceptados para este envío hasta ahora. `0` para envíos cuyo entregable no acumula clips.

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

Duración verificada total de los clips de captura aceptados, en segundos enteros. `0` para envíos cuyo entregable no acumula clips.

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

Metadatos de captura: ciudad en la que se grabó el metraje. `null` a menos que se hayan proporcionado metadatos de captura.

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

Cuándo el trabajador reclamó el envío, como marca de tiempo ISO 8601.

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

Prueba escrita que el trabajador envió con su trabajo.

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

Metadatos de captura: país en el que se grabó el metraje. `null` a menos que se hayan proporcionado metadatos de captura.

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

Cuándo se creó el envío, como marca de tiempo ISO 8601.

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

Cómo llegó el trabajo cuando entró por la API de una sola vez; solo informativo: lee el trabajo directamente de `deliverable_urls`, `files` y `capture_clips`. `null` para envíos cuya prueba es una grabación de transmisión en vivo, incluidos los que adjuntaron enlaces o archivos al enviarse.

Opciones disponibles: `content_url`, `media`, `data_capture`

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

Enlaces enviados como trabajo, seguidos de URLs de descarga temporales para los archivos subidos. `null` cuando el envío no contiene ninguno de los dos.

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

Por qué se rechazó el envío, cuando existe un motivo presentable. Siempre `null` a menos que `status` sea `denied`.

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

Metadatos de captura: dispositivo con el que se grabó el metraje. `null` a menos que se hayan proporcionado metadatos de captura.

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

Archivos subidos como parte del trabajo, en orden de subida. Vacío cuando el envío no tiene ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del archivo, con el prefijo `file_`.
>
> **attachment\_type** `string | null` *required*
>
> Tipo general de archivo.
>
> Opciones disponibles: `image`, `video`, `audio`, `other`
>
> **content\_type** `string | null` *required*
>
> Tipo MIME del archivo.
>
> **filename** `string | null` *required*
>
> Nombre con el que se subió el archivo.
>
> **url** `string | null` *required*
>
> URL de descarga temporal del archivo.

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

Metadatos de captura: campo de visión horizontal en grados. `null` cuando no se informa.

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

Última transmisión en vivo de prueba pública adjunta al envío.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del feed de la transmisión en vivo.
>
> **ended\_at** `string | null` *required*
>
> Cuándo terminó la transmisión en vivo de prueba, como marca de tiempo ISO 8601. `null` mientras sigue en vivo: un feed con `started_at` y sin `ended_at` se está transmitiendo ahora mismo.
>
> **recording\_status** `string | null` *required*
>
> Estado del ciclo de vida de la grabación.
>
> Opciones disponibles: `recording`, `processing`, `completed`, `failed`
>
> **recording\_url** `string | null` *required*
>
> URL de reproducción de una grabación de prueba completada, cuando está disponible.
>
> **started\_at** `string | null` *required*
>
> Cuándo comenzó la transmisión en vivo de prueba, como marca de tiempo ISO 8601. `null` antes de que comience.
>
> **thumbnail\_url** `string | null` *required*
>
> URL de la miniatura de prueba actual, cuando está disponible.
>
> **title** `string` *required*
>
> Título para mostrar de la transmisión en vivo de prueba.

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

Metadatos de captura: identificador de la persona que grabó el metraje. `null` a menos que se hayan proporcionado metadatos de captura.

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

Cuándo se aprobó o rechazó el envío, como marca de tiempo ISO 8601. `null` hasta entonces.

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

Metadatos de captura: sitio o lugar donde se grabó el metraje. `null` a menos que se hayan proporcionado metadatos de captura.

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

Metadatos de captura: estación o posición dentro del sitio. `null` a menos que se hayan proporcionado metadatos de captura.

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

Estado del ciclo de vida. Los envíos `in_progress` son intentos activos que aún no han enviado pruebas; los envíos `submitted` esperan revisión; los envíos `approved` fueron aceptados y pagados; los envíos `denied` fueron rechazados. `null` cuando el intento terminó sin prueba, lo que lo saca del ciclo de vida público: esos intentos no aparecen en ningún listado ni lectura públicos.

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

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

Cuándo se envió la prueba para revisión, como marca de tiempo ISO 8601. `null` mientras el intento está en curso.

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

Cuándo se actualizó el envío por última vez, como marca de tiempo ISO 8601.

**worker** `object` *required*

Usuario que envió el trabajo.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre para mostrar.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha configurado ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no ha configurado ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

```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 de Bounties](https://docs.whop.com/es/api-reference/bounties/bounty.md)
- [List Bounty Submissions](https://docs.whop.com/es/api-reference/bounty-submissions/list-bounty-submissions.md)
- [Create Bounty Submission](https://docs.whop.com/es/api-reference/bounty-submissions/create-bounty-submission.md)
