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

> Un Bounty es una tarea remunerada publicada por una cuenta o un usuario.

La recompensa se mantiene en custodia cuando el bounty se publica, los trabajadores envían pruebas del trabajo completado y cada envío aceptado se paga hasta que se llenan todos los puestos de ganador.

Usa la API de Bounties para crear y publicar un bounty, listar los bounties de una cuenta para informes o paneles, listar los bounties en los que un usuario puede trabajar o ha participado, y recuperar un único bounty por su ID.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Bounties](https://docs.whop.com/es/api-reference/bounties/list-bounties.md) | GET `/bounties` |
| [Recuperar Bounty](https://docs.whop.com/es/api-reference/bounties/retrieve-bounty.md) | GET `/bounties/{id}` |
| [Listar envíos públicos](https://docs.whop.com/es/api-reference/bounties/list-public-submissions.md) | GET `/bounties/{bounty_id}/submissions` |
| [Recuperar envío público](https://docs.whop.com/es/api-reference/bounties/retrieve-public-submission.md) | GET `/bounties/{bounty_id}/submissions/{id}` |
| [Crear Bounty](https://docs.whop.com/es/api-reference/bounties/create-bounty.md) | POST `/bounties` |
| [Cancelar](https://docs.whop.com/es/api-reference/bounties/cancel.md) | POST `/bounties/{id}/cancel` |
| [Actualizar Bounty](https://docs.whop.com/es/api-reference/bounties/update-bounty.md) | PATCH `/bounties/{id}` |

## Atributos

**id** `string` *required*

ID del bounty, con el prefijo `bnty_`.

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

Los formatos de entregable que acepta este bounty. Todo bounty acepta cualquier combinación de `content_url` (enlaces publicados) y `media` (archivos subidos), excepto los bounties `data_capture`, cuya prueba son clips grabados en la app de Whop que se acumulan en el intento.

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

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

Envíos aceptados hasta ahora.

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

Número de envíos que se pueden aceptar (puestos de ganador).

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

Cuántos puestos de ganador puede ganar un mismo trabajador. El valor predeterminado es `1`. Las victorias más las pruebas pendientes de revisión nunca superan este número, y un trabajador ejecuta un intento a la vez. No puede superar `accepted_submissions_limit`.

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

Transmisiones en vivo de prueba activas ahora mismo en este bounty, de la más reciente a la más antigua: trabajadores transmitiendo sus intentos. Vacío cuando no hay nada en vivo.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del feed de la transmisión en vivo.
>
> **host** `object | null` *required*
>
> Usuario que aloja la transmisión en vivo de prueba: el trabajador que transmite su intento. `null` si la cuenta anfitriona ya no existe.
>
> > [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.
>
> **title** `string` *required*
>
> Título para mostrar de la transmisión en vivo de prueba.

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

Lo que gana un referente por cada envío aceptado cuando el trabajador llegó a través de su enlace de afiliado, en unidades enteras de moneda, con la tarifa estándar de la plataforma. Se descuenta de la recompensa del trabajador después de tarifas en lugar de añadirse encima. `0` cuando el bounty no paga participación de afiliado, incluidos los bounties no vinculados a ninguna cuenta, que no pueden registrar una referencia.

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

Países cuyos residentes pueden trabajar en el bounty, como códigos ISO 3166 alfa-2. Vacío significa en todo el mundo.

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

Envíos entregados y en espera de revisión. Un subconjunto de `unresolved_submissions_count`, que también cuenta los intentos aún en curso.

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

Presupuesto bruto total comprometido con el bounty: `gross_reward_amount` multiplicado por `accepted_submissions_limit`.

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

Lo que el publicador quiere que logre el trabajo, declarado una sola vez al crearlo. `null` para bounties creados antes de que se implementara la taxonomía.

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

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

Cuándo se solicitó la cancelación, como marca de tiempo ISO 8601. En un bounty `closed` significa que la cancelación está pendiente: los envíos se detienen y el bounty se cancela una vez que se resuelven los envíos en curso. En un bounty `canceled` registra cuándo se solicitó la cancelación. `null` cuando nunca se solicitó una cancelación.

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

El contrato técnico con el que deben grabarse las secuencias. Presente solo en bounties `data_capture`; `null` para cualquier otro tipo de objetivo.

> [accordion] Propiedades
>
> **filename\_pattern** `string` *required*
>
> La convención de nombres para los archivos subidos, construida a partir de los campos de metadatos obligatorios.
>
> **imu** `object` *required*
>
> Requisitos de grabación de la unidad de medición inercial (IMU).
>
> > [accordion] Propiedades
> >
> > **device\_motion\_units** `string` *required*
> >
> > Unidades de los canales de movimiento del dispositivo, como una cadena compacta clave=unidad.
> >
> > **magnetometer\_units** `string` *required*
> >
> > Unidades del canal del magnetómetro.
> >
> > **min\_rate\_hz** `number` *required*
> >
> > Frecuencia de muestreo mínima sostenida de la IMU, en hercios, para que un clip supere la validación.
> >
> > **target\_rate\_hz** `integer` *required*
> >
> > Frecuencia de muestreo objetivo de la IMU, en hercios.
> >
> > **warmup\_min\_rate\_hz** `number` *required*
> >
> > Frecuencia de muestreo mínima de la IMU, en hercios, tolerada durante la ventana de calentamiento.
> >
> > **warmup\_ns** `integer` *required*
> >
> > Ventana de arranque, en nanosegundos, durante la cual se aplica la frecuencia de calentamiento relajada.
>
> **manifest\_schema\_version** `integer` *required*
>
> Versión del esquema que el cliente debe estampar en el manifiesto de captura que sube.
>
> **min\_clip\_duration\_seconds** `integer` *required*
>
> Duración mínima de un solo clip, en segundos.
>
> **min\_total\_verified\_duration\_seconds** `integer` *required*
>
> Total de metraje verificado que un envío debe acumular entre todos sus clips antes de poder enviarse, en segundos. Siempre es un número entero de horas.
>
> **required\_metadata\_fields** `string[]` *required*
>
> Campos de metadatos que debe proporcionar un envío, coincidentes con el objeto `metadata` de la API de envíos.
>
> **single\_continuous\_take** `boolean` *required*
>
> Si cada clip debe ser una grabación ininterrumpida en lugar de segmentos unidos.
>
> **video** `object` *required*
>
> Requisitos de grabación de video.
>
> > [accordion] Propiedades
> >
> > **bitrate\_ceiling\_mbps** `integer` *required*
> >
> > Bitrate promedio máximo aceptable, en megabits por segundo.
> >
> > **bitrate\_floor\_mbps** `integer` *required*
> >
> > Bitrate promedio mínimo aceptable, en megabits por segundo.
> >
> > **bitrate\_target\_mbps** `integer` *required*
> >
> > Bitrate promedio recomendado para codificar, en megabits por segundo.
> >
> > **camera\_lens** `string` *required*
> >
> > Con qué lente física grabar.
> >
> > **codecs** `string[]` *required*
> >
> > Códecs de video aceptados, en orden de preferencia.
> >
> > **embed\_camera\_metadata** `boolean` *required*
> >
> > Si el cliente también debe escribir la marca y el modelo de la cámara en los metadatos del contenedor de video. Cuando es `false`, el manifiesto de captura y el CSV de exportación son los portadores de los metadatos.
> >
> > **fps** `integer` *required*
> >
> > Frecuencia de fotogramas de captura objetivo.
> >
> > **frame\_gap\_tolerance\_ms** `integer` *required*
> >
> > Pausa más larga entre fotogramas consecutivos que puede contener un clip antes de que el cliente lo rechace, en milisegundos. Cada fotograma lleva marca de tiempo en el registro de fotogramas, por lo que una pausa sigue siendo alineable posteriormente: esto limita qué tan defectuosa puede ser una captura, no qué tan uniforme debe ser su ritmo.
> >
> > **height** `integer` *required*
> >
> > Altura de fotograma requerida en píxeles: el metraje grabado debe coincidir exactamente.
> >
> > **min\_fov\_degrees** `integer` *required*
> >
> > Campo de visión horizontal mínimo aceptable, en grados.
> >
> > **orientation** `string` *required*
> >
> > Orientación del dispositivo en la que grabar.
> >
> > **preferred\_fov\_degrees** `integer` *required*
> >
> > Campo de visión horizontal preferido, en grados.
> >
> > **stabilization\_mode** `string` *required*
> >
> > Cómo debe configurar el cliente la estabilización de video: `off` desactiva EIS para que el movimiento sin procesar se conserve para la extracción de pose, `on` la requiere, `any` deja el valor predeterminado del dispositivo.
> >
> > Opciones disponibles: `off`, `on`, `any`
> >
> > **stabilization\_required** `boolean` *required*
> >
> > Si la estabilización por hardware/software debe estar habilitada. Es verdadero exactamente cuando stabilization\_mode es `on`.
> >
> > **width** `integer` *required*
> >
> > Ancho de fotograma requerido en píxeles: el metraje grabado debe coincidir exactamente.

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

Cuándo se creó el bounty, como marca de tiempo ISO 8601.

**currency** `string` *required*

Moneda de todos los importes del bounty, como código ISO 4217 en minúsculas.

Opciones 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*

Envíos revisados y rechazados.

**description** `string` *required*

Instrucciones completas de la tarea que se muestran a los trabajadores.

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

Experiencia en la que vive el hilo de discusión del bounty, con el prefijo `exp_`. Lee este campo, no `experience_id`, para abrir el hilo: un bounty de toda la plataforma no tiene una experiencia anfitriona propia, pero su discusión sigue viviendo en una.

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

Feed del foro que contiene el hilo de discusión del bounty. `null` para un bounty sin publicación en el foro.

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

Publicación del foro que ancla el hilo de discusión del bounty. Léelo junto con `discussion_experience_id` para ubicar el hilo. `null` para un bounty sin publicación en el foro.

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

Experiencia en la que se aloja el bounty, con el prefijo `exp_`. `null` para bounties de toda la plataforma; puede pertenecer a una cuenta distinta de la que lo financia.

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

Cuenta cuyo saldo financia el fondo del bounty, o `null` cuando un usuario lo financia personalmente. Puede ser distinta de la cuenta que aloja `experience_id`.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **title** `string` *required*
>
> Nombre para mostrar de la cuenta.

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

Importe bruto pagado del fondo del bounty entre los envíos aceptados: pagos a trabajadores, tarifas de la plataforma y participaciones de afiliados en conjunto. Se excluyen las propinas y las recompensas de los revisores.

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

Importe bruto del fondo del bounty asignado por cada envío aceptado, en unidades enteras de moneda.

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

Cuenta que aloja el foro del bounty: aquella cuyo `route` y `experience_id` ubican su hilo de discusión, y donde vive su panel de envíos. `null` para un bounty de toda la plataforma sin anfitrión. Puede ser distinta de `funding_account`.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL de la imagen del logotipo de la cuenta. `null` cuando la cuenta no ha configurado uno.
>
> **route** `string` *required*
>
> Identificador de ruta pública de la cuenta, usado en la ruta de la tienda `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Nombre para mostrar de la cuenta.

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

Total de metraje verificado que un envío debe acumular antes de poder enviarse, en segundos. Siempre es un número entero de horas. Presente solo en bounties `data_capture`: es lo que paga `net_reward_amount`, por lo que las tarifas mostradas se dividen entre este valor. `null` para cualquier otro tipo de objetivo.

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

Lo que se le cotiza a un trabajador por cada envío aceptado después de la tarifa de la plataforma, en unidades enteras de moneda. La cifra exacta después de tarifas, con la tarifa estándar de la plataforma: a un trabajador que fijó una tarifa distinta, o que llegó a través de un enlace de afiliado, se le paga un importe diferente.

**poster** `object` *required*

Usuario que publicó el bounty: el propietario de la cuenta cuando se crea con una clave de API de cuenta.

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

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

Con qué frecuencia la programación crea un nuevo bounty. Cada ocurrencia es un bounty independiente; el original no se vuelve a publicar.

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

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

Cuándo se publicará un bounty programado, como marca de tiempo ISO 8601. `null` una vez publicado, para bounties que nunca se programaron y para borradores con fallo definitivo apartados para reprogramación manual.

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

Capacidad de ganadores sin cubrir: `accepted_submissions_limit` menos `accepted_submissions_count`, con un mínimo de cero. Por sí solo no indica que el bounty acepte nuevas reclamaciones; para eso, lee `status`: solo un bounty `open` admite nuevos envíos.

**status** `string` *required*

Estado del ciclo de vida. Los bounties `scheduled` son borradores sin publicar, visibles para su publicador y los administradores autorizados de la cuenta; los bounties `open` aceptan nuevos envíos; los bounties `closed` están activos pero ya no aceptan nuevos envíos; los bounties `completed` pagaron todos los puestos de ganador; los bounties `canceled` terminaron antes de llenar sus puestos.

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

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

Cuándo se dejaron de aceptar nuevos envíos, como marca de tiempo ISO 8601. Se establece cuando se solicita la cancelación de un bounty con trabajo en curso, para que los envíos en curso puedan resolverse antes de que el bounty se cancele. `null` cuando los envíos nunca se detuvieron, incluidos los bounties completados que simplemente llenaron todos los puestos de ganador.

**title** `string` *required*

Nombre corto de la tarea que se muestra a los trabajadores.

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

Envíos que aún esperan un resultado: en curso o pendientes de revisión.

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

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

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

Cuántos puestos de ganador ya ha ganado el usuario autenticado en este bounty. Compáralo con `accepted_submissions_per_user_limit` para mostrar a un trabajador su asignación restante. `0` cuando la solicitud no tiene un usuario autenticado.

```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 de Bounty Submissions](https://docs.whop.com/es/api-reference/bounty-submissions/bounty-submission.md)
- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
