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

# Ödül Görevi Gönderimleri API'si

> Ödül Görevi Gönderimi, bir çalışanın bir ödül görevi üzerindeki denemesidir.

Devam eden bir deneme olarak başlar, kanıt gönderildiğinde inceleme kuyruğuna girer ve onaylanmış (ödül görevinin emanetteki havuzundan ödenir) veya reddedilmiş olarak sona erer.

Ödül Görevi Gönderimleri API'sini bir ödül görevine tamamlanan işin kanıtını göndermek, yazdığınız gönderimleri listelemek ve ödül görevlerinizdeki gönderimleri incelemek için kullanın — tüm ödül görevleri genelinde veya tek bir göreve daraltılmış olarak.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Ödül Görevi Gönderimlerini Listele](https://docs.whop.com/tr/api-reference/bounty-submissions/list-bounty-submissions.md) | GET `/bounty_submissions` |
| [Ödül Görevi Gönderimini Al](https://docs.whop.com/tr/api-reference/bounty-submissions/retrieve-bounty-submission.md) | GET `/bounty_submissions/{id}` |
| [Ödül Görevi Gönderimi Oluştur](https://docs.whop.com/tr/api-reference/bounty-submissions/create-bounty-submission.md) | POST `/bounty_submissions` |
| [Ödül Görevi Gönderimini Gönder](https://docs.whop.com/tr/api-reference/bounty-submissions/submit-bounty-submission.md) | POST `/bounty_submissions/{id}/submit` |
| [Ödül Görevi Gönderimini İptal Et](https://docs.whop.com/tr/api-reference/bounty-submissions/cancel-bounty-submission.md) | DELETE `/bounty_submissions/{id}` |

## Öznitelikler

**id** `string` *required*

`btys_` önekli gönderim kimliği.

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

İşin gönderildiği `bnty_` önekli ödül görevi.

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

Gönderimin kayıt sırasına göre yakalama klipleri; her biri kendi inceleme `status` değerini ve geçici imzalı yapıt URL'lerini taşır. `deliverable_type` değeri `data_capture` olduğunda tam teslimattır ve yalnızca tek gönderim okumalarında doldurulur; liste yanıtlarında (özet için `captured_clip_count` ve `captured_duration_seconds` kullanın) ve diğer teslimat türleri için `null`. Hâlâ devam eden bir deneme, başarısız olanlar dahil kaydettiği tüm klipleri listeler; gönderildikten sonra yalnızca doğrulamayı geçen klipler listelenir, çünkü yalnızca bunlar kanıttır.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `bclip_` önekli yakalama klibi kimliği.
>
> **bounty\_submission\_id** `string` *required*
>
> Bu klibin ait olduğu `btys_` önekli ödül görevi gönderimi (deneme).
>
> **created\_at** `string` *required*
>
> Klibin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
>
> **duration\_seconds** `integer | null` *required*
>
> Sunucu tarafından doğrulanmış klip süresi, tam saniye cinsinden. Doğrulama tamamlanana kadar `null`.
>
> **failure\_code** `string | null` *required*
>
> Kararlı doğrulama hatası kodu. `status` değeri `failed` olmadıkça `null`.
>
> **failure\_message** `string | null` *required*
>
> İnsan tarafından okunabilir doğrulama hatası nedeni. `status` değeri `failed` olmadıkça `null`.
>
> **frames\_url** `string | null` *required*
>
> Video kare zaman damgası günlüğü için geçici imzalı URL. Yalnızca yetkili bir görüntüleyici için tek klip okumalarında döndürülür; liste yanıtlarında veya yapıt eklenene kadar `null`.
>
> **imu\_url** `string | null` *required*
>
> IMU (ivmeölçer + jiroskop) günlüğü için geçici imzalı URL. Yalnızca yetkili bir görüntüleyici için tek klip okumalarında döndürülür; liste yanıtlarında veya yapıt eklenene kadar `null`.
>
> **manifest\_url** `string | null` *required*
>
> Yakalama manifestosu için geçici imzalı URL. Yalnızca yetkili bir görüntüleyici için tek klip okumalarında döndürülür; liste yanıtlarında veya yapıt eklenene kadar `null`.
>
> **ready\_at** `string | null` *required*
>
> Sunucu tarafı doğrulamanın başarıyla tamamlandığı zaman, ISO 8601 zaman damgası olarak. O zamana kadar `null`.
>
> **sequence** `integer` *required*
>
> Klibin deneme içindeki kararlı sırası, 1'den başlar.
>
> **status** `string` *required*
>
> Kayıt ve doğrulama durumu. `recording` hâlâ kayıt yapıyor; `verifying` sunucu tarafı doğrulama çalıştırıyor; `ready` doğrulamayı geçti ve doğrulanmış süre ödeme eşiğine sayılır; `failed` doğrulanamadı.
>
> Kullanılabilir seçenekler: `recording`, `verifying`, `ready`, `failed`
>
> **updated\_at** `string` *required*
>
> Klibin son güncellendiği zaman, ISO 8601 zaman damgası olarak.
>
> **video\_url** `string | null` *required*
>
> Senkronize MP4 videosu için geçici imzalı URL. Yalnızca yetkili bir görüntüleyici için tek klip okumalarında döndürülür; liste yanıtlarında veya yapıt eklenene kadar `null`.

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

Yakalama meta verilerinden türetilen satıcı dosya adı kökü `Country_City_Site_Station_Operator`. Tüm bileşenler mevcut olana kadar `null`.

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

Bu gönderim için şimdiye kadar kabul edilen doğrulanmış yakalama klibi sayısı. Teslimatı klip biriktirmeyen gönderimler için `0`.

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

Kabul edilen yakalama kliplerinin toplam doğrulanmış süresi, tam saniye cinsinden. Teslimatı klip biriktirmeyen gönderimler için `0`.

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

Yakalama meta verisi: görüntünün kaydedildiği şehir. Yakalama meta verisi sağlanmadıysa `null`.

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

Çalışanın gönderimi üstlendiği zaman, ISO 8601 zaman damgası olarak.

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

Çalışanın işiyle birlikte gönderdiği yazılı kanıt.

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

Yakalama meta verisi: görüntünün kaydedildiği ülke. Yakalama meta verisi sağlanmadıysa `null`.

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

Gönderimin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

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

İş API üzerinden tek seferde geldiğinde nasıl ulaştığı; yalnızca bilgilendirme amaçlıdır — işi doğrudan `deliverable_urls`, `files` ve `capture_clips` alanlarından okuyun. Kanıtı bir canlı yayın kaydı olan gönderimler için `null`; buna gönderim sırasında bağlantı veya dosya ekleyenler de dahildir.

Kullanılabilir seçenekler: `content_url`, `media`, `data_capture`

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

İş olarak gönderilen bağlantılar ve ardından yüklenen dosyalar için geçici indirme URL'leri. Gönderim ikisini de içermiyorsa `null`.

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

Sunulabilir bir neden mevcut olduğunda gönderimin neden reddedildiği. `status` değeri `denied` olmadıkça her zaman `null`.

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

Yakalama meta verisi: görüntünün kaydedildiği cihaz. Yakalama meta verisi sağlanmadıysa `null`.

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

İşin bir parçası olarak yüklenen dosyalar, yükleme sırasına göre. Gönderimde dosya yoksa boştur.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `file_` önekli dosya kimliği.
>
> **attachment\_type** `string | null` *required*
>
> Dosyanın genel türü.
>
> Kullanılabilir seçenekler: `image`, `video`, `audio`, `other`
>
> **content\_type** `string | null` *required*
>
> Dosyanın MIME türü.
>
> **filename** `string | null` *required*
>
> Dosyanın yüklendiği ad.
>
> **url** `string | null` *required*
>
> Dosya için geçici indirme URL'si.

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

Yakalama meta verisi: derece cinsinden yatay görüş alanı. Bildirilmediyse `null`.

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

Gönderime eklenen en son herkese açık kanıt canlı yayını.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Canlı yayın akışı kimliği.
>
> **ended\_at** `string | null` *required*
>
> Kanıt canlı yayınının sona erdiği zaman, ISO 8601 zaman damgası olarak. Hâlâ yayındayken `null` — `started_at` değeri olup `ended_at` değeri olmayan bir akış şu anda yayındadır.
>
> **recording\_status** `string | null` *required*
>
> Kayıt yaşam döngüsü durumu.
>
> Kullanılabilir seçenekler: `recording`, `processing`, `completed`, `failed`
>
> **recording\_url** `string | null` *required*
>
> Mevcut olduğunda, tamamlanmış bir kanıt kaydının oynatma URL'si.
>
> **started\_at** `string | null` *required*
>
> Kanıt canlı yayınının yayına girdiği zaman, ISO 8601 zaman damgası olarak. Başlamadan önce `null`.
>
> **thumbnail\_url** `string | null` *required*
>
> Mevcut olduğunda, güncel kanıt küçük resmi URL'si.
>
> **title** `string` *required*
>
> Kanıt canlı yayınının görünen başlığı.

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

Yakalama meta verisi: görüntüyü kaydeden kişinin tanımlayıcısı. Yakalama meta verisi sağlanmadıysa `null`.

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

Gönderimin onaylandığı veya reddedildiği zaman, ISO 8601 zaman damgası olarak. O zamana kadar `null`.

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

Yakalama meta verisi: görüntünün kaydedildiği tesis veya mekân. Yakalama meta verisi sağlanmadıysa `null`.

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

Yakalama meta verisi: tesis içindeki istasyon veya konum. Yakalama meta verisi sağlanmadıysa `null`.

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

Yaşam döngüsü durumu. `in_progress` gönderimler henüz kanıt göndermemiş etkin denemelerdir; `submitted` gönderimler incelemeyi bekler; `approved` gönderimler kabul edilmiş ve ödenmiştir; `denied` gönderimler reddedilmiştir. Deneme kanıt olmadan sona erdiyse `null`; bu onu herkese açık yaşam döngüsünün dışına çıkarır — bu tür denemeler tüm herkese açık listelerde ve okumalarda yer almaz.

Kullanılabilir seçenekler: `in_progress`, `submitted`, `approved`, `denied`

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

Kanıtın incelemeye gönderildiği zaman, ISO 8601 zaman damgası olarak. Deneme devam ederken `null`.

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

Gönderimin son güncellendiği zaman, ISO 8601 zaman damgası olarak.

**worker** `object` *required*

İşi gönderen kullanıcı.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **profile\_picture** `object` *required*
>
> Avatar sarmalayıcısı. `url` değeri her zaman mevcuttur ve kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> > [accordion] Özellikler
> >
> > **url** `string` *required*
> >
> > Avatar resim URL'si. Her zaman mevcuttur. Kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

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

- [Ödül Görevleri API'si](https://docs.whop.com/tr/api-reference/bounties/bounty.md)
- [Bir ödül görevi programı yürütün](https://docs.whop.com/tr/developer/bounties/run-a-bounty-program.md)
- [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
