Skip to main content
GET
List video submissions

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Query Parameters

status
enum<string>

Filter by review status. Unrecognized values are ignored.

Available options:
pending,
approved,
rejected,
revisions_requested,
library
contractId
string

Filter to a single contract id (access is verified).

creatorId
string

Filter to a single creator id.

programId
string

Filter to a single program/campaign id.

agencyId
string

Filter to a single agency id (access is verified).

reviewableOnly
string

Set to the literal string 'true' to return only submissions awaiting company review (compared with === 'true'; any other value is treated as false).

countOnly
string

Set to the literal string 'true' to return only the matching count, not the rows (compared with === 'true'; any other value is treated as false).

Free-text search query (lowercased and trimmed; matched against caption/notes in memory).

orderBy
enum<string>
default:submittedAt

Field to sort by. Unrecognized values fall back to 'submittedAt'.

Available options:
submittedAt,
reviewedAt,
updatedAt,
creatorName
orderDirection
enum<string>
default:desc

Sort direction. Unrecognized values fall back to 'desc'.

Available options:
asc,
desc
startAfter
string

Pagination cursor (the nextCursor / submission id from a previous page).

limit
integer
default:20

Max rows to return (1-100, default 20).

Required range: 1 <= x <= 100

Response

Matching video submissions (or, when countOnly=true, just the count).

data
object
required

Result payload for the list endpoint. When countOnly is requested, only success and count are present; otherwise submissions and pagination are present.