Submit Bounty Submission

TypeScript

import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: "YOUR_TOKEN", apiVersionDate: "2026-08-21-1", idempotencyKey: "YOUR_IDEMPOTENCY_KEY" });
await client.bountySubmissions.submit({
    id: "id"
});

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions/{id}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deliverable": {
    "caption": "Full interior detail, start to finish, on a 2019 Tacoma.",
    "file_ids": [
      "file_xxxxxxxxxxxxxx"
    ],
    "urls": [
      "https://youtube.com/shorts/4"
    ]
  }
}
'

import requests

url = "https://api.whop.com/api/v1/bounty_submissions/{id}/submit"

payload = { "deliverable": {
        "caption": "Full interior detail, start to finish, on a 2019 Tacoma.",
        "file_ids": ["file_xxxxxxxxxxxxxx"],
        "urls": ["https://youtube.com/shorts/4"]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    deliverable: {
      caption: 'Full interior detail, start to finish, on a 2019 Tacoma.',
      file_ids: ['file_xxxxxxxxxxxxxx'],
      urls: ['https://youtube.com/shorts/4']
    }
  })
};

fetch('https://api.whop.com/api/v1/bounty_submissions/{id}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounty_submissions/{id}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'deliverable' => [
        'caption' => 'Full interior detail, start to finish, on a 2019 Tacoma.',
        'file_ids' => [
                'file_xxxxxxxxxxxxxx'
        ],
        'urls' => [
                'https://youtube.com/shorts/4'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/bounty_submissions/{id}/submit"

	payload := strings.NewReader("{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/bounty_submissions/{id}/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions/{id}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "bounty_id": "bnty_xxxxxxxxxxxxxx",
  "capture_clips": null,
  "capture_filename": "US_Austin_BurnetRd_Bay2_mwebb",
  "captured_clip_count": 0,
  "captured_duration_seconds": 0,
  "city": "Austin",
  "claimed_at": "2026-01-01T12:00:00.000Z",
  "content": "Ceramic coating reveal, shot at the Burnet Rd bay",
  "country": "US",
  "created_at": "2026-01-01T12:00:00.000Z",
  "deliverable_type": "media",
  "deliverable_urls": [
    "https://tiktok.com/@shinetime/video/1"
  ],
  "denial_reason": "The clip never shows the finished paint.",
  "device": "iPhone 15 Pro",
  "files": [
    {
      "attachment_type": "image",
      "content_type": "image/png",
      "filename": "ceramic-coating-cut.png",
      "id": "file_xxxxxxxxxxxxxx",
      "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  ],
  "fov": 120,
  "id": "btys_xxxxxxxxxxxxxx",
  "latest_proof_livestream_feed": {
    "ended_at": "2026-01-01T12:00:00.000Z",
    "id": "lfeed_1",
    "recording_status": "completed",
    "recording_url": "https://whop-assets-example.s3.amazonaws.com/uploads/video/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "started_at": "2026-01-01T12:00:00.000Z",
    "thumbnail_url": "https://img.whop.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxx/resize:fit/width:1000/height:500/plain/https://cdn.whop.com/livestreams/paint-correction-proof-cover.jpg",
    "title": "Untitled Livestream"
  },
  "operator": "mwebb",
  "resolved_at": "2026-01-01T12:00:00.000Z",
  "site": "BurnetRd",
  "station": "Bay2",
  "status": "submitted",
  "submitted_at": "2026-01-01T12:00:00.000Z",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "worker": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

POST

bounty_submissions

{id}

submit

TypeScript

import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: "YOUR_TOKEN", apiVersionDate: "2026-08-21-1", idempotencyKey: "YOUR_IDEMPOTENCY_KEY" });
await client.bountySubmissions.submit({
    id: "id"
});

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions/{id}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deliverable": {
    "caption": "Full interior detail, start to finish, on a 2019 Tacoma.",
    "file_ids": [
      "file_xxxxxxxxxxxxxx"
    ],
    "urls": [
      "https://youtube.com/shorts/4"
    ]
  }
}
'

import requests

url = "https://api.whop.com/api/v1/bounty_submissions/{id}/submit"

payload = { "deliverable": {
        "caption": "Full interior detail, start to finish, on a 2019 Tacoma.",
        "file_ids": ["file_xxxxxxxxxxxxxx"],
        "urls": ["https://youtube.com/shorts/4"]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    deliverable: {
      caption: 'Full interior detail, start to finish, on a 2019 Tacoma.',
      file_ids: ['file_xxxxxxxxxxxxxx'],
      urls: ['https://youtube.com/shorts/4']
    }
  })
};

fetch('https://api.whop.com/api/v1/bounty_submissions/{id}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounty_submissions/{id}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'deliverable' => [
        'caption' => 'Full interior detail, start to finish, on a 2019 Tacoma.',
        'file_ids' => [
                'file_xxxxxxxxxxxxxx'
        ],
        'urls' => [
                'https://youtube.com/shorts/4'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/bounty_submissions/{id}/submit"

	payload := strings.NewReader("{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/bounty_submissions/{id}/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions/{id}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"deliverable\": {\n    \"caption\": \"Full interior detail, start to finish, on a 2019 Tacoma.\",\n    \"file_ids\": [\n      \"file_xxxxxxxxxxxxxx\"\n    ],\n    \"urls\": [\n      \"https://youtube.com/shorts/4\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "bounty_id": "bnty_xxxxxxxxxxxxxx",
  "capture_clips": null,
  "capture_filename": "US_Austin_BurnetRd_Bay2_mwebb",
  "captured_clip_count": 0,
  "captured_duration_seconds": 0,
  "city": "Austin",
  "claimed_at": "2026-01-01T12:00:00.000Z",
  "content": "Ceramic coating reveal, shot at the Burnet Rd bay",
  "country": "US",
  "created_at": "2026-01-01T12:00:00.000Z",
  "deliverable_type": "media",
  "deliverable_urls": [
    "https://tiktok.com/@shinetime/video/1"
  ],
  "denial_reason": "The clip never shows the finished paint.",
  "device": "iPhone 15 Pro",
  "files": [
    {
      "attachment_type": "image",
      "content_type": "image/png",
      "filename": "ceramic-coating-cut.png",
      "id": "file_xxxxxxxxxxxxxx",
      "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  ],
  "fov": 120,
  "id": "btys_xxxxxxxxxxxxxx",
  "latest_proof_livestream_feed": {
    "ended_at": "2026-01-01T12:00:00.000Z",
    "id": "lfeed_1",
    "recording_status": "completed",
    "recording_url": "https://whop-assets-example.s3.amazonaws.com/uploads/video/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "started_at": "2026-01-01T12:00:00.000Z",
    "thumbnail_url": "https://img.whop.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxx/resize:fit/width:1000/height:500/plain/https://cdn.whop.com/livestreams/paint-correction-proof-cover.jpg",
    "title": "Untitled Livestream"
  },
  "operator": "mwebb",
  "resolved_at": "2026-01-01T12:00:00.000Z",
  "site": "BurnetRd",
  "station": "Bay2",
  "status": "submitted",
  "submitted_at": "2026-01-01T12:00:00.000Z",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "worker": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

A user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Idempotency-Key

string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255

Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-10-29-8"

Path Parameters

string

required

The claimed attempt to submit for review (btys_ tag).

Body

application/json

deliverable

object | null

Work to attach to a livestream attempt. Combine urls, file_ids, and caption freely; all are optional. If the attempt already went to review when its stream ended, the deliverable attaches to it once, until reviewers start voting. Data capture attempts take no deliverable.

Show child attributes

Response

attempt submitted for review

bounty_id

string

required

The bounty the work was submitted to, prefixed bnty_.

Example:

"bnty_xxxxxxxxxxxxxx"

capture_clips

object[] | null

required

Show child attributes

Example:

null

capture_filename

string | null

required

The vendor filename stem Country_City_Site_Station_Operator, derived from the capture metadata. null until every component is present.

Example:

"US_Austin_BurnetRd_Bay2_mwebb"

captured_clip_count

integer

required

Number of verified capture clips accepted for this submission so far. 0 for submissions whose deliverable doesn't accumulate clips.

Example:

0

captured_duration_seconds

integer

required

Total verified duration of accepted capture clips, in whole seconds. 0 for submissions whose deliverable doesn't accumulate clips.

Example:

0

city

string | null

required

Capture metadata: city the footage was recorded in. null unless capture metadata was provided.

Example:

"Austin"

claimed_at

string | null

required

When the worker claimed the submission, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

content

string | null

required

Written proof the worker submitted with their work.

Example:

"Ceramic coating reveal, shot at the Burnet Rd bay"

country

string | null

required

Capture metadata: country the footage was recorded in. null unless capture metadata was provided.

Example:

"US"

created_at

string

required

When the submission was created, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

deliverable_type

enum<string> | null

required

How the work arrived when it came in through the API in one shot, informational only — read the work from deliverable_urls, files, and capture_clips directly. null for submissions whose proof is a livestream recording, including ones that attached links or files on submit.

Available options:

content_url,

media,

data_capture,

null

Example:

"media"

deliverable_urls

string[] | null

required

Links submitted as work, followed by temporary download URLs for the uploaded files. null when the submission carries neither.

denial_reason

string | null

required

Why the submission was denied, when a presentable reason exists. Always null unless status is denied.

Example:

"The clip never shows the finished paint."

device

string | null

required

Capture metadata: device the footage was recorded on. null unless capture metadata was provided.

Example:

"iPhone 15 Pro"

files

object[]

required

Show child attributes

fov

integer | null

required

Capture metadata: horizontal field of view in degrees. null when not reported.

Example:

120

string

required

Submission ID, prefixed btys_.

Example:

"btys_xxxxxxxxxxxxxx"

latest_proof_livestream_feed

object | null

required

Latest public proof livestream attached to the submission.

Show child attributes

operator

string | null

required

Capture metadata: identifier of the person who recorded the footage. null unless capture metadata was provided.

Example:

"mwebb"

resolved_at

string | null

required

When the submission was approved or denied, as an ISO 8601 timestamp. null until then.

Example:

"2026-01-01T12:00:00.000Z"

site

string | null

required

Capture metadata: site or venue the footage was recorded at. null unless capture metadata was provided.

Example:

"BurnetRd"

station

string | null

required

Capture metadata: station or position within the site. null unless capture metadata was provided.

Example:

"Bay2"

status

enum<string> | null

required

Lifecycle state. in_progress submissions are active attempts that have not submitted proof yet; submitted submissions await review; approved submissions were accepted and paid; denied submissions were rejected. null when the attempt ended without proof, taking it out of the public lifecycle — those attempts are absent from every public list and read.

Available options:

in_progress,

submitted,

approved,

denied,

null

Example:

"submitted"

submitted_at

string | null

required

When proof was submitted for review, as an ISO 8601 timestamp. null while the attempt is in progress.

Example:

"2026-01-01T12:00:00.000Z"

updated_at

string

required

When the submission was last updated, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

worker

object

required

User who submitted the work.

Show child attributes

Introduction

Reference

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Communication

Partners

Workforce

Media

Developer

Submit Bounty Submission

Authorizations

Headers

Path Parameters

Body

Response