Query Parameters

• label – Filter by tournament label (substring match, matches anywhere in the label, max length: 255 characters)
• vkz – Filter by VKZ (prefix match, max length: 255 characters)
• fromDate – Minimum end date of the tournament (inclusive, ISO-8601 format, e.g. 2024-01-31)
• toDate – Maximum end date of the tournament (inclusive, ISO-8601 format, e.g. 2024-12-31)
• referentFirstname – Filter by referent first name (prefix match, matches main or additional referent, max length: 255 characters)
• referentLastname – Filter by referent last name (prefix match, matches main or additional referent, max length: 255 characters)
• processingState – Filter by processing state. Possible values: NEW, PROCESSING, DONE
• ratingState – Filter by rating state. Possible values: RATED or NOT_RATED
• location – Filter by location (prefix match, max length: 255 characters)
• limit – Maximum number of results to return. If omitted, all matching results are returned.
• offset – Zero-based index of the first result to return. Defaults to 0 if omitted.

Response

• 200 OK – Returns a PagedResponse containing DSBTournamentDTO objects matching the filters, along with pagination metadata (limit, offset, totalCount) and PageNavigationLinks (self, first, last, next, previous).
• 400 Bad Request – If limit or offset is negative, or fromDate is after toDate.
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

nuSport is regarded as the leading instance for all personal properties, except the LK. This endpoint shall be called for the totality of all NTDB persons in small batches of about 100 persons. If a pushed person isn't present in lk2020's players pool and that person has no fedRankOld (Einstufungs-LK), then this person is skipped. If a pushed person isn't present in lk2020's players pool and that person has a fedRankOld, then this person is added to the pool and the pushed LK is treated as initial LK starting from 01.10.2020. This behavior will be changed, as soon as the classic LK is fixed.

You shall use this endpoint for querying the currently valid LKs for a set of persons as well. In this case, persons shall be pushed with all properties never the less.

Query Parameters

• vkz – Filter by club number (VKZ). Supports partial prefix matching. Max length: 255 characters.
• clubName – Filter by club name. Supports partial prefix matching. Max length: 255 characters.
• federationName – Filter by federation name (Verband). Supports partial prefix matching. Max length: 255 characters.
• regionName – Filter by region name (übergeordneter Verband). Supports partial prefix matching. Max length: 255 characters.
• limit – Maximum number of results to return. If omitted, all matching results are returned.
• offset – Zero-based index of the first result to return. Defaults to 0 if omitted.
• includeArchived – If true, deleted clubs are included as well. Defaults to false, i.e. only non-deleted clubs are returned. Applies to this JSON endpoint only; the CSV export always returns non-deleted clubs exclusively.

Field Constraints

• All string-based fields are stored as VARCHAR(255)
• Maximum allowed length for string inputs: 255 characters

Response

• 200 OK – Returns a PagedResponse containing DSBClubDTO objects matching the filters, along with pagination metadata (limit, offset, totalCount) and PageNavigationLinks (self, first, last, next, previous). Each DSBClubDTO contains:
  • clubVkz – Club number (VKZ / Vereinskennziffer)
  • clubName – Name of the club
  • federation – VKZ of the federation (Verband) the club belongs to
  • parentFederation – VKZ of the parent federation (übergeordneter Verband)
  • state – State of the club (DELETE_STATE_FALSE or DELETE_STATE_TRUE)
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

Query Parameters

• federationName – Filter by federation name (prefix match, max length: 255 characters).
• limit – Maximum number of results to return. If omitted, all matching results are returned.
• offset – Zero-based index of the first result to return. Defaults to 0 if omitted.

Response

• 200 OK – Returns a PagedResponse containing DSBFederationDTO objects matching the filters, along with pagination metadata (limit, offset, totalCount) and PageNavigationLinks (self, first, last, next, previous). Each DSBFederationDTO contains:
  • federationNumber – VKZ of the federation
  • federation – Top-level federation identifier
  • parentFederation – VKZ of the immediate parent federation. null if no parent exists.
  • federationName – Name of the federation
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

A person is included if at least one of their current memberships (a membership without an until date) matches the membership-related filters (clubName, vkz, memberNo, regionName, federationName). Pagination (limit / offset) and totalCount operate on distinct persons, so every person appears once regardless of how many current memberships they have.

Query Parameters

• firstname – Filter by first name (max length: 255 characters)
• lastname – Filter by last name (max length: 255 characters)
• clubName – Filter by club name (max length: 255 characters)
• vkz – Filter by VKZ (prefix match, max length: 255 characters)
• memberNo – Filter by member number
• regionName – Filter by region name (max length: 255 characters)
• federationName – Filter by federation name (max length: 255 characters)
• minRating – Minimum DWZ rating (inclusive)
• maxRating – Maximum DWZ rating (inclusive)
• fideId – Filter by FIDE ID
• gender – Filter by gender (MALE or FEMALE); matches the value exposed in the gender field of each DSBPersonDTO.
• minAge – Minimum age (inclusive). Age is computed as the year of the current checkpoint's reference date minus the person's year of birth, so it only reflects the year of birth (consistent with the data exposed by this API). Persons without a known year of birth are excluded when an age filter is set.
• maxAge – Maximum age (inclusive). Same age definition as minAge.
• limit – Maximum number of results to return. Defaults to 1000 if omitted.
• offset – Zero-based index of the first result to return. Defaults to 0 if omitted.

Response

• 200 OK – Returns a PagedResponse containing DSBPersonDTO objects matching the filters, along with pagination metadata (limit, offset, totalCount) and PageNavigationLinks (self, first, last, next, previous). Each DSBPersonDTO includes weekOfLastTournamentEvaluation formatted as YYYYWW (e.g. 202503), indicating the ISO week of the most recent rated tournament the person participated in. null if no rated tournament exists. Each DSBPersonDTO also includes a memberships array holding all current club memberships of the person. Each entry contains:
  • vkz – VKZ (Vereinskennzeichen) of the club
  • memberNo – DSB member number (licence number) within the club
  • clubName – Name of the club
  • licenceState – Licence state of the membership (ACTIVE or PASSIVE).
  • regionName – Name of the region the club belongs to
  • federationName – Name of the federation the club belongs to
  The array contains all current memberships of the person; the membership-related filters only restrict which persons are returned, not which memberships are listed.
• 400 Bad Request – If minAge is greater than maxAge.
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

Response

• 200 OK – Returns a DSBTournamentDetailDTO matching the given UUID.
• 401 Unauthorized – If the subject is not authorized.
• 404 Not Found – If no tournament with the given UUID exists.
• 500 Internal Server Error – If an error occurs while processing the request.

Property prognosis contains matches and other steps of the week, that hasn't been finished so far. On Wednesday 00:00 the preceding week from Monday 00:00 until Sunday 24:00 will be finally computed. In the time frame from Monday 00:00 after that week and Wednesday 00:00 (the time of computation), the prognosis will contain the matches of the preceding week only. This means, that matches of Monday and Tuesday will be visible as the new prognosis as soon as the computation has been performed and will be invisible before Wednesday 00:00.

Path Parameters

• fileName – Name of the returned ZIP file (e.g. LV-B-dwzliste.zip). The character at index 3 is extracted as the federation identifier (case-insensitive, converted to uppercase internally) and must be one of: 0–9, A–H, L, M. The filename must be at least 4 characters long.

Query Parameters

• charset – Character encoding of the CSV files. Defaults to windows-1252 (ANSI, DSB-compatible). Any IANA charset name supported by the JVM is accepted (e.g. utf-8).
• delimiter – Field delimiter used in the CSV files. Defaults to ,. Only the first character of the value is used.

Archive Contents

• spieler.csv – Persons whose club VKZ starts with the federation identifier, sorted by DWZ. One row per current club membership, so a person with several current memberships (memberships without an until date) produces one row per club. Columns: {@code ID, ZPS, Mitgliedsnummer, Status, "Name,Vorname", Geschlecht, Spielberechtigung, Geburtsjahr, WocheLetztesRatingturnier, DWZ, Index, FIDE-Elozahl, FIDE-Titel, FIDE-ID, FIDE-Land, Vorname, Nachname}. ZPS, Mitgliedsnummer and Status reflect the respective membership. Spielberechtigung, FIDE-Elozahl, FIDE-Titel and FIDE-Land are always empty. Status is A (aktiv) or P (passiv). Geschlecht is M (männlich) or W (weiblich).
• vereine.csv – Clubs whose VKZ starts with the federation identifier, sorted by ZPS-Nummer. Columns: ZPS-Nummer, Landesverband, UebergeordneterVerband, Vereinsname.
• verbaende.csv – Federations belonging to the specified federation group, sorted by Verbandnummer. Columns: Verbandnummer, Landesverband, UebergeordneterVerband, Verbandname.
• README.txt – Header with the top-level federation name, generation date, record counts, charset and delimiter, plus column documentation for all three CSV files.

Response

• 200 OK – Returns the ZIP archive as application/zip with Content-Disposition: attachment; filename="".
• 401 Unauthorized – If the subject is not authorized.
• 404 Not Found – If fileName is shorter than 4 characters, the character at index 3 is not a valid federation identifier (0–9, A–H, L, M), or charset is not supported by the JVM.
• 500 Internal Server Error – If an error occurs while building the archive.

• 200 OK – Returns a DSBPersonDTO matching the given nuLigaId. The DTO includes a memberships array holding all current club memberships (memberships without an until date), each with vkz, memberNo, clubName, licenceState, regionName and federationName. See DSBPersonDTO.
• 401 Unauthorized – If the subject is not authorized.
• 404 Not Found – If no person with the given nuLigaId exists.
• 500 Internal Server Error – If an error occurs while processing the request.

Response

• 200 OK – Returns a DSBTournamentHistoryDTO containing the person's current DWZ data, a list of jpa.nu.liga.lk2020.services.dwz.rest.dto.DSBTournamentHistoryEntryDTO entries, each pairing the tournament metadata with the player's DWZ evaluation data, and a list of jpa.nu.liga.lk2020.services.dwz.rest.dto.DSBUpgradeDTO upgrades (DWZ-Umstufungen) of the person. Returns empty lists if the person has no tournament history or no upgrades.
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

Response

• 200 OK – Returns a DSBTournamentEvaluationDTO containing the tournament (as a DSBTournamentDetailDTO including aggregate counts) and its list of rated players (DSBPlayerDTO) with DWZ evaluation data.
• 401 Unauthorized – If the subject is not authorized.
• 404 Not Found – If no tournament with the given UUID exists, or if the tournament has not been rated yet.
• 500 Internal Server Error – If an error occurs while processing the request.

Query Parameters

• round – Filter by round number (exact match).
• playerLastname – Filter by player last name (prefix match, matches white or black player).
• limit – Maximum number of results to return. If omitted, all matching results are returned.
• offset – Zero-based index of the first result to return. Defaults to 0 if omitted.

Response

• 200 OK – Returns a PagedResponse containing DSBMatchDTO objects matching the filters, along with pagination metadata (limit, offset, totalCount) and PageNavigationLinks (self, first, last, next, previous). Returns an empty list if no games exist for the given tournament UUID.
• 400 Bad Request – If limit or offset is negative.
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.

direct and indirect compare match list.

• direct compare filter with compareType H2HCompareType.DIRECT_COMPARE and opponentNuLigaPersonId
• indirect compare filter with compareType H2HCompareType.INDIRECT_COMPARE and opponentNuLigaPersonId
• direct and indirect compare filter with compareType NULL and opponentNuLigaPersonId

• if query param club-id is provided: if gender is present, rank = the gendered club rank, otherwise rank = total club rank;
• if query param federation-nickname is provided: if gender is present, rank = the gendered LV rank, otherwise rank = total LV rank;
• if these two params are absent: if gender is present, rank = the total rank within that gender, otherwise rank = the total rank;

Given the complete "Deutsche Rangliste" for the given altersklasse and "Stichtag" rankingDate, /rankinglists/{rankingDate}/{altersklasse}.

The list contains matches and other steps of the latest x weeks and the week that hasn't been finished so far.

Use this endpoint to signal grading events of these types: CLASSIFICATION, RECLASSIFICATION In all cases, the new LK must be provided by the gradedLK property of the NUGradingDTO in the request body.

Only gradings of the current week, not graded for a future date, are effective immediately.

Use this endpoint to signal delets of grading events of these types: CLASSIFICATION, RECLASSIFICATION

Only gradings of the current week, not graded for a future date, are effective immediately.

The scoresheet contains all games of the player in the current tournament (matches), ordered by round. If the player has old restgames from previous tournaments they are additionally returned in restpartienAlt, ordered by tournament end date and round.

Response

• 200 OK – Returns a DSBScoresheetDTO containing the player's games.
• 401 Unauthorized – If the subject is not authorized.
• 500 Internal Server Error – If an error occurs while processing the request.