Skip to main content

PaginatedResponse_ReleaseLedgerEntryDto

Generic paginated response wrapper with HATEOAS links

data object[]required

The data items for this page

  • Array [
  • chapternumber,null<double>nullable

    Decimal supports 12.5 etc.

    confidencenumber<double>required
    createdAtstring<date-time>required
    externalReleaseIdstringrequired

    Plugin-stable identity for the release (used for dedup).

    Example: nyaa:1234567
    formatHints

    Sparse { "jxl": true, "container": "cbz", ... }.

    groupOrUploaderstring | nullnullable

    Group/scanlator/uploader attribution.

    idstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440a00
    infoHashstring | nullnullable

    Torrent info_hash, if applicable.

    languagestring | nullnullable
    mediaUrlstring | nullnullable

    Optional second URL for direct fetch (.torrent, magnet:, DDL link). Travels paired with [Self::media_url_kind].

    mediaUrlKindstring | nullnullable

    Classifies what media_url points at: torrent | magnet | direct | other. The frontend uses this to pick a kind-specific icon next to the standard external-link icon.

    metadata

    Source-specific extras (free-form).

    observedAtstring<date-time>required
    payloadUrlstringrequired

    Where to acquire the release. Conventionally a human-readable landing page (Nyaa view page, MangaUpdates release page).

    seriesIdstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440002
    seriesTitlestringrequired

    Series title at the time of the response. Joined from the series table so the inbox UI can render a human-readable label without a follow-up fetch. Falls back to the empty string only if the series row was hard-deleted between the join and the read.

    Example: Chainsaw Man
    sourceIdstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440b00
    statestringrequired

    announced | dismissed | marked_acquired | hidden.

    volumeinteger,null<int32>nullable
  • ]
  • links objectrequired

    HATEOAS navigation links

    firststringrequired

    Link to the first page

    laststringrequired

    Link to the last page

    nextstring | nullnullable

    Link to the next page (null if on last page)

    prevstring | nullnullable

    Link to the previous page (null if on first page)

    selfstringrequired

    Link to the current page

    pageinteger<int64>required

    Current page number (1-indexed)

    Possible values: >= 0

    Example: 1
    pageSizeinteger<int64>required

    Number of items per page

    Possible values: >= 0

    Example: 50
    totalinteger<int64>required

    Total number of items across all pages

    Possible values: >= 0

    Example: 150
    totalPagesinteger<int64>required

    Total number of pages

    Possible values: >= 0

    Example: 3
    PaginatedResponse_ReleaseLedgerEntryDto
    {
    "data": [
    {
    "chapter": 0,
    "confidence": 0,
    "createdAt": "2024-07-29T15:51:28.071Z",
    "externalReleaseId": "nyaa:1234567",
    "groupOrUploader": "string",
    "id": "550e8400-e29b-41d4-a716-446655440a00",
    "infoHash": "string",
    "language": "string",
    "mediaUrl": "string",
    "mediaUrlKind": "string",
    "observedAt": "2024-07-29T15:51:28.071Z",
    "payloadUrl": "string",
    "seriesId": "550e8400-e29b-41d4-a716-446655440002",
    "seriesTitle": "Chainsaw Man",
    "sourceId": "550e8400-e29b-41d4-a716-446655440b00",
    "state": "string",
    "volume": 0
    }
    ],
    "links": {
    "first": "string",
    "last": "string",
    "next": "string",
    "prev": "string",
    "self": "string"
    },
    "page": 1,
    "pageSize": 50,
    "total": 150,
    "totalPages": 3
    }