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

# Bounty Submissions API

> 바운티 제출물(Bounty Submission)은 바운티에 대한 한 작업자의 시도입니다.

진행 중인 시도로 시작하여, 증빙이 제출되면 검토 대기열에 들어가고, 승인(바운티의 에스크로 풀에서 지급)되거나 거절되어 종료됩니다.

Bounty Submissions API를 사용하여 바운티에 완료한 작업의 증빙을 제출하고, 직접 작성한 제출물을 조회하고, 자신의 바운티에 대한 제출물을 모든 바운티 전체 또는 하나의 바운티로 좁혀서 검토할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [바운티 제출물 목록 조회](https://docs.whop.com/ko/api-reference/bounty-submissions/list-bounty-submissions.md) | GET `/bounty_submissions` |
| [바운티 제출물 조회](https://docs.whop.com/ko/api-reference/bounty-submissions/retrieve-bounty-submission.md) | GET `/bounty_submissions/{id}` |
| [바운티 제출물 생성](https://docs.whop.com/ko/api-reference/bounty-submissions/create-bounty-submission.md) | POST `/bounty_submissions` |
| [바운티 제출물 제출](https://docs.whop.com/ko/api-reference/bounty-submissions/submit-bounty-submission.md) | POST `/bounty_submissions/{id}/submit` |
| [바운티 제출물 취소](https://docs.whop.com/ko/api-reference/bounty-submissions/cancel-bounty-submission.md) | DELETE `/bounty_submissions/{id}` |

## 속성

**id** `string` *required*

제출물 ID이며, 접두사는 `btys_`입니다.

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

작업이 제출된 바운티로, 접두사는 `bnty_`입니다.

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

녹화 순서대로 정렬된 제출물의 캡처 클립으로, 각 클립에는 자체 검토 `status`와 임시 서명된 아티팩트 URL이 포함됩니다. `deliverable_type`이 `data_capture`인 경우 전체 결과물이며, 단일 제출물 조회 시에만 채워집니다. 목록 응답(요약에는 `captured_clip_count`와 `captured_duration_seconds`를 사용하세요)과 다른 결과물 유형에서는 `null`입니다. 아직 진행 중인 시도는 실패한 클립을 포함하여 녹화한 모든 클립을 나열합니다. 제출된 후에는 검증을 통과한 클립만 증빙이 되므로 해당 클립만 나열됩니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 캡처 클립 ID이며, 접두사는 `bclip_`입니다.
>
> **bounty\_submission\_id** `string` *required*
>
> 이 클립이 속한 바운티 제출물(시도)로, 접두사는 `btys_`입니다.
>
> **created\_at** `string` *required*
>
> 클립이 생성된 시점으로, ISO 8601 타임스탬프입니다.
>
> **duration\_seconds** `integer | null` *required*
>
> 서버에서 검증된 클립 길이(정수 초)입니다. 검증이 완료될 때까지 `null`입니다.
>
> **failure\_code** `string | null` *required*
>
> 고정된 검증 실패 코드입니다. `status`가 `failed`가 아니면 `null`입니다.
>
> **failure\_message** `string | null` *required*
>
> 사람이 읽을 수 있는 검증 실패 사유입니다. `status`가 `failed`가 아니면 `null`입니다.
>
> **frames\_url** `string | null` *required*
>
> 비디오 프레임 타임스탬프 로그의 임시 서명 URL입니다. 권한 있는 조회자의 단일 클립 조회 시에만 반환되며, 목록 응답이거나 아티팩트가 첨부되기 전에는 `null`입니다.
>
> **imu\_url** `string | null` *required*
>
> IMU(가속도계 + 자이로스코프) 로그의 임시 서명 URL입니다. 권한 있는 조회자의 단일 클립 조회 시에만 반환되며, 목록 응답이거나 아티팩트가 첨부되기 전에는 `null`입니다.
>
> **manifest\_url** `string | null` *required*
>
> 캡처 매니페스트의 임시 서명 URL입니다. 권한 있는 조회자의 단일 클립 조회 시에만 반환되며, 목록 응답이거나 아티팩트가 첨부되기 전에는 `null`입니다.
>
> **ready\_at** `string | null` *required*
>
> 서버 측 검증이 성공적으로 완료된 시점으로, ISO 8601 타임스탬프입니다. 그 전까지는 `null`입니다.
>
> **sequence** `integer` *required*
>
> 시도 내에서 클립의 고정된 순서로, 1부터 시작합니다.
>
> **status** `string` *required*
>
> 녹화 및 검증 상태입니다. `recording`은 아직 캡처 중이고, `verifying`은 서버 측 검증을 실행 중이며, `ready`는 검증을 통과하여 검증된 길이 기반 지급 조건에 포함되고, `failed`는 검증에 실패했습니다.
>
> 사용 가능한 옵션: `recording`, `verifying`, `ready`, `failed`
>
> **updated\_at** `string` *required*
>
> 클립이 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.
>
> **video\_url** `string | null` *required*
>
> 동기화된 MP4 비디오의 임시 서명 URL입니다. 권한 있는 조회자의 단일 클립 조회 시에만 반환되며, 목록 응답이거나 아티팩트가 첨부되기 전에는 `null`입니다.

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

캡처 메타데이터에서 파생된 공급업체 파일 이름 기본형 `Country_City_Site_Station_Operator`입니다. 모든 구성 요소가 존재할 때까지 `null`입니다.

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

지금까지 이 제출물에 대해 승인된 검증된 캡처 클립 수입니다. 결과물이 클립을 누적하지 않는 제출물은 `0`입니다.

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

승인된 캡처 클립의 총 검증된 길이(정수 초)입니다. 결과물이 클립을 누적하지 않는 제출물은 `0`입니다.

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

캡처 메타데이터: 영상이 녹화된 도시입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

작업자가 제출물을 시작한 시점으로, ISO 8601 타임스탬프입니다.

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

작업자가 작업과 함께 제출한 서면 증빙입니다.

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

캡처 메타데이터: 영상이 녹화된 국가입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

제출물이 생성된 시점으로, ISO 8601 타임스탬프입니다.

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

작업이 API를 통해 한 번에 들어온 경우 작업이 도착한 방식으로, 참고용입니다. 작업 내용은 `deliverable_urls`, `files`, `capture_clips`에서 직접 확인하세요. 제출 시 링크나 파일을 첨부한 경우를 포함하여, 증빙이 라이브 스트림 녹화인 제출물은 `null`입니다.

사용 가능한 옵션: `content_url`, `media`, `data_capture`

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

작업으로 제출된 링크와 그 뒤에 이어지는 업로드 파일의 임시 다운로드 URL입니다. 제출물에 둘 다 없으면 `null`입니다.

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

제출물이 거절된 사유로, 표시할 수 있는 사유가 있는 경우에 제공됩니다. `status`가 `denied`가 아니면 항상 `null`입니다.

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

캡처 메타데이터: 영상을 녹화한 기기입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

작업의 일부로 업로드된 파일로, 업로드 순서대로 정렬됩니다. 제출물에 파일이 없으면 비어 있습니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 파일 ID이며, 접두사는 `file_`입니다.
>
> **attachment\_type** `string | null` *required*
>
> 파일의 대략적인 종류입니다.
>
> 사용 가능한 옵션: `image`, `video`, `audio`, `other`
>
> **content\_type** `string | null` *required*
>
> 파일의 MIME 유형입니다.
>
> **filename** `string | null` *required*
>
> 파일이 업로드될 때의 이름입니다.
>
> **url** `string | null` *required*
>
> 파일의 임시 다운로드 URL입니다.

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

캡처 메타데이터: 수평 시야각(도)입니다. 보고되지 않은 경우 `null`입니다.

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

제출물에 첨부된 최신 공개 증빙 라이브 스트림입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 라이브 스트림 피드 ID입니다.
>
> **ended\_at** `string | null` *required*
>
> 증빙 라이브 스트림이 종료된 시점으로, ISO 8601 타임스탬프입니다. 아직 라이브 중이면 `null`입니다. `started_at`이 있고 `ended_at`이 없는 피드는 현재 스트리밍 중입니다.
>
> **recording\_status** `string | null` *required*
>
> 녹화 수명 주기 상태입니다.
>
> 사용 가능한 옵션: `recording`, `processing`, `completed`, `failed`
>
> **recording\_url** `string | null` *required*
>
> 완료된 증빙 녹화의 재생 URL로, 사용 가능한 경우에 제공됩니다.
>
> **started\_at** `string | null` *required*
>
> 증빙 라이브 스트림이 시작된 시점으로, ISO 8601 타임스탬프입니다. 시작 전에는 `null`입니다.
>
> **thumbnail\_url** `string | null` *required*
>
> 현재 증빙 썸네일 URL로, 사용 가능한 경우에 제공됩니다.
>
> **title** `string` *required*
>
> 증빙 라이브 스트림의 표시 제목입니다.

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

캡처 메타데이터: 영상을 녹화한 사람의 식별자입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

제출물이 승인 또는 거절된 시점으로, ISO 8601 타임스탬프입니다. 그 전까지는 `null`입니다.

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

캡처 메타데이터: 영상이 녹화된 사이트 또는 장소입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

캡처 메타데이터: 사이트 내 스테이션 또는 위치입니다. 캡처 메타데이터가 제공되지 않은 경우 `null`입니다.

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

수명 주기 상태입니다. `in_progress` 제출물은 아직 증빙을 제출하지 않은 활성 시도이고, `submitted` 제출물은 검토를 기다리며, `approved` 제출물은 승인되어 지급되었고, `denied` 제출물은 거절되었습니다. 시도가 증빙 없이 종료되어 공개 수명 주기에서 제외된 경우 `null`입니다. 이러한 시도는 모든 공개 목록 및 조회에서 제외됩니다.

사용 가능한 옵션: `in_progress`, `submitted`, `approved`, `denied`

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

증빙이 검토를 위해 제출된 시점으로, ISO 8601 타임스탬프입니다. 시도가 진행 중인 동안에는 `null`입니다.

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

제출물이 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.

**worker** `object` *required*

작업을 제출한 사용자입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자 ID이며, 접두사는 `user_`입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

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

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