Skip to main content
GET
List Generic Assets

Authorizations

X-River-Key-Id
string
header
required

UUID of your API key (from Settings → API Keys).

X-River-Timestamp
string
header
required

Current unix milliseconds (unix seconds also accepted). Must be within 30s of server time.

X-River-Signature
string
header
required

Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.

X-River-Org-Id
string
header
required

Your organization id (from GET /v1/rate-limit). Signed requests are rate limited per organization on this header; a missing or wrong value is refused with 403.

Query Parameters

q
string | null

Search name, description, series and team names

Minimum string length: 1
category
string[] | null

Filter by category. Repeat to filter to multiple categories.

subcategory
string | null

Filter by subcategory

owner
string | null

'me' for own baskets only, 'platform' for public only

status
string
default:approved

'approved' (default), 'expired', 'pending', 'rejected' or 'all'

start_after
string<date-time> | null

Event start at or after (UTC)

start_before
string<date-time> | null

Event start before (UTC)

sort_by
string | null

start-time (default), ending-soon, volume, trending

event_limit
integer | null

Paginate by event (game): return this many events with all their assets, members inline, and total_events. Max 200, or 2000 with a start window. Omit for the flat, unpaginated list (no members).

Required range: x >= 1
event_offset
integer
default:0

Event offset for event pagination

Required range: x >= 0
assets_per_event
integer | null

Cap assets returned per event

Required range: x >= 1

Response

Successful Response

assets
GenericAssetResponse · object[]
required
total_events
integer | null

Total event groups matching the filters (event-paginated requests only)

subcategories
SubcategoryCount · object[]

Event counts per subcategory for the chip row (event-paginated requests only)