Skip to main content
GET
List media

Authorizations

X-Api-Key
string
header
required

API key created in the web app under API keys. Expired or disabled keys are rejected with 401.

Path Parameters

page
integer<int64>
required

Zero-based page number.

Required range: x >= 0

Query Parameters

size
integer<int64>

Page size; must be ≥ 1. The default depends on the endpoint.

Required range: x <= 1000
startDate
string

Return items uploaded on or after this date (YYYY-MM-DD). Invalid dates are ignored.

endDate
string

Return items created at or before this instant. A bare YYYY-MM-DD means 00:00 UTC, so it excludes that day; pass the next day or a full timestamp. Invalid dates are ignored.

name
string

Case-insensitive substring match on the scan name or original file name.

mediaType
enum<string>[]

Return only items of these media types.

Available options:
audio,
video,
image,
text
tags
string[]

Return only items carrying these tags.

origin
string[]

API key names or redacted keys. Use webUploaded/socialLink for non-API submissions. Combined with those filters using OR.

webUploaded
boolean

When true, include items not submitted with an API key and not from a social link. false has no effect.

When true, include social-link items not submitted with an API key. false has no effect.

userIds
string[]

Return only media from these users in the caller's organization. Honored for organization owners, admins and viewers (pass [] for all members); ignored for other roles, who always get their own media.

sortBy
enum<string>

Field to sort by. name sorts by scan name. Default createdAt.

Available options:
name,
createdAt
sortDirection
enum<string>

Sort direction. Default DESC.

Available options:
ASC,
DESC
manipulation
enum<string>[]

AUTHENTIC/SUSPICIOUS/MANIPULATED filter on overall score 1–44/45–55/56–100. NONE returns NOT_APPLICABLE, UNABLE_TO_EVALUATE and DOWNLOAD_FAILED.

Available options:
AUTHENTIC,
SUSPICIOUS,
MANIPULATED,
NONE

Response

A page of the caller's media

totalItems
number
required

Total number of items matching the filters.

mediaList
object[]
required

Items of this page, each shaped like the media detail response.

totalPages
number
required

Total number of pages.

currentPage
number
required

Zero-based number of this page.

currentPageItemsCount
number
required

Number of items in this page.