@fin.cx/opendata 3.6.0 → 4.1.0

package/ts/handelsregister/data.codelists.ts

@@ -0,0 +1,640 @@
+/**
+ * Code tables for reading the register portal's structured register content (SI, XJustiz).
+ *
+ * Taken on 2026-09-23 from the code lists published on XRepository (https://www.xrepository.de):
+ * - urn:xoev-de:xunternehmen:codeliste:rechtsformen_2.4, the codes the justice registers can carry;
+ * - urn:xoev-de:xjustiz:codeliste:gds.rollenbezeichnung_3.6, the roles that occur in register content;
+ * - urn:xoev-de:xjustiz:codeliste:reg.status-rechtstraeger_2.0;
+ * - urn:xoev-de:bund:bfj:codeliste:bfj.staat_7.0, reduced to key and ISO 3166-1 alpha-2 code.
+ *
+ * The register courts are the options of the portal's search form of the same day; their codes
+ * are those of urn:xoev-de:xjustiz:codeliste:gds.gerichte.
+ */
+import type { IRegisterCourt } from './interfaces.js';
+
+export interface ILegalFormLabel {
+  /** short designation, for example `GmbH` */
+  short?: string;
+  /** full designation, for example `Gesellschaft mit beschränkter Haftung` */
+  long: string;
+}
+
+/** XUnternehmen legal form code → designation */
+export const legalFormLabels: Readonly<Record<string, ILegalFormLabel>> = {
+  '111000': { short: 'OHG', long: 'Offene Handelsgesellschaft' },
+  '111100': { short: 'OHG', long: 'Offene Handelsgesellschaft, bei der eine natürliche Person persönlich haftet (d. h. ohne entsprechenden Firmierungszusatz)' },
+  '111211': { short: 'GmbH & Co. OHG', long: 'Gesellschaft mit beschränkter Haftung & Co. Offene Handelsgesellschaft' },
+  '111212': { short: 'UG & Co. OHG', long: 'Unternehmergesellschaft (haftungsbeschränkt) & Co. Offene Handelsgesellschaft' },
+  '111221': { short: 'AG & Co. OHG', long: 'Aktiengesellschaft & Co. Offene Handelsgesellschaft' },
+  '111222': { short: 'SE & Co. OHG', long: 'Europäische Aktiengesellschaft & Co. Offene Handelsgesellschaft' },
+  '111230': { short: 'KGaA & Co. OHG', long: 'Kommanditgesellschaft auf Aktien & Co. Offene Handelsgesellschaft' },
+  '111240': { short: 'Ltd. & Co. OHG', long: 'Limited (unspezifisch) & Co. Offene Handelsgesellschaft' },
+  '111310': { short: 'eG & Co. OHG', long: 'eingetragene Genossenschaft & Co. Offene Handelsgesellschaft' },
+  '111400': { short: 'Stiftung & Co. OHG', long: 'Stiftung & Co. Offene Handelsgesellschaft' },
+  '112000': { short: 'KG', long: 'Kommanditgesellschaft' },
+  '112100': { short: 'KG', long: 'Kommanditgesellschaft, bei der eine natürliche Person persönlich haftet (d. h. ohne entsprechenden Firmierungszusatz)' },
+  '112211': { short: 'GmbH & Co. KG', long: 'Gesellschaft mit beschränkter Haftung & Co. Kommanditgesellschaft' },
+  '112212': { short: 'UG & Co. KG', long: 'Unternehmergesellschaft (haftungsbeschränkt) & Co. Kommanditgesellschaft' },
+  '112221': { short: 'AG & Co. KG', long: 'Aktiengesellschaft & Co. Kommanditgesellschaft' },
+  '112222': { short: 'SE & Co. KG', long: 'Europäische Aktiengesellschaft & Co. Kommanditgesellschaft' },
+  '112230': { short: 'KGaA & Co. KG', long: 'Kommanditgesellschaft auf Aktien & Co. Kommanditgesellschaft' },
+  '112240': { short: 'Ltd. & Co. KG', long: 'Limited (unspezifisch) & Co. Kommanditgesellschaft' },
+  '112310': { short: 'eG & Co. KG', long: 'eingetragene Genossenschaft & Co. Kommanditgesellschaft' },
+  '112410': { short: 'GbR & Co. KG', long: 'Gesellschaft bürgerlichen Rechts & Co. Kommanditgesellschaft' },
+  '112500': { short: 'Stiftung & Co. KG', long: 'Stiftung & Co. Kommanditgesellschaft' },
+  '112600': { short: 'Investment-KG', long: 'Investmentkommanditgesellschaft' },
+  '113000': { short: 'EWIV', long: 'Europäische Wirtschaftliche Interessensvereinigung' },
+  '114000': { short: 'Partenreederei', long: 'Partenreederei (§ 489 HGB a. F.)' },
+  '120000': { short: 'GbR', long: 'Gesellschaft des bürgerlichen Rechts (BGB-Gesellschaft); auch eingetragene Gesellschaft des bürgerlichen Rechts' },
+  '123000': { short: 'eGbR', long: 'eingetragene Gesellschaft des bürgerlichen Rechts' },
+  '131000': { short: 'PartG', long: 'Partnerschaftsgesellschaft (PartG)' },
+  '138100': { short: 'sonst. rechtsf. Personengesellschaft', long: 'sonstige rechtsfähige Personengesellschaft (Auffangtatbestand)' },
+  '138200': { long: 'OHG oder KG, bei der keiner der persönlich haftenden Gesellschafter eine natürliche Person ist (Auffangtatbestand Justiz)' },
+  '190000': { short: 'ausl. Personengesellschaft', long: 'ausländische Personengesellschaft' },
+  '191000': { short: 'ausl. Personengesellschaft (EU-Recht)', long: 'ausländische Personengesellschaft (EU-Recht)' },
+  '192000': { short: 'ausl. Personengesellschaft (Nicht-EU-Recht)', long: 'ausländische Personengesellschaft (Nicht-EU-Recht)' },
+  '211000': { short: 'e.V.', long: 'eingetragener Verein (e.V.)' },
+  '212000': { short: 'Wirtsch. Verein', long: 'Wirtschaftlicher Verein' },
+  '213000': { short: 'VVaG', long: 'Versicherungsverein auf Gegenseitigkeit; auch Pensionsfondsverein auf Gegenseitigkeit' },
+  '213100': { short: 'VVaG', long: 'Versicherungsverein auf Gegenseitigkeit' },
+  '213200': { short: 'PVaG', long: 'Pensionsfondsverein auf Gegenseitigkeit' },
+  '221000': { short: 'GmbH', long: 'Gesellschaft mit beschränkter Haftung; auch gemeinnützige GmbH ; auch Unternehmergesellschaft (haftungsbeschränkt)' },
+  '221100': { short: 'GmbH', long: 'Gesellschaft mit beschränkter Haftung; auch gemeinnützige GmbH' },
+  '221110': { short: 'GmbH', long: 'Gesellschaft mit beschränkter Haftung' },
+  '221120': { short: 'gGmbH', long: 'gemeinnützige Gesellschaft mit beschränkter Haftung' },
+  '221200': { short: 'UG', long: 'Unternehmergesellschaft (haftungsbeschränkt)' },
+  '222100': { short: 'AG', long: 'Aktiengesellschaft (AG); auch Investmentaktiengesellschaft (InvAG)' },
+  '222110': { short: 'AG', long: 'Aktiengesellschaft (AG), ohne Investmentaktiengesellschaft (InvAG)' },
+  '222120': { short: 'InvAG', long: 'Investmentaktiengesellschaft (InvAG)' },
+  '222200': { short: 'SE', long: 'Europäische Aktiengesellschaft (SE)' },
+  '223000': { short: 'KGaA', long: 'Kommanditgesellschaft auf Aktien (KGaA); auch & Co. KGaA' },
+  '223100': { short: 'KGaA', long: 'Kommanditgesellschaft auf Aktien (KGaA), exkl. & Co. KGaA' },
+  '223211': { short: 'GmbH & Co. KGaA', long: 'Gesellschaft mit beschränkter Haftung & Co. Kommanditgesellschaft auf Aktien' },
+  '223212': { short: 'UG & Co. KGaA', long: 'Unternehmergesellschaft (haftungsbeschränkt) & Co. Kommanditgesellschaft auf Aktien' },
+  '223221': { short: 'AG & Co. KGaA', long: 'Aktiengesellschaft & Co. Kommanditgesellschaft auf Aktien' },
+  '223222': { short: 'SE & Co. KGaA', long: 'Europäische Aktiengesellschaft und Co. Kommanditgesellschaft auf Aktien' },
+  '223400': { short: 'Stiftung & Co. KGaA', long: 'Stiftung & Co. Kommanditgesellschaft auf Aktien' },
+  '224100': { short: 'Bergrechtl. Gewerkschaft', long: 'Bergrechtliche Gewerkschaft' },
+  '224200': { short: 'Kolonialgesellschaft', long: 'Kolonialgesellschaft' },
+  '224300': { short: 'Seerechtl. Gesellschaft', long: 'Seerechtliche Gesellschaft' },
+  '224810': { short: 'sonst. Kapitalgesellschaft (Auffangtatb. Steuer)', long: 'sonstige Kapitalgesellschaft (Auffangtatbestand Steuer)' },
+  '231000': { short: 'rechtsf. Stiftung (Privatrecht)', long: 'rechtsfähige Stiftung des Privatrechts' },
+  '231100': { short: 'e. S.', long: 'im Stiftungsregister eingetragene Stiftung' },
+  '231110': { short: 'e. S.', long: 'eingetragene Stiftung - e. S.' },
+  '231120': { short: 'e. VS.', long: 'eingetragene Stiftung - e. VS.' },
+  '232000': { short: 'rechtsf. Stiftung (öffentl. Recht)', long: 'rechtsfähige Stiftung des öffentlichen Rechts' },
+  '240000': { short: 'KöR', long: 'Körperschaft des öffentlichen Rechts (KöR)' },
+  '241000': { short: 'berufsständische KöR', long: 'berufsständische Körperschaft des öffentlichen Rechts' },
+  '242000': { short: 'Gebietskörperschaft', long: 'Gebietskörperschaft' },
+  '242100': { short: 'Bund', long: 'Bund' },
+  '242200': { short: 'Land', long: 'Land' },
+  '242300': { short: 'Gemeinde', long: 'Gemeinde' },
+  '242400': { short: 'sonst. Gebietskörperschaft', long: 'sonstige Gebietskörperschaft' },
+  '243000': { short: 'ÖR Religionsgemeinschaft', long: 'öffentlich-rechtliche Religionsgesellschaft' },
+  '251000': { short: 'eG', long: 'eingetragene Genossenschaft (eG)' },
+  '252000': { short: 'SCE', long: 'Europäische Genossenschaft (SCE)' },
+  '258100': { short: 'sonst. Genossenschaft (Auffangtatb. Steuer)', long: 'sonstige Genossenschaft (Auffangtatbestand Steuer)' },
+  '262000': { short: 'rechtsf. AöR', long: 'rechtsfähige Anstalt des öffentlichen Rechts (rechtsf. AöR)' },
+  '268100': { short: 'sonst. juristische Person', long: 'sonstige juristische Person (Auffangtatbestand)' },
+  '268200': { short: 'sonst. juristische Person des Privatrechts (Auffangtatb. Steuer)', long: 'sonstige juristische Person des Privatrechts (Auffangtatbestand Steuer)' },
+  '268300': { short: 'sonst. juristische Person des öffentlichen Rechts (Auffangtatb. Steuer)', long: 'sonstige juristische Person des öffentlichen Rechts (Auffangtatbestand Steuer)' },
+  '268400': { short: 'sonst. juristische Person, d. im HRA eingetragen ist (Auffangtatb. Justiz)', long: 'sonstige juristische Person, die im Handelsregister Abteilung A eingetragen ist (Auffangtatbestand Justiz)' },
+  '291000': { short: 'ausl. KöR', long: 'ausländische Körperschaft des öffentlichen Rechts' },
+  '292000': { short: 'ausl. Genossenschaft', long: 'ausländische Genossenschaft' },
+  '293000': { short: 'ausl. Kapitalgesellschaft', long: 'ausländische Kapitalgesellschaft' },
+  '293100': { short: 'Ltd.', long: 'Limited Company (unspezifisch)' },
+  '294000': { short: 'ausl. juristische Person (EU-Recht)', long: 'ausländische juristische Person (EU-Recht)' },
+  '295000': { short: 'ausl. juristische Person (Nicht-EU-Recht)', long: 'ausländische juristische Person (Nicht-EU-Recht)' },
+  '298100': { short: 'sonst. ausl. juristische Person des privaten Rechts (Auffangtatb. Steuer)', long: 'sonstige ausländische juristische Person des privaten Rechts (Auffangtatbestand Steuer)' },
+  '410000': { long: 'gewerbliches Einzelunternehmen (ohne Hausgewerbe)' },
+  '411000': { short: 'e.K.; e.Kfm.; e.Kfr.', long: 'eingetragenes gewerbliches Einzelunternehmen (e.K.; e.Kfm.; e.Kfr.)' },
+  '411100': { short: 'e.K.; e.Kfm.; e.Kfr. (Sitz in DE)', long: 'eingetragenes gewerbliches Einzelunternehmen (e.K.; e.Kfm.; e.Kfr.) (Sitz in Deutschland)' },
+  '411200': { short: 'e.K.; e.Kfm.; e.Kfr. (Sitz im Ausland)', long: 'eingetragenes gewerbliches Einzelunternehmen (e.K.; e.Kfm.; e.Kfr.) (Sitz im Ausland)' },
+  '422000': { short: 'Land-/Forstwirt', long: 'Land-/Forstwirt' },
+  '428100': { short: 'sonst. wirtsch. Tätigkeit einer nat. Person', long: 'sonstige wirtschaftliche Tätigkeit einer natürlichen Person (Auffangtatbestand)' },
+  '490000': { short: 'ausl. wirtsch. Tätigkeit einer nat. Person', long: 'ausländische wirtschaftliche Tätigkeit einer natürlichen Person' },
+  '491000': { short: 'ausl. gew. Einzelunternehmen (EU-Recht)', long: 'ausländische gewerbliches Einzelunternehmen (EU-Recht)' },
+  '492000': { short: 'ausl. gew. Einzelunternehmen (Nicht-EU-Recht)', long: 'ausländisches gewerbliches Einzelunternehmen (Nicht-EU-Recht)' },
+  '540000': { short: 'Gewerbebetrieb einer KöR', long: 'Gewerbebetrieb einer Körperschaft des öffentlichen Rechts' },
+  '581000': { long: 'sonstige wirtschaftliche Tätigkeit einer nicht-natürlichen Person (Auffangtatbestand)' },
+  '681000': { short: 'Freitext', long: 'Freitext (Auffangtatbestand)' },
+  '682000': { short: 'Freitext', long: 'Freitext (Auffangtatbestand Justiz)' },
+  '683000': { short: 'Ersatzwert', long: 'Ersatzwert (Auffangtatbestand Steuer)' },
+  '683100': { short: 'sonst. nicht-nat. Rechtsform', long: 'sonstige nicht-nat. Rechtsform (Auffangtatbestand Steuer)' },
+  '690000': { short: 'ausl. Rechtsform', long: 'ausländische Rechtsform' },
+  '692100': { short: 'Rechtsform ausländischen Rechts GnR', long: 'Rechtsform ausländischen Rechts GnR' },
+  '692200': { short: 'Rechtsform ausländischen Rechts GsR', long: 'Rechtsform ausländischen Rechts GsR' },
+  '692310': { short: 'Rechtsform ausländischen Rechts HRA', long: 'Rechtsform ausländischen Rechts HRA' },
+  '692320': { short: 'Rechtsform ausländischen Rechts HRB', long: 'Rechtsform ausländischen Rechts HRB' },
+  '692400': { short: 'Rechtsform ausländischen Rechts PR', long: 'Rechtsform ausländischen Rechts PR' },
+  '698100': { short: 'sonst. ausl. Rechtsform (Auffangtatb. Steuer)', long: 'sonstige ausländische Rechtsform (Auffangtatbestand Steuer)' },
+};
+
+/** XJustiz role code → designation */
+export const roleLabels: Readonly<Record<string, string>> = {
+  '024': 'Behörde',
+  '085': 'Geschäftsführende(r) Gesellschafter(in)',
+  '086': 'Geschäftsführer(in)',
+  '088': 'Gesetzliche(r) Vertreter(in)',
+  '095': 'Inhaber(in) der Firma',
+  '096': 'Insolvenzverwalter(in)',
+  '107': 'Liquidator(in)',
+  '113': 'Nachlasspfleger(in)',
+  '114': 'Nachlassverwalter(in)',
+  '152': 'Sonstige(r) Vertreter(in)',
+  '162': 'Testamentsvollstrecker(in)',
+  '164': 'Übernehmer(in)',
+  '194': 'Vorstand',
+  '215': 'Einreicher(in)',
+  '227': 'Vertreter(in)',
+  '243': 'Anteilsinhaber(in)',
+  '246': 'Gesellschafter(in)',
+  '251': 'Partner(in)',
+  '252': 'Persönlich haftende(r) Gesellschafter(in)',
+  '254': 'Sachwalter(in)',
+  '257': 'Vorläufige(r) Insolvenzverwalter(in)',
+  '259': 'Sondersachwalter(in)',
+  '260': 'Sonderinsolvenzverwalter(in)',
+  '261': 'Vorläufige(r) Sachwalter(in)',
+  '262': 'Abwickler(in)',
+  '263': 'Übernehmender Rechtsträger',
+  '264': 'Aufsichtsrat (-rätin)',
+  '265': 'Besondere(r) Vertreter(in) nach § 30 BGB',
+  '266': 'Betriebsleiter(in)',
+  '268': 'Geschäftsführende(r) Direktor(in)',
+  '269': 'Geschäftsleiter(in)',
+  '273': 'Hauptniederlassung',
+  '274': 'Inhaber(in)',
+  '275': 'Kommanditist(in)',
+  '277': 'Mitglied des Leitungsorgans',
+  '278': 'Mitglied EWIV',
+  '280': 'Nachtragsabwickler(in)',
+  '281': 'Nachtragsliquidator(in)',
+  '282': 'Notgeschäftsführer(in)',
+  '283': 'Notliquidator(in)',
+  '284': 'Notvorstand',
+  '285': 'Prokurist(in)',
+  '287': 'Rechtsträger(in)',
+  '288': 'Registergericht',
+  '290': 'Ständige(r) Vertreter(in) für die Zweigniederlassung',
+  '291': 'Übertragender Rechtsträger',
+  '293': 'Verwaltungsrat (-rätin)',
+  '294': 'Vorstandsvorsitzende(r)',
+  '295': 'Zweigniederlassung',
+  '315': 'Aufsichtsratsvorsitzende(r)',
+  '320': 'Formwechselnder Rechtsträger',
+  '322': 'Inhaber(in) (nicht eingetragen)',
+  '326': 'Sonstige(r) gerichtlich bestellte(r) Vertreter(in)',
+  '327': 'Sonstige(r) gesetzliche(r) Vertreter(in) BGB',
+  '328': 'Sonstige(r) organschaftliche(r) Vertreter(in) HRB',
+  '332': 'Vertreter(in) des persönlich haftenden Gesellschafters',
+  '333': 'Werkleiter(in)',
+  '335': 'Mitglied VR',
+  '336': 'Mitglied e. BGB-Gesellschaft als Abwicklerin',
+  '337': 'Mitglied e. BGB-Gesellschaft als ges. Vertreterin',
+  '338': 'Mitglied e. BGB-Gesellschaft als Kommanditistin',
+  '339': 'Mitglied e. BGB-Gesellschaft als Liquidatorin',
+  '340': 'Mitglied e. BGB-Gesellschaft als Mitglied e. EWIV',
+  '341': 'Mitglied e. BGB-Gesellschaft als phG',
+  '342': 'Mitglied e. Erbengemeinschaft als ges. Vertreterin',
+  '343': 'Mitglied e. Erbengemeinschaft als Inhaberin',
+  '344': 'Mitglied e. Erbengemeinschaft als Kommanditistin',
+  '345': 'Mitglied e. Erbengemeinschaft als Mitglied e. EWIV',
+  '348': 'Mitglied einer Gesamthandsgemeinschaft',
+  '359': 'Statuswechselnde(r) Rechtsträger(in)',
+  '399': 'Registerführende Behörde/Stelle',
+};
+
+/** XJustiz status code of the legal entity → designation */
+export const entityStatusLabels: Readonly<Record<string, string>> = {
+  '001': 'aktiv',
+  '002': 'gelöscht',
+  '003': 'in Abwicklung',
+  '004': 'insolvent',
+  '005': 'verschmolzen auf nicht eingetragenen Rechtsträger',
+};
+
+/** BfJ state key → ISO 3166-1 alpha-2 */
+export const stateKeyToIso: Readonly<Record<string, string>> = {
+  '423': 'AF',
+  '287': 'EG',
+  '118': 'AX',
+  '121': 'AL',
+  '221': 'DZ',
+  '316': 'VI',
+  '517': 'AS',
+  '123': 'AD',
+  '223': 'AO',
+  '310': 'AI',
+  '320': 'AG',
+  '274': 'GQ',
+  '323': 'AR',
+  '548': 'AQ',
+  '422': 'AM',
+  '311': 'AW',
+  '425': 'AZ',
+  '225': 'ET',
+  '523': 'AU',
+  '547': 'AQ',
+  '324': 'BS',
+  '424': 'BH',
+  '460': 'BD',
+  '322': 'BB',
+  '169': 'BY',
+  '124': 'BE',
+  '330': 'BZ',
+  '229': 'BJ',
+  '312': 'BM',
+  '426': 'BT',
+  '326': 'BO',
+  '344': 'BQ',
+  '122': 'BA',
+  '227': 'BW',
+  '522': 'BV',
+  '327': 'BR',
+  '313': 'VG',
+  '539': 'AQ',
+  '413': 'IO',
+  '429': 'BN',
+  '125': 'BG',
+  '258': 'BF',
+  '291': 'BI',
+  '242': 'CV',
+  '332': 'CL',
+  '546': 'AQ',
+  '479': 'CN',
+  '352': 'CP',
+  '527': 'CK',
+  '334': 'CR',
+  '231': 'CI',
+  '321': 'CW',
+  '126': 'DK',
+  '000': 'DE',
+  '333': 'DM',
+  '335': 'DO',
+  '230': 'DJ',
+  '336': 'EC',
+  '337': 'SV',
+  '224': 'ER',
+  '127': 'EE',
+  '281': 'SZ',
+  '314': 'FK',
+  '182': 'FO',
+  '526': 'FJ',
+  '128': 'FI',
+  '129': 'FR',
+  '542': 'TF',
+  '315': 'GF',
+  '528': 'PF',
+  '236': 'GA',
+  '237': 'GM',
+  '430': 'GE',
+  '238': 'GH',
+  '112': 'GI',
+  '340': 'GD',
+  '134': 'GR',
+  '342': 'GL',
+  '317': 'GP',
+  '529': 'GU',
+  '345': 'GT',
+  '113': 'GG',
+  '261': 'GN',
+  '259': 'GW',
+  '328': 'GY',
+  '346': 'HT',
+  '510': 'HM',
+  '347': 'HN',
+  '411': 'HK',
+  '436': 'IN',
+  '437': 'ID',
+  '115': 'IM',
+  '438': 'IQ',
+  '439': 'IR',
+  '135': 'IE',
+  '136': 'IS',
+  '441': 'IL',
+  '137': 'IT',
+  '355': 'JM',
+  '442': 'JP',
+  '443': 'YE',
+  '421': 'YE',
+  '114': 'JE',
+  '445': 'JO',
+  '120': 'YU',
+  '138': 'YU',
+  '318': 'KY',
+  '446': 'KH',
+  '262': 'CM',
+  '348': 'CA',
+  '444': 'KZ',
+  '447': 'QA',
+  '243': 'KE',
+  '450': 'KG',
+  '530': 'KI',
+  '534': 'UM',
+  '512': 'CC',
+  '349': 'CO',
+  '244': 'KM',
+  '245': 'CG',
+  '246': 'CD',
+  '434': 'KP',
+  '467': 'KR',
+  '150': 'XK',
+  '130': 'HR',
+  '351': 'CU',
+  '448': 'KW',
+  '449': 'LA',
+  '226': 'LS',
+  '139': 'LV',
+  '451': 'LB',
+  '247': 'LR',
+  '248': 'LY',
+  '141': 'LI',
+  '142': 'LT',
+  '143': 'LU',
+  '412': 'MO',
+  '249': 'MG',
+  '256': 'MW',
+  '482': 'MY',
+  '454': 'MV',
+  '251': 'ML',
+  '145': 'MT',
+  '252': 'MA',
+  '544': 'MH',
+  '319': 'MQ',
+  '239': 'MR',
+  '253': 'MU',
+  '211': 'YT',
+  '353': 'MX',
+  '545': 'FM',
+  '146': 'MD',
+  '147': 'MC',
+  '457': 'MN',
+  '140': 'ME',
+  '339': 'MS',
+  '254': 'MZ',
+  '427': 'MM',
+  '267': 'NA',
+  '531': 'NR',
+  '458': 'NP',
+  '513': 'NC',
+  '536': 'NZ',
+  '549': 'AQ',
+  '354': 'NI',
+  '148': 'NL',
+  '392': 'AN',
+  '255': 'NE',
+  '232': 'NG',
+  '533': 'NU',
+  '514': 'MP',
+  '144': 'MK',
+  '515': 'NF',
+  '149': 'NO',
+  '535': 'AQ',
+  '456': 'OM',
+  '151': 'AT',
+  '461': 'PK',
+  '459': 'PS',
+  '537': 'PW',
+  '357': 'PA',
+  '538': 'PG',
+  '359': 'PY',
+  '361': 'PE',
+  '462': 'PH',
+  '516': 'PN',
+  '152': 'PL',
+  '153': 'PT',
+  '325': 'PR',
+  '214': 'RE',
+  '265': 'RW',
+  '154': 'RO',
+  '160': 'RU',
+  '524': 'SB',
+  '257': 'ZM',
+  '543': 'WS',
+  '156': 'SM',
+  '268': 'ST',
+  '472': 'SA',
+  '157': 'SE',
+  '158': 'CH',
+  '269': 'SN',
+  '170': 'RS',
+  '133': 'RS',
+  '132': 'CS',
+  '271': 'SC',
+  '272': 'SL',
+  '233': 'ZW',
+  '474': 'SG',
+  '155': 'SK',
+  '131': 'SI',
+  '273': 'SO',
+  '159': 'SU',
+  '161': 'ES',
+  '431': 'LK',
+  '329': 'BL',
+  '215': 'SH',
+  '370': 'KN',
+  '366': 'LC',
+  '331': 'MF',
+  '341': 'SX',
+  '338': 'PM',
+  '369': 'VC',
+  '997': 'XA',
+  '263': 'ZA',
+  '277': 'SD',
+  '276': 'SD',
+  '518': 'GS',
+  '278': 'SS',
+  '364': 'SR',
+  '116': 'SJ',
+  '475': 'SY',
+  '470': 'TJ',
+  '465': 'TW',
+  '282': 'TZ',
+  '476': 'TH',
+  '483': 'TL',
+  '283': 'TG',
+  '519': 'TK',
+  '541': 'TO',
+  '371': 'TT',
+  '284': 'TD',
+  '164': 'CZ',
+  '162': 'CS',
+  '285': 'TN',
+  '163': 'TR',
+  '471': 'TM',
+  '350': 'TC',
+  '540': 'TV',
+  '286': 'UG',
+  '166': 'UA',
+  '165': 'HU',
+  '365': 'UY',
+  '477': 'UZ',
+  '532': 'VU',
+  '167': 'VA',
+  '367': 'VE',
+  '469': 'AE',
+  '368': 'US',
+  '168': 'GB',
+  '432': 'VN',
+  '520': 'WF',
+  '521': 'CX',
+  '212': 'EH',
+  '289': 'CF',
+  '481': 'CY',
+  '181': 'CY',
+};
+
+/** the register courts of the portal, as its search form names them */
+export const registerCourts: readonly IRegisterCourt[] = [
+  { code: 'R3101', name: 'Aachen' },
+  { code: 'Y1201', name: 'Altenburg' },
+  { code: 'D3101', name: 'Amberg' },
+  { code: 'D3201', name: 'Ansbach' },
+  { code: 'Y1101', name: 'Apolda' },
+  { code: 'R1901', name: 'Arnsberg' },
+  { code: 'Y1102', name: 'Arnstadt' },
+  { code: 'Y1303', name: 'Arnstadt Zweigstelle Ilmenau' },
+  { code: 'D4102', name: 'Aschaffenburg' },
+  { code: 'D2102', name: 'Augsburg' },
+  { code: 'P3101', name: 'Aurich' },
+  { code: 'M1305', name: 'Bad Hersfeld' },
+  { code: 'M1202', name: 'Bad Homburg v.d.H.' },
+  { code: 'T2101', name: 'Bad Kreuznach' },
+  { code: 'R2108', name: 'Bad Oeynhausen' },
+  { code: 'Y1301', name: 'Bad Salzungen' },
+  { code: 'D4201', name: 'Bamberg' },
+  { code: 'D4301', name: 'Bayreuth' },
+  { code: 'F1103', name: 'Berlin (Charlottenburg)' },
+  { code: 'R2101', name: 'Bielefeld' },
+  { code: 'R2201', name: 'Bochum' },
+  { code: 'R3201', name: 'Bonn' },
+  { code: 'P1103', name: 'Braunschweig' },
+  { code: 'H1101', name: 'Bremen' },
+  { code: 'U1206', name: 'Chemnitz' },
+  { code: 'D4401', name: 'Coburg' },
+  { code: 'R2707', name: 'Coesfeld' },
+  { code: 'G1103', name: 'Cottbus' },
+  { code: 'M1103', name: 'Darmstadt' },
+  { code: 'D2201', name: 'Deggendorf' },
+  { code: 'R2402', name: 'Dortmund' },
+  { code: 'U1104', name: 'Dresden' },
+  { code: 'R1202', name: 'Duisburg' },
+  { code: 'R3103', name: 'Düren' },
+  { code: 'R1101', name: 'Düsseldorf' },
+  { code: 'Y1105', name: 'Eisenach' },
+  { code: 'Y1106', name: 'Erfurt' },
+  { code: 'M1602', name: 'Eschwege' },
+  { code: 'R2503', name: 'Essen' },
+  { code: 'X1112', name: 'Flensburg' },
+  { code: 'M1201', name: 'Frankfurt am Main' },
+  { code: 'G1207', name: 'Frankfurt (Oder)' },
+  { code: 'B1204', name: 'Freiburg' },
+  { code: 'M1405', name: 'Friedberg' },
+  { code: 'M1603', name: 'Fritzlar' },
+  { code: 'M1301', name: 'Fulda' },
+  { code: 'D3304', name: 'Fürth' },
+  { code: 'R2507', name: 'Gelsenkirchen' },
+  { code: 'Y1203', name: 'Gera' },
+  { code: 'M1406', name: 'Gießen' },
+  { code: 'Y1108', name: 'Gotha' },
+  { code: 'P2204', name: 'Göttingen' },
+  { code: 'Y1205', name: 'Greiz' },
+  { code: 'R2103', name: 'Gütersloh' },
+  { code: 'R2602', name: 'Hagen' },
+  { code: 'K1101', name: 'Hamburg' },
+  { code: 'R2404', name: 'Hamm' },
+  { code: 'M1502', name: 'Hanau' },
+  { code: 'P2305', name: 'Hannover' },
+  { code: 'Y1109', name: 'Heilbad Heiligenstadt' },
+  { code: 'Y1302', name: 'Hildburghausen' },
+  { code: 'P2408', name: 'Hildesheim' },
+  { code: 'D4501', name: 'Hof' },
+  { code: 'V1102', name: 'Homburg' },
+  { code: 'D5701', name: 'Ingolstadt' },
+  { code: 'R2604', name: 'Iserlohn' },
+  { code: 'Y1206', name: 'Jena' },
+  { code: 'T3201', name: 'Kaiserslautern' },
+  { code: 'M1607', name: 'Kassel' },
+  { code: 'D2304', name: 'Kempten (Allgäu)' },
+  { code: 'X1517', name: 'Kiel' },
+  { code: 'R1304', name: 'Kleve' },
+  { code: 'T2210', name: 'Koblenz' },
+  { code: 'R3306', name: 'Köln' },
+  { code: 'M1203', name: 'Königstein' },
+  { code: 'M1608', name: 'Korbach' },
+  { code: 'R1402', name: 'Krefeld' },
+  { code: 'T3304', name: 'Landau' },
+  { code: 'D2404', name: 'Landshut' },
+  { code: 'R1105', name: 'Langenfeld' },
+  { code: 'V1103', name: 'Lebach' },
+  { code: 'U1308', name: 'Leipzig' },
+  { code: 'R2307', name: 'Lemgo' },
+  { code: 'M1706', name: 'Limburg' },
+  { code: 'X1721', name: 'Lübeck' },
+  { code: 'T3104', name: 'Ludwigshafen a.Rhein (Ludwigshafen)' },
+  { code: 'P2507', name: 'Lüneburg' },
+  { code: 'T2304', name: 'Mainz' },
+  { code: 'B1601', name: 'Mannheim' },
+  { code: 'M1809', name: 'Marburg' },
+  { code: 'Y1304', name: 'Meiningen' },
+  { code: 'D2505', name: 'Memmingen' },
+  { code: 'V1104', name: 'Merzig' },
+  { code: 'R1504', name: 'Mönchengladbach' },
+  { code: 'T2214', name: 'Montabaur' },
+  { code: 'Y1110', name: 'Mühlhausen' },
+  { code: 'D2601', name: 'München' },
+  { code: 'R2713', name: 'Münster' },
+  { code: 'N1105', name: 'Neubrandenburg' },
+  { code: 'V1105', name: 'Neunkirchen' },
+  { code: 'G1309', name: 'Neuruppin' },
+  { code: 'R1102', name: 'Neuss' },
+  { code: 'Y1111', name: 'Nordhausen' },
+  { code: 'D3310', name: 'Nürnberg' },
+  { code: 'M1114', name: 'Offenbach am Main' },
+  { code: 'P3210', name: 'Oldenburg (Oldenburg)' },
+  { code: 'P3313', name: 'Osnabrück' },
+  { code: 'V1107', name: 'Ottweiler' },
+  { code: 'R2809', name: 'Paderborn' },
+  { code: 'D2803', name: 'Passau' },
+  { code: 'X1321', name: 'Pinneberg' },
+  { code: 'Y1209', name: 'Pößneck' },
+  { code: 'Y1208', name: 'Pößneck Zweigstelle Bad Lobenstein' },
+  { code: 'G1312', name: 'Potsdam' },
+  { code: 'R2204', name: 'Recklinghausen' },
+  { code: 'D3410', name: 'Regensburg' },
+  { code: 'N1206', name: 'Rostock' },
+  { code: 'Y1210', name: 'Rudolstadt' },
+  { code: 'V1109', name: 'Saarbrücken' },
+  { code: 'V1110', name: 'Saarlouis' },
+  { code: 'D4608', name: 'Schweinfurt' },
+  { code: 'N1308', name: 'Schwerin' },
+  { code: 'R3208', name: 'Siegburg' },
+  { code: 'R2909', name: 'Siegen' },
+  { code: 'Y1112', name: 'Sömmerda' },
+  { code: 'Y1113', name: 'Sondershausen' },
+  { code: 'Y1307', name: 'Sonneberg' },
+  { code: 'P2106', name: 'Stadthagen' },
+  { code: 'Y1214', name: 'Stadtroda' },
+  { code: 'R2706', name: 'Steinfurt' },
+  { code: 'W1215', name: 'Stendal' },
+  { code: 'V1111', name: 'St. Ingbert (St Ingbert)' },
+  { code: 'N1209', name: 'Stralsund' },
+  { code: 'D3413', name: 'Straubing' },
+  { code: 'B2609', name: 'Stuttgart' },
+  { code: 'V1112', name: 'St. Wendel (St Wendel)' },
+  { code: 'Y1308', name: 'Suhl' },
+  { code: 'P2613', name: 'Tostedt' },
+  { code: 'D2910', name: 'Traunstein' },
+  { code: 'B2805', name: 'Ulm' },
+  { code: 'V1115', name: 'Völklingen' },
+  { code: 'P2716', name: 'Walsrode' },
+  { code: 'D3508', name: 'Weiden i. d. OPf.' },
+  { code: 'Y1114', name: 'Weimar' },
+  { code: 'M1710', name: 'Wetzlar' },
+  { code: 'M1906', name: 'Wiesbaden' },
+  { code: 'T2408', name: 'Wittlich' },
+  { code: 'R1608', name: 'Wuppertal' },
+  { code: 'D4708', name: 'Würzburg' },
+  { code: 'T3403', name: 'Zweibrücken' },
+];