Skip to main content
Fetch Collection Entities
Returns a paginated list of entities saved in the specified collection. The collection must belong to the authenticated user.

Path Parameters

string
required
The ID of the collection to fetch entities from.

Query Parameters

number
Page number (1-indexed). Default: 1.
number
Number of entities per page. Default: 20.
"new" | "top" | "hot" | "added"
Sort mode. Default: "new".
  • new — by when the entity was created
  • added — by when the entity was saved to this collection
  • top — by upvote count
  • hot — by computed engagement score (decays over time)
The whole collection is sorted before it is paginated. Ties in top and hot are broken by newest entity first.
"asc" | "desc"
Sort direction. Default: "desc".
string
Comma-separated list of associations to include:
  • user — the author’s user profile
  • space — the space the entity belongs to
  • topComment — the highest-voted comment
  • files — uploaded file/image attachments
  • grants — the reputation-grant summary for the entity
saved is not needed here: every entity returned by this endpoint already has isSaved: true.

Response

Entity[]
The page of entity objects. Each entity includes isSaved: true.
object
Pagination metadata.

Error Responses