ListSeriesDuplicatesResponse

Response for listing series duplicates.

duplicates object[]required

List of duplicate groups

Array [

createdAtstringrequired

When the duplicate was first detected

Example: 2026-05-20T10:30:00Z

duplicateCountinteger<int32>required

Number of series in the group at detection time. members.len() may be smaller if a member has been deleted between scan and read.

Example: 2

idstring<uuid>required

Unique identifier for the duplicate group

Example: 550e8400-e29b-41d4-a716-446655440000

libraryIdstring,null<uuid>nullable

Library this group is scoped to. Null for external_id matches.

matchKeystringrequired

For external_id matches: "

:<external_id>" e.g. "plugin:mangabaka:12345". For title matches: the normalized search title (e.g. "naruto").

Example: plugin:mangabaka:12345

matchTypestringrequired

external_id or title

Example: external_id

members object[]required

Hydrated details for each series in the group, in the same order the detector emitted them. May be shorter than duplicate_count if a member series has since been deleted.

Array [

bookCountinteger<int64>required

Number of (non-deleted) books in the series.

Example: 63

idstring<uuid>required

Series UUID.

libraryIdstring<uuid>required

Library this series belongs to.

libraryNamestringrequired

Library display name.

Example: Manga

titlestringrequired

Display title, falling back to series.name when no metadata exists.

Example: Fairy Tail

updatedAtstringrequired

Series row's last-updated timestamp.

Example: 2026-02-15T00:00:00Z

]

updatedAtstringrequired

When the group was last updated

Example: 2026-05-20T10:30:00Z

]

externalIdGroupsintegerrequired

Number of groups matched by external ID (high confidence).

Possible values: >= 0

Example: 1

titleGroupsintegerrequired

Number of groups matched by normalized title (lower confidence).

Possible values: >= 0

Example: 2

totalDuplicateSeriesintegerrequired

Total number of series that participate in any duplicate group.

Possible values: >= 0

Example: 8

totalGroupsintegerrequired

Total number of duplicate groups (across both match types).

Possible values: >= 0

Example: 3

ListSeriesDuplicatesResponse

{
  "duplicates": [
    {
      "createdAt": "2026-05-20T10:30:00Z",
      "duplicateCount": 2,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "libraryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "matchKey": "plugin:mangabaka:12345",
      "matchType": "external_id",
      "members": [
        {
          "bookCount": 63,
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "libraryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "libraryName": "Manga",
          "title": "Fairy Tail",
          "updatedAt": "2026-02-15T00:00:00Z"
        }
      ],
      "updatedAt": "2026-05-20T10:30:00Z"
    }
  ],
  "externalIdGroups": 1,
  "titleGroups": 2,
  "totalDuplicateSeries": 8,
  "totalGroups": 3
}