Skip to main content

WantToReadListResponse

A user's want-to-read queue.

items object[]required

Queue entries.

  • Array [
  • addedAtstring<date-time>required

    When the entry was added to the queue.

    Example: 2026-06-15T18:45:00Z
    bookIdstring,null<uuid>nullable

    The flagged book (set when item_type is book).

    idstring<uuid>required

    Queue entry ID.

    Example: 550e8400-e29b-41d4-a716-446655440000
    itemTypeWantToReadItemType (string)required

    Whether this entry flags a series or a book.

    Possible values: [series, book]

    seriesIdstring,null<uuid>nullable

    The flagged series (set when item_type is series).

  • ]
  • totalintegerrequired

    Total number of entries.

    Possible values: >= 0

    Example: 7
    WantToReadListResponse
    {
    "items": [
    {
    "addedAt": "2026-06-15T18:45:00Z",
    "bookId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "itemType": "series",
    "seriesId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
    ],
    "total": 7
    }