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.create({ bounty_id: 'bounty_id' });

console.log(bountySubmission.id);

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bounty_id": "<string>",
  "affiliate_code": "<string>",
  "deliverable": {
    "caption": "<string>",
    "file_ids": [
      "<string>"
    ],
    "urls": [
      "<string>"
    ]
  },
  "metadata": {
    "city": "<string>",
    "country": "<string>",
    "device": "<string>",
    "fov": 123,
    "operator": "<string>",
    "site": "<string>",
    "station": "<string>"
  }
}
'

import requests

url = "https://api.whop.com/api/v1/bounty_submissions"

payload = {
    "bounty_id": "<string>",
    "affiliate_code": "<string>",
    "deliverable": {
        "caption": "<string>",
        "file_ids": ["<string>"],
        "urls": ["<string>"]
    },
    "metadata": {
        "city": "<string>",
        "country": "<string>",
        "device": "<string>",
        "fov": 123,
        "operator": "<string>",
        "site": "<string>",
        "station": "<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",
  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([
    'bounty_id' => '<string>',
    'affiliate_code' => '<string>',
    'deliverable' => [
        'caption' => '<string>',
        'file_ids' => [
                '<string>'
        ],
        'urls' => [
                '<string>'
        ]
    ],
    'metadata' => [
        'city' => '<string>',
        'country' => '<string>',
        'device' => '<string>',
        'fov' => 123,
        'operator' => '<string>',
        'site' => '<string>',
        'station' => '<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"

	payload := strings.NewReader("{\n  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions")

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  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\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>",
  "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>",
  "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>"
  }
}

Bounty Submissions

Create Bounty Submission

Creates a submission on a workforce bounty. Include a deliverable payload — any combination of links and uploaded files, with at least one of the two — and the submission goes straight to review; create is the only step. For data_capture bounties, omit the deliverable: this starts a claimed attempt whose proof accumulates server-side, and the separate submit endpoint sends it to review once complete. Requires a user credential — account API keys cannot author submissions.

POST

bounty_submissions

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.create({ bounty_id: 'bounty_id' });

console.log(bountySubmission.id);

curl --request POST \
  --url https://api.whop.com/api/v1/bounty_submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bounty_id": "<string>",
  "affiliate_code": "<string>",
  "deliverable": {
    "caption": "<string>",
    "file_ids": [
      "<string>"
    ],
    "urls": [
      "<string>"
    ]
  },
  "metadata": {
    "city": "<string>",
    "country": "<string>",
    "device": "<string>",
    "fov": 123,
    "operator": "<string>",
    "site": "<string>",
    "station": "<string>"
  }
}
'

import requests

url = "https://api.whop.com/api/v1/bounty_submissions"

payload = {
    "bounty_id": "<string>",
    "affiliate_code": "<string>",
    "deliverable": {
        "caption": "<string>",
        "file_ids": ["<string>"],
        "urls": ["<string>"]
    },
    "metadata": {
        "city": "<string>",
        "country": "<string>",
        "device": "<string>",
        "fov": 123,
        "operator": "<string>",
        "site": "<string>",
        "station": "<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",
  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([
    'bounty_id' => '<string>',
    'affiliate_code' => '<string>',
    'deliverable' => [
        'caption' => '<string>',
        'file_ids' => [
                '<string>'
        ],
        'urls' => [
                '<string>'
        ]
    ],
    'metadata' => [
        'city' => '<string>',
        'country' => '<string>',
        'device' => '<string>',
        'fov' => 123,
        'operator' => '<string>',
        'site' => '<string>',
        'station' => '<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"

	payload := strings.NewReader("{\n  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/bounty_submissions")

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  \"bounty_id\": \"<string>\",\n  \"affiliate_code\": \"<string>\",\n  \"deliverable\": {\n    \"caption\": \"<string>\",\n    \"file_ids\": [\n      \"<string>\"\n    ],\n    \"urls\": [\n      \"<string>\"\n    ]\n  },\n  \"metadata\": {\n    \"city\": \"<string>\",\n    \"country\": \"<string>\",\n    \"device\": \"<string>\",\n    \"fov\": 123,\n    \"operator\": \"<string>\",\n    \"site\": \"<string>\",\n    \"station\": \"<string>\"\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>",
  "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>",
  "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>"
  }
}

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"

Body

application/json

bounty_id

string

required

The bounty to submit to (bnty_ tag).

affiliate_code

string | null

Affiliate code crediting the referrer, when the worker arrived through one.

deliverable

object | null

The submitted work. Combine urls, file_ids, and caption freely; at least one link or file is required.

Show child attributes

metadata

object | null

Optional capture metadata describing where and how the footage was recorded. Persisted on the submission. On a data_capture bounty every field except fov is required whenever metadata is provided.

Show child attributes

Response

submission created with an inline deliverable

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.

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

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

Create Bounty Submission

Authorizations

Headers

Body

Response