Skip to content

List library books

GET
/api/library

Paginated list of organized books with optional search and filtering

Parameters

Query Parameters

page
Type
integer
Default
1
limit
Type
integer
Default
20
Maximum
100
author

Filter by author (partial match)

Type
string
genre

Filter by genre (exact, case-insensitive)

Type
string
q

Full-text search across title, author, and description with typo tolerance

Type
string
sort

Sort order for results

Type
string
Valid values
"title_asc""title_desc""author_asc""author_desc""added_newest""added_oldest"
Default
"title_asc"

Responses

Paginated list of books with files

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"id": "string",
  
  
  
"status": "string",
  
  
  
"title": "string",
  
  
  
"author": "string",
  
  
  
"createdAt": "string",
  
  
  
"files": [
  
  
  
  
{
  
  
  
  
  
"id": "string",
  
  
  
  
  
"format": "string",
  
  
  
  
  
"originalName": "string",
  
  
  
  
  
"fileSize": "string"
  
  
  
  
}
  
  
  
]
  
  
}
  
],
  
"pagination": {
  
  
"page": 0,
  
  
"limit": 0,
  
  
"total": 0,
  
  
"totalPages": 0
  
}
}

Samples