List books

POST /api/v1/books/list

List books

cURL

curl --request POST \
  --url https://demo.komga.org/api/v1/books/list \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "condition": {
    "allOf": [
      {
        "anyOf": "<array>"
      }
    ]
  },
  "fullTextSearch": "<string>"
}
'

200

{
  "content": [
    {
      "created": "2023-11-07T05:31:56Z",
      "deleted": true,
      "fileHash": "<string>",
      "fileLastModified": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "lastModified": "2023-11-07T05:31:56Z",
      "libraryId": "<string>",
      "media": {
        "comment": "<string>",
        "epubDivinaCompatible": true,
        "epubIsKepub": true,
        "mediaProfile": "<string>",
        "mediaType": "<string>",
        "pagesCount": 123,
        "status": "<string>"
      },
      "metadata": {
        "authors": [
          {
            "name": "<string>",
            "role": "<string>"
          }
        ],
        "authorsLock": true,
        "created": "2023-11-07T05:31:56Z",
        "isbn": "<string>",
        "isbnLock": true,
        "lastModified": "2023-11-07T05:31:56Z",
        "links": [
          {
            "label": "<string>",
            "url": "<string>"
          }
        ],
        "linksLock": true,
        "number": "<string>",
        "numberLock": true,
        "numberSort": 123,
        "numberSortLock": true,
        "releaseDateLock": true,
        "summary": "<string>",
        "summaryLock": true,
        "tags": [
          "<string>"
        ],
        "tagsLock": true,
        "title": "<string>",
        "titleLock": true,
        "releaseDate": "2023-12-25"
      },
      "name": "<string>",
      "number": 123,
      "oneshot": true,
      "seriesId": "<string>",
      "seriesTitle": "<string>",
      "size": "<string>",
      "sizeBytes": 123,
      "url": "<string>"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 123,
  "numberOfElements": 123,
  "pageable": {
    "offset": 123,
    "pageNumber": 123,
    "pageSize": 123,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 123,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 123,
  "totalPages": 123
}

Authorizations

basicAuthapiKey

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

unpaged · boolean

page · integer

Zero-based page index (0..N)

size · integer

The size of the page to be returned

sort · string[]

Sorting criteria in the format: property(,asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Body

application/json

condition · object

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Show child attributes

fullTextSearch · string

Response

200

application/json

OK

content · object[]

Show child attributes

empty · boolean

first · boolean

last · boolean

number · integer<int32>

numberOfElements · integer<int32>

pageable · object

Show child attributes

size · integer<int32>

sort · object

Show child attributes

totalElements · integer<int64>

totalPages · integer<int32>