Retrieve Bounty Submission

Retrieves one bounty submission the credential can see — one the caller authored, or one on a bounty they posted or their account owns. Reading another member’s work on an account’s bounty takes account_id, the same way the list does.

GET /bounty_submissions/{id}

JavaScript

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.retrieve('id');

console.log(bountySubmission.id);

200

{
  "bounty_id": "bnty_xxxxxxxxxxxxxx",
  "capture_clips": [
    {
      "bounty_submission_id": "btys_xxxxxxxxxxxxxx",
      "created_at": "2026-01-01T12:00:00.000Z",
      "duration_seconds": 180,
      "failure_code": "upload_failed",
      "failure_message": "video: The video upload failed after 5 retries.",
      "frames_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "id": "bclip_xxxxxxxxxxxxxx",
      "imu_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "manifest_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "ready_at": "2026-01-01T12:00:00.000Z",
      "sequence": 1,
      "status": "ready",
      "updated_at": "2026-01-01T12:00:00.000Z",
      "video_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  ],
  "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_3",
    "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"
  }
}

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

Api-Version-Date · string

Pins the request to a dated API version.

Example:

"2026-08-21"

Path Parameters

id · string · required

The bounty submission to act on (btys_ tag).

Query Parameters

account_id · string

Read the submission as this account (biz_ tag), scoping the lookup to its bounties rather than the caller's own work. Requires read access to the account. Without it the lookup covers only what the credential owns — the submissions the caller authored plus those on bounties they posted.

Response

200

application/json

bounty submission returned

bounty_id · string · required

The bounty the work was submitted to, prefixed bnty_.

Example:

"bnty_xxxxxxxxxxxxxx"

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.

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

id · 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