Skip to main content
GET
Get a submission

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaign_id
string<uuid>
required

The campaign ID

submission_id
string<uuid>
required

The submission ID

Response

The submission

Content a creator submitted for review before posting

id
string<uuid>
creator_id
string
Example:

"cr_8f14e45fceea"

creator_username
string
Example:

"somecreator"

task_id
string<uuid>
status
enum<string>

in_review: waiting on your decision (a rejected submission returns here when the creator submits a revision). approved: cleared to post. rejected: you sent it back for changes. failed: automatic validation or processing failed — see failure_reason. post_deleted: the content was posted and later taken down.

Available options:
in_review,
approved,
rejected,
failed,
post_deleted
Example:

"in_review"

media_type
enum<string>
Available options:
video,
carousel
Example:

"video"

media_url
string<uri> | null

URL of the submitted video, or the first image of a carousel

thumbnail_url
string<uri> | null
revision_count
integer

How many times the creator has re-submitted this content after a rejection. 0 for an initial submission that has never been sent back.

Example:

1

feedback
string | null

The most recent rejection feedback sent to the creator, if any

failure_reason
string | null

When status is failed, a short explanation of what went wrong (e.g. media could not be processed, or the required post could not be verified). Null for every other status.

submitted_at
string<date-time> | null
reviewed_at
string<date-time> | null
created_at
string<date-time>
updated_at
string<date-time>