JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const bountySubmission = await client.bountySubmissions.submit('bounty_submission_id');

console.log(bountySubmission.id);

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_id}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deliverable": {
    "caption": "<string>",
    "file_ids": [
      "<string>"
    ],
    "urls": [
      "<string>"
    ]
  }
}
'

import requests

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

payload = { "deliverable": {
        "caption": "<string>",
        "file_ids": ["<string>"],
        "urls": ["<string>"]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_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' => '<string>',
        'file_ids' => [
                '<string>'
        ],
        'urls' => [
                '<string>'
        ]
    ]
  ]),
  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/{bounty_submission_id}/submit"

	payload := strings.NewReader("{\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\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/{bounty_submission_id}/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_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\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  }\n}"

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

{
  "bounty_id": "<string>",
  "capture_clips": [
    {
      "bounty_submission_id": "<string>",
      "created_at": "<string>",
      "duration_seconds": 123,
      "failure_code": "<string>",
      "failure_message": "<string>",
      "frames_url": "<string>",
      "id": "<string>",
      "imu_url": "<string>",
      "manifest_url": "<string>",
      "ready_at": "<string>",
      "sequence": 123,
      "status": "recording",
      "updated_at": "<string>",
      "video_url": "<string>"
    }
  ],
  "capture_filename": "<string>",
  "captured_clip_count": 123,
  "captured_duration_seconds": 123,
  "city": "<string>",
  "claimed_at": "<string>",
  "content": "<string>",
  "country": "<string>",
  "created_at": "<string>",
  "deliverable_type": "content_url",
  "deliverable_urls": [
    "<string>"
  ],
  "denial_reason": "<string>",
  "device": "<string>",
  "files": [
    {
      "attachment_type": "image",
      "content_type": "<string>",
      "filename": "<string>",
      "id": "<string>",
      "url": "<string>"
    }
  ],
  "fov": 123,
  "id": "<string>",
  "latest_proof_livestream_feed": {
    "id": "<string>",
    "recording_status": "recording",
    "recording_url": "<string>",
    "thumbnail_url": "<string>",
    "title": "<string>"
  },
  "operator": "<string>",
  "resolved_at": "<string>",
  "site": "<string>",
  "station": "<string>",
  "status": "in_progress",
  "submitted_at": "<string>",
  "updated_at": "<string>",
  "worker": {
    "id": "<string>",
    "name": "<string>",
    "profile_picture": {
      "url": "<string>"
    },
    "username": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Bounty Submissions

Submit Bounty Submission

Submits a claimed attempt for review. A livestream attempt needs an ended proof stream and can attach an optional deliverable — links, files, and a caption in any combination; if the attempt already went to review when its stream ended, the payload attaches to it once, until reviewers start voting. A data capture attempt instead needs enough validated clip time and takes no payload. Only the worker who started the attempt can submit it — account API keys cannot.

POST

bounty_submissions

{bounty_submission_id}

submit

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const bountySubmission = await client.bountySubmissions.submit('bounty_submission_id');

console.log(bountySubmission.id);

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_id}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deliverable": {
    "caption": "<string>",
    "file_ids": [
      "<string>"
    ],
    "urls": [
      "<string>"
    ]
  }
}
'

import requests

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

payload = { "deliverable": {
        "caption": "<string>",
        "file_ids": ["<string>"],
        "urls": ["<string>"]
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_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' => '<string>',
        'file_ids' => [
                '<string>'
        ],
        'urls' => [
                '<string>'
        ]
    ]
  ]),
  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/{bounty_submission_id}/submit"

	payload := strings.NewReader("{\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\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/{bounty_submission_id}/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions/{bounty_submission_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\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  }\n}"

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

{
  "bounty_id": "<string>",
  "capture_clips": [
    {
      "bounty_submission_id": "<string>",
      "created_at": "<string>",
      "duration_seconds": 123,
      "failure_code": "<string>",
      "failure_message": "<string>",
      "frames_url": "<string>",
      "id": "<string>",
      "imu_url": "<string>",
      "manifest_url": "<string>",
      "ready_at": "<string>",
      "sequence": 123,
      "status": "recording",
      "updated_at": "<string>",
      "video_url": "<string>"
    }
  ],
  "capture_filename": "<string>",
  "captured_clip_count": 123,
  "captured_duration_seconds": 123,
  "city": "<string>",
  "claimed_at": "<string>",
  "content": "<string>",
  "country": "<string>",
  "created_at": "<string>",
  "deliverable_type": "content_url",
  "deliverable_urls": [
    "<string>"
  ],
  "denial_reason": "<string>",
  "device": "<string>",
  "files": [
    {
      "attachment_type": "image",
      "content_type": "<string>",
      "filename": "<string>",
      "id": "<string>",
      "url": "<string>"
    }
  ],
  "fov": 123,
  "id": "<string>",
  "latest_proof_livestream_feed": {
    "id": "<string>",
    "recording_status": "recording",
    "recording_url": "<string>",
    "thumbnail_url": "<string>",
    "title": "<string>"
  },
  "operator": "<string>",
  "resolved_at": "<string>",
  "site": "<string>",
  "station": "<string>",
  "status": "in_progress",
  "submitted_at": "<string>",
  "updated_at": "<string>",
  "worker": {
    "id": "<string>",
    "name": "<string>",
    "profile_picture": {
      "url": "<string>"
    },
    "username": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

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-08-05-1"

Path Parameters

bounty_submission_id

string

required

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

Body

application/json

deliverable

object | null

Work to attach to the submission. Combine urls, file_ids, and caption freely; all are optional.

Show child attributes

Response

attempt submitted for review

bounty_id

string

required

The bounty the work was submitted to, prefixed bnty_.

capture_clips

object[] | null

required

Show child attributes

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.

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.

captured_duration_seconds

integer

required

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

city

string | null

required

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

claimed_at

string | null

required

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

content

string | null

required

Written proof the worker submitted with their work.

country

string | null

required

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

created_at

string

required

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

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:

"content_url"

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.

device

string | null

required

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

files

object[]

required

Show child attributes

fov

integer | null

required

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

string

required

Submission ID, prefixed btys_.

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.

resolved_at

string | null

required

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

site

string | null

required

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

station

string | null

required

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

status

enum<string>

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.

Available options:

in_progress,

submitted,

approved,

denied

Example:

"in_progress"

submitted_at

string | null

required

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

updated_at

string

required

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

worker

object

required

User who submitted the work.

Show child attributes

⌘I

Introduction

Reference

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Submit Bounty Submission

Authorizations

Headers

Path Parameters

Body

Response