Skip to main content
GET
List media (first page)

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.

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.

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

First page of the caller's media (size defaults to 15)

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.