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.
Authorizations
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
Pins the request to a dated API version.
"2026-08-05-1"
Path Parameters
The bounty submission to act on (btys_ tag).
Response
bounty submission returned
The bounty the work was submitted to, prefixed bnty_.
The vendor filename stem Country_City_Site_Station_Operator, derived from the capture metadata. null until every component is present.
Number of verified capture clips accepted for this submission so far. 0 for submissions whose deliverable doesn't accumulate clips.
Total verified duration of accepted capture clips, in whole seconds. 0 for submissions whose deliverable doesn't accumulate clips.
Capture metadata: city the footage was recorded in. null unless capture metadata was provided.
When the worker claimed the submission, as an ISO 8601 timestamp.
Written proof the worker submitted with their work.
Capture metadata: country the footage was recorded in. null unless capture metadata was provided.
When the submission was created, as an ISO 8601 timestamp.
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.
content_url, media, data_capture, null "content_url"
Links submitted as work, followed by temporary download URLs for the uploaded files. null when the submission carries neither.
Why the submission was denied, when a presentable reason exists. Always null unless status is denied.
Capture metadata: device the footage was recorded on. null unless capture metadata was provided.
Capture metadata: horizontal field of view in degrees. null when not reported.
Submission ID, prefixed btys_.
Latest public proof livestream attached to the submission.
Capture metadata: identifier of the person who recorded the footage. null unless capture metadata was provided.
When the submission was approved or denied, as an ISO 8601 timestamp. null until then.
Capture metadata: site or venue the footage was recorded at. null unless capture metadata was provided.
Capture metadata: station or position within the site. null unless capture metadata was provided.
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.
in_progress, submitted, approved, denied "in_progress"
When proof was submitted for review, as an ISO 8601 timestamp. null while the attempt is in progress.
When the submission was last updated, as an ISO 8601 timestamp.
User who submitted the work.

