Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-20"

Path Parameters

bounty_submission_id
string
required

The bounty submission to act on (btys_ tag).

Response

bounty submission returned

bounty_id
string
required

The bounty the work was submitted to, prefixed bnty_.

capture_clips
object[] | null
required
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

Which of the bounty's accepted_deliverable_types this submission used. Branch on it to read the work: content_url and media carry deliverable_urls; data_capture carries capture_clips. null on submissions authored before deliverable types existed.

Available options:
content_url,
media,
data_capture,
null
Example:

"content_url"

deliverable_urls
string[] | null
required

The submitted work as URLs: the posted content links for content_url deliverables, or temporary download URLs for the uploaded files of media deliverables. null for data_capture submissions, whose deliverable is capture_clips.

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.

fov
integer | null
required

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

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