List video submissions
List creator video submissions for the token tenant’s campaigns, filterable by status, contractId, or programId. Requires the video-submissions:read scope.
Authorizations
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
Filter by review status. Unrecognized values are ignored.
pending, approved, rejected, revisions_requested, library Filter to a single contract id (access is verified).
Filter to a single creator id.
Filter to a single program/campaign id.
Filter to a single agency id (access is verified).
Set to the literal string 'true' to return only submissions awaiting company review (compared with === 'true'; any other value is treated as false).
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).
Field to sort by. Unrecognized values fall back to 'submittedAt'.
submittedAt, reviewedAt, updatedAt, creatorName Sort direction. Unrecognized values fall back to 'desc'.
asc, desc Pagination cursor (the nextCursor / submission id from a previous page).
Max rows to return (1-100, default 20).
1 <= x <= 100Response
Matching video submissions (or, when countOnly=true, just the count).
Result payload for the list endpoint. When countOnly is requested, only success and count are present; otherwise submissions and pagination are present.