Skip to main content
GET
Retrieve Public Submission

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-13"

Path Parameters

bounty_id
string
required

The bounty the submission belongs to (bnty_ tag).

id
string
required

The submission to retrieve (btys_ tag).

Response

public bounty submission returned

bounty_id
string
required

The bounty the work was submitted to, prefixed bnty_.

Example:

"bnty_xxxxxxxxxxxxxx"

claimed_at
string | null
required

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

Example:

"2026-01-01T12:00:00.000Z"

created_at
string
required

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

Example:

"2026-01-01T12:00:00.000Z"

denial_reason
string | null
required

Why the submission was denied, when a presentable reason exists. Always null unless status is denied.

Example:

"The wheels were never shown in the finished clip."

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.

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"

status
enum<string>
required

Lifecycle state. submitted submissions await review; approved submissions were accepted and paid; denied submissions were rejected. In-progress attempts never appear on the public list.

Available options:
submitted,
approved,
denied
Example:

"approved"

submitted_at
string | null
required

When proof was submitted for review, as an ISO 8601 timestamp.

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.