@firmenakte/api-client 2.1.0 → 2.3.1

package/client.js

@@ -192,11 +192,11 @@ class Api extends HttpClient {
         super(...arguments);
         this.api = {
             /**
-             * No description
+             * @description Downloads the signed GISA PDF extract for a license (GISA-Zahl). Language defaults to German (De).
              *
              * @tags Trades
              * @name V1TradesDocumentsDetail
-             * @summary Downloads the signed GISA PDF extract for a license (GISA-Zahl). Language defaults to German (De).
+             * @summary GISA PDF extract
              * @request GET:/api/v1/trades/documents/{gisaZahl}
              * @secure
              */
@@ -208,11 +208,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns the global catalog of GISA Trade Definitions with pagination.
              *
              * @tags Trades
              * @name V1TradesList
-             * @summary Returns the global catalog of GISA Trade Definitions with pagination.
+             * @summary GISA trade catalog
              * @request GET:/api/v1/trades
              * @secure
              */
@@ -225,11 +225,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all company licenses for a specific trade definition with pagination.
              *
              * @tags Trades
              * @name V1TradesLicensesList
-             * @summary Returns all company licenses for a specific trade definition with pagination.
+             * @summary Licenses by trade
              * @request GET:/api/v1/trades/{tradeKey}/licenses
              * @secure
              */
@@ -242,11 +242,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all licenses for a specific company (FNR).
              *
              * @tags Trades
              * @name V1TradesCompanyDetail
-             * @summary Returns all licenses for a specific company (FNR).
+             * @summary Company GISA licenses
              * @request GET:/api/v1/trades/company/{fnr}
              * @secure
              */
@@ -258,11 +258,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns a single GISA change by id.
              *
              * @tags Trades
              * @name V1TradesChangesDetail
-             * @summary Returns a single GISA change by id.
+             * @summary GISA change by id
              * @request GET:/api/v1/trades/changes/{id}
              * @secure
              */
@@ -274,11 +274,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
+             * @description Feed of GISA changes — one entry per change to a company's trade licences. Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
              *
              * @tags Trades
              * @name V1TradesChangesList
-             * @summary Feed of GISA changes — one entry per change to a company's trade licences.
+             * @summary GISA change feed
              * @request GET:/api/v1/trades/changes
              * @secure
              */
@@ -291,11 +291,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns (id, name) pairs for all people with at least one business assignment. For client-side name index.
              *
              * @tags People
              * @name V1PeopleNamesList
-             * @summary Returns (id, name) pairs for all people with at least one business assignment. For client-side name index.
+             * @summary Person name index
              * @request GET:/api/v1/people/names
              * @secure
              */
@@ -307,11 +307,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description name and search behave identically here — both split the term on spaces and keep people whose "firstName lastName" contains every token, case-insensitively — except that search wins when both are given. Ordered by last name, then first name unless orderBy says otherwise. Combine with fnr or businessName to get the officers of one company, or with functionCode for one role. fnr, functionCode, businessName, businessCity and businessRegisteredSince_gte all describe one and the same assignment: a person comes back only if a single company of theirs satisfies every one of them. So the youngest owners of this year's new Viennese companies are one page: ?businessCity=Wien&businessRegisteredSince_gte=2026-01-01&functionCode=IN&functionCode=KP&functionCode=GS&functionCode=PG&orderBy=birthDate&orderByDescending=true&pageSize=3
+             * @description Lists people who hold a function in, or a GISA licence for, an Austrian company. name and search behave identically here — both split the term on spaces and keep people whose "firstName lastName" contains every token, case-insensitively — except that search wins when both are given. Ordered by last name, then first name unless orderBy says otherwise. Combine with fnr or businessName to get the officers of one company, or with functionCode for one role. fnr, functionCode, businessName, businessCity and businessRegisteredSince_gte all describe one and the same assignment: a person comes back only if a single company of theirs satisfies every one of them. So the youngest owners of this year's new Viennese companies are one page: ?businessCity=Wien&businessRegisteredSince_gte=2026-01-01&functionCode=IN&functionCode=KP&functionCode=GS&functionCode=PG&orderBy=birthDate&orderByDescending=true&pageSize=3
              *
              * @tags People
              * @name V1PeopleList
-             * @summary Lists people who hold a function in, or a GISA licence for, an Austrian company.
+             * @summary People search
              * @request GET:/api/v1/people
              * @secure
              */
@@ -324,11 +324,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description personId is the synthetic id described in the glossary — "firstname-lastname-birthdate", lower case, inner spaces replaced by hyphens and "x" for a part the register does not give, e.g. "max-mustermann-1970-01-01". It is matched exactly. Take it from a list row or from an assignment on a company rather than composing it yourself.
+             * @description Returns one person with every company function, GISA licence and Edikt attached to them. personId is the synthetic id described in the glossary — "firstname-lastname-birthdate", lower case, inner spaces replaced by hyphens and "x" for a part the register does not give, e.g. "max-mustermann-1970-01-01". It is matched exactly. Take it from a list row or from an assignment on a company rather than composing it yourself.
              *
              * @tags People
              * @name V1PeopleDetail
-             * @summary Returns one person with every company function, GISA licence and Edikt attached to them.
+             * @summary Person detail
              * @request GET:/api/v1/people/{personId}
              * @secure
              */
@@ -340,11 +340,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns the OeNACE classification catalog with company counts. Results are ordered by company count descending — most used first.
              *
              * @tags Oenace
              * @name V1OenaceList
-             * @summary Returns the OeNACE classification catalog with company counts. Results are ordered by company count descending — most used first.
+             * @summary OeNACE classification catalog
              * @request GET:/api/v1/oenace
              * @secure
              */
@@ -357,11 +357,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all legal forms with pagination and optional search, sorted by business count descending.
              *
              * @tags LegalForms
              * @name V1LegalformsList
-             * @summary Returns all legal forms with pagination and optional search, sorted by business count descending.
+             * @summary Legal form catalog
              * @request GET:/api/v1/legalforms
              * @secure
              */
@@ -374,11 +374,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description The network of people and companies around one starting point — who sits on which board with whom. nodes are people ("person") and companies ("business"), each carrying the id you would pass to /people/{personId} or /businesses/{fnr}; edges are source/target pairs of those ids whose relationshipType is "assignment", a person holding a function in a company. ("address", two companies registered at the same street address, is a second edge type the deployment can enable; it is off today, so expect only assignment edges.) The traversal depth is fixed at 2 hops and is not a parameter — a node with further connections outside that boundary carries hasMore=true, and isCentralNode marks the entity you started from. personId and fnr are mutually exclusive, not combinable: supplying both, or neither, is a 400, and an id that exists in neither register is a 404.
+             * @description Returns the graph (nodes and edges) within 2 hops of the start entity. Exactly one of personId or fnr must be provided. The network of people and companies around one starting point — who sits on which board with whom. nodes are people ("person") and companies ("business"), each carrying the id you would pass to /people/{personId} or /businesses/{fnr}; edges are source/target pairs of those ids whose relationshipType is "assignment", a person holding a function in a company. ("address", two companies registered at the same street address, is a second edge type the deployment can enable; it is off today, so expect only assignment edges.) The traversal depth is fixed at 2 hops and is not a parameter — a node with further connections outside that boundary carries hasMore=true, and isCentralNode marks the entity you started from. personId and fnr are mutually exclusive, not combinable: supplying both, or neither, is a 400, and an id that exists in neither register is a 404.
              *
              * @tags Graph
              * @name V1GraphList
-             * @summary Returns the graph (nodes and edges) within 2 hops of the start entity. Exactly one of personId or fnr must be provided.
+             * @summary Relationship graph
              * @request GET:/api/v1/graph
              * @secure
              */
@@ -391,11 +391,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Each row carries only id, fnr, changeType and the dates; fetch the payload with GET /globalchanges/{id}, or poll one register's typed feed instead (/businesses/changes, /documents/changes, /edikte/changes, /trades/changes). Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id.
+             * @description The single feed of every change across all registers — Firmenbuch, GISA, Ediktsdatei and the BMF Scheinunternehmen list — as lightweight reference rows. Each row carries only id, fnr, changeType and the dates; fetch the payload with GET /globalchanges/{id}, or poll one register's typed feed instead (/businesses/changes, /documents/changes, /edikte/changes, /trades/changes). Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id.
              *
              * @tags GlobalChanges
              * @name V1GlobalchangesList
-             * @summary The single feed of every change across all registers — Firmenbuch, GISA, Ediktsdatei and the BMF Scheinunternehmen list — as lightweight reference rows.
+             * @summary All-register change feed
              * @request GET:/api/v1/globalchanges
              * @secure
              */
@@ -408,11 +408,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Built for watchlist polling: pass up to 1000 fnr values (repeat the parameter) and one cursor, and get back four arrays — businessChanges, documentChanges, ediktChanges, globalChanges — each ordered by ascending id and capped at maxResultsPerType. Not paged: raise maxResultsPerType or advance sinceId instead. sinceId is exclusive and since is inclusive, exactly as on the paged feeds, but one sinceId covers all four arrays: an array that comes back full at maxResultsPerType has more behind it and bounds the cursor, so advance sinceId only to the lowest of the full arrays' highest ids, and to the highest id of all four once none comes back full. Passing no fnr returns four empty arrays, not the whole feed.
+             * @description Changes for a watchlist of companies, all four change types in one unpaged response. Built for watchlist polling: pass up to 1000 fnr values (repeat the parameter) and one cursor, and get back four arrays — businessChanges, documentChanges, ediktChanges, globalChanges — each ordered by ascending id and capped at maxResultsPerType. Not paged: raise maxResultsPerType or advance sinceId instead. sinceId is exclusive and since is inclusive, exactly as on the paged feeds, but one sinceId covers all four arrays: an array that comes back full at maxResultsPerType has more behind it and bounds the cursor, so advance sinceId only to the lowest of the full arrays' highest ids, and to the highest id of all four once none comes back full. Passing no fnr returns four empty arrays, not the whole feed.
              *
              * @tags GlobalChanges
              * @name V1GlobalchangesAggregatedList
-             * @summary Changes for a watchlist of companies, all four change types in one unpaged response.
+             * @summary Aggregated watchlist changes
              * @request GET:/api/v1/globalchanges/aggregated
              * @secure
              */
@@ -425,11 +425,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description The envelope is a discriminator plus the payload: changeType says which register, and data is the matching object — a BusinessChange, DocumentChange, EdiktChange, GisaChange or ScheinunternehmenChange. Since data is a union, read changeType before it.
+             * @description Returns one change with its typed payload, whichever register it came from. The envelope is a discriminator plus the payload: changeType says which register, and data is the matching object — a BusinessChange, DocumentChange, EdiktChange, GisaChange or ScheinunternehmenChange. Since data is a union, read changeType before it.
              *
              * @tags GlobalChanges
              * @name V1GlobalchangesDetail
-             * @summary Returns one change with its typed payload, whichever register it came from.
+             * @summary Change by id
              * @request GET:/api/v1/globalchanges/{id}
              * @secure
              */
@@ -441,11 +441,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "edikt" answers 404 here.
+             * @description Returns one Ediktsdatei change by id. The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "edikt" answers 404 here.
              *
              * @tags Edikte
              * @name V1EdikteChangesDetail
-             * @summary Returns one Ediktsdatei change by id.
+             * @summary Edikt change by id
              * @request GET:/api/v1/edikte/changes/{id}
              * @secure
              */
@@ -457,11 +457,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on the publication date, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss an insolvency notice resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
+             * @description Feed of Ediktsdatei changes — insolvency and other court notices published about a company or a person. Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on the publication date, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss an insolvency notice resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
              *
              * @tags Edikte
              * @name V1EdikteChangesList
-             * @summary Feed of Ediktsdatei changes — insolvency and other court notices published about a company or a person.
+             * @summary Ediktsdatei change feed
              * @request GET:/api/v1/edikte/changes
              * @secure
              */
@@ -474,11 +474,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Downloads a Firmenbuch document (PDF/XML) by its document key.
              *
              * @tags Documents
              * @name V1DocumentsDownloadDetail
-             * @summary Downloads a Firmenbuch document (PDF/XML) by its document key.
+             * @summary Firmenbuch document download
              * @request GET:/api/v1/documents/download/{documentKey}
              * @secure
              */
@@ -489,11 +489,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "document" answers 404 here.
+             * @description Returns one document change by id, with the document's metadata. The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "document" answers 404 here.
              *
              * @tags Documents
              * @name V1DocumentsChangesDetail
-             * @summary Returns one document change by id, with the document's metadata.
+             * @summary Document change by id
              * @request GET:/api/v1/documents/changes/{id}
              * @secure
              */
@@ -505,11 +505,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Each entry names a documentKey; fetch the file itself with GET /documents/download/{documentKey}. Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on the document date, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
+             * @description Feed of newly filed Firmenbuch documents — this is how you learn that a company has published a new Jahresabschluss. Each entry names a documentKey; fetch the file itself with GET /documents/download/{documentKey}. Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on the document date, and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses.
              *
              * @tags Documents
              * @name V1DocumentsChangesList
-             * @summary Feed of newly filed Firmenbuch documents — this is how you learn that a company has published a new Jahresabschluss.
+             * @summary Document change feed
              * @request GET:/api/v1/documents/changes
              * @secure
              */
@@ -522,11 +522,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all courts with pagination and optional search, sorted by business count descending.
              *
              * @tags Courts
              * @name V1CourtsList
-             * @summary Returns all courts with pagination and optional search, sorted by business count descending.
+             * @summary Court catalog
              * @request GET:/api/v1/courts
              * @secure
              */
@@ -539,11 +539,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Resolve company names to FNRs by exact name match (1:1). Used for CSV import.
              *
              * @tags Businesses
              * @name V1BusinessesResolveNamesCreate
-             * @summary Resolve company names to FNRs by exact name match (1:1). Used for CSV import.
+             * @summary Name to FNR resolution
              * @request POST:/api/v1/businesses/resolve-names
              * @secure
              */
@@ -557,11 +557,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description name and search are different tools. name is a case-insensitive substring match on the company name and nothing else. search splits the term on spaces and keeps only companies matching every token, where a token matches the name, the fnr, or — when the whole term is a number — a GISA licence key or GISA-Zahl; it additionally lifts companies whose name starts with the term to the top of the default (name) ordering. So name narrows a known name, search finds an unknown one. Inactive companies always sort after active ones, whatever orderBy says. Pass countOnly=true for totalRecords without the rows, and use /businesses/aggregate to group the same filter set instead of paging through it.
+             * @description Lists companies matching the filters, one page of list rows per call. name and search are different tools. name is a case-insensitive substring match on the company name and nothing else. search splits the term on spaces and keeps only companies matching every token, where a token matches the name, the fnr, or — when the whole term is a number — a GISA licence key or GISA-Zahl; it additionally lifts companies whose name starts with the term to the top of the default (name) ordering. So name narrows a known name, search finds an unknown one. Inactive companies always sort after active ones, whatever orderBy says. Pass countOnly=true for totalRecords without the rows, and use /businesses/aggregate to group the same filter set instead of paging through it.
              *
              * @tags Businesses
              * @name V1BusinessesList
-             * @summary Lists companies matching the filters, one page of list rows per call.
+             * @summary Company search
              * @request GET:/api/v1/businesses
              * @secure
              */
@@ -574,11 +574,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all business (fnr, name) pairs for client-side name index. No pagination.
              *
              * @tags Businesses
              * @name V1BusinessesNamesList
-             * @summary Returns all business (fnr, name) pairs for client-side name index. No pagination.
+             * @summary Company name index
              * @request GET:/api/v1/businesses/names
              * @secure
              */
@@ -590,11 +590,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Unfiltered — it is the size of the whole dataset, not of a search. For a count over filters, call GET /businesses with countOnly=true and read totalRecords.
+             * @description Returns the number of companies in the dataset, as a bare integer. Unfiltered — it is the size of the whole dataset, not of a search. For a count over filters, call GET /businesses with countOnly=true and read totalRecords.
              *
              * @tags Businesses
              * @name V1BusinessesCountList
-             * @summary Returns the number of companies in the dataset, as a bare integer.
+             * @summary Company count
              * @request GET:/api/v1/businesses/count
              * @secure
              */
@@ -606,11 +606,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Counts over the same filter set as GET /businesses, grouped by one dimension — the server-side GROUP BY that a caller would otherwise page the whole result set to compute. Every /businesses filter means exactly what it means there; page, pageSize, orderBy, orderByDescending and countOnly are ignored — top and minCount cap the bucket list instead. totalRecords equals /businesses?countOnly=true for the same filter; how the buckets relate to it is documented on BusinessAggregateResponse.
              *
              * @tags Businesses
              * @name V1BusinessesAggregateList
-             * @summary Counts over the same filter set as GET /businesses, grouped by one dimension — the server-side GROUP BY that a caller would otherwise page the whole result set to compute. Every /businesses filter means exactly what it means there; page, pageSize, orderBy, orderByDescending and countOnly are ignored — top and minCount cap the bucket list instead. totalRecords equals /businesses?countOnly=true for the same filter; how the buckets relate to it is documented on BusinessAggregateResponse.
+             * @summary Grouped company counts
              * @request GET:/api/v1/businesses/aggregate
              * @secure
              */
@@ -623,11 +623,45 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Counts for every value of every filter group at once — what a filter builder puts on its chips. Takes the same filters as GET /businesses and means them the same way; page, pageSize, orderBy, orderByDescending and countOnly are ignored. Faceted semantics: a group is counted with all *other* active filters applied but its own lifted, so a value's count answers "how many results if I also select this", and selecting one never empties its own group. totalRecords is the current result count, with every filter applied. Each group returns its top values (top, default 10) plus every value the request already filters on, marked selected — a "Mehr" expander is a second call for that one group with a larger top, e.g. ?groups=city&top=50. city and zipCode count a business once per distinct value, so those counts can sum above totalRecords. One caveat worth knowing before wiring a chip up: the city filter matches a substring, while a city facet key is a whole city name, so selecting "Wien" also keeps "Wien-Umgebung" and can return more than the chip promised. Every other group matches its key exactly. Every group costs its own count, so ask for the groups you are rendering rather than all ten; the answer is cacheable for a day and varies on the whole query string.
+             *
+             * @tags Businesses
+             * @name V1BusinessesFacetsList
+             * @summary Filter-builder facet counts
+             * @request GET:/api/v1/businesses/facets
+             * @secure
+             */
+            v1BusinessesFacetsList: (query, params = {}) => this.request({
+                path: `/api/v1/businesses/facets`,
+                method: "GET",
+                query: query,
+                secure: true,
+                format: "json",
+                ...params,
+            }),
+            /**
+             * @description The single largest company of every place in the viewport, by one metric — what a map draws as one pin per place instead of every dot in the box. groupBy picks the place: state (the nine Bundesländer, the default) or city (the towns in view). metric is one of detailViews (Aufrufe), bilanzSumme or employees (Mitarbeiter). minLat, maxLat, minLng and maxLng are required for groupBy=city and ignored for groupBy=state: the nine Bundesländer are the same nine wherever the map is looking, so that call takes no viewport at all — which is what lets one URL serve every pan and actually be cached, here and in the browser. Every /businesses filter additionally applies and means exactly what it means there; page, pageSize, orderBy, orderByDescending and countOnly are ignored. groupLabel is the place's name — "Tirol", "Innsbruck" — and is what the pin's card is headed with. A company carrying no value for the metric is skipped rather than counted as 0, so a place holding only such companies — like an empty one — returns nothing at all and the array is shorter than the number of places. Each item carries everything a popover card shows, so no second call per pin is needed. groupBy=city answers at most 16 pins, the towns holding the most companies in view; the rest is what zooming in is for. Bundesländer are derived from the PLZ of the Geschäftsanschrift, the same rule the state filter on GET /businesses uses, because the Firmenbuch carries no Land. A company that is the biggest of two places in view wins both, each pin carrying an address that is actually on screen. Cached for an hour rather than the day GET /businesses gets: view counts move.
+             *
+             * @tags Businesses
+             * @name V1BusinessesMapTopList
+             * @summary Top company per Bundesland or city
+             * @request GET:/api/v1/businesses/map-top
+             * @secure
+             */
+            v1BusinessesMapTopList: (query, params = {}) => this.request({
+                path: `/api/v1/businesses/map-top`,
+                method: "GET",
+                query: query,
+                secure: true,
+                format: "json",
+                ...params,
+            }),
+            /**
+             * @description Active businesses similar to the given one (same OeNACE branch, same region preferred).
              *
              * @tags Businesses
              * @name V1BusinessesSimilarList
-             * @summary Active businesses similar to the given one (same OeNACE branch, same region preferred).
+             * @summary Similar companies
              * @request GET:/api/v1/businesses/{fnr}/similar
              * @secure
              */
@@ -639,11 +673,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description fnr is matched exactly against the stored, normalised Firmenbuchnummer — lower case, no spaces, no leading zeros and no "FN" prefix, e.g. 34853f. Nothing is normalised on the way in, so "FN 34853 f" answers 404 rather than the company. 404 also means the company is not in the dataset yet.
+             * @description Returns the whole Firmenakte of one company: master data, addresses, people, GISA licences, Edikte, documents and the parsed annual accounts. fnr is matched exactly against the stored, normalised Firmenbuchnummer — lower case, no spaces, no leading zeros and no "FN" prefix, e.g. 34853f. Nothing is normalised on the way in, so "FN 34853 f" answers 404 rather than the company. 404 also means the company is not in the dataset yet.
              *
              * @tags Businesses
              * @name V1BusinessesDetail
-             * @summary Returns the whole Firmenakte of one company: master data, addresses, people, GISA licences, Edikte, documents and the parsed annual accounts.
+             * @summary Company Firmenakte
              * @request GET:/api/v1/businesses/{fnr}
              * @secure
              */
@@ -655,11 +689,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "business" answers 404 here.
+             * @description Returns one Firmenbuch change by id. The id is the shared change id from GET /globalchanges, so an id that exists but whose changeType is not "business" answers 404 here.
              *
              * @tags Businesses
              * @name V1BusinessesChangesDetail
-             * @summary Returns one Firmenbuch change by id.
+             * @summary Firmenbuch change by id
              * @request GET:/api/v1/businesses/changes/{id}
              * @secure
              */
@@ -671,11 +705,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * @description Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate — so a back-dated entry is not missed — and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses. Use GET /globalchanges for the same feed across all four registers.
+             * @description Feed of Firmenbuch changes — one entry per new legal record (Eintragung). Ordered by ascending id, and that id is the cursor: request with sinceId set to the highest id you have stored, walk page=1,2,… at a fixed pageSize until a page comes back with fewer than pageSize rows, keep the highest id you saw, and start the next poll from it. sinceId is exclusive, so nothing is delivered twice, and a new change always takes a higher id than every change already in the feed, so it appends to the end and never shifts a page you have already read. since is inclusive, filters on when we recorded the change rather than on changedDate — so a back-dated entry is not missed — and applies together with sinceId when both are sent. Paging without sinceId is not a reliable feed: an offset is not a watermark, and page stops at 1000. Under concurrent writes a change can become visible just after a higher id, so a consumer that must not miss one resumes from the previous poll's watermark and de-duplicates by id. fnr is normalised before matching — trimmed, spaces and leading zeros removed, case left alone — so 034853 f and 34853f are the same company, exactly as on GET /businesses. Use GET /globalchanges for the same feed across all four registers.
              *
              * @tags Businesses
              * @name V1BusinessesChangesList
-             * @summary Feed of Firmenbuch changes — one entry per new legal record (Eintragung).
+             * @summary Firmenbuch change feed
              * @request GET:/api/v1/businesses/changes
              * @secure
              */
@@ -688,11 +722,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns all assignment functions (code/text lookup) for display. Cached 24h.
              *
              * @tags AssignmentFunctions
              * @name V1AssignmentfunctionsList
-             * @summary Returns all assignment functions (code/text lookup) for display. Cached 24h.
+             * @summary Assignment function catalog
              * @request GET:/api/v1/assignmentfunctions
              * @secure
              */
@@ -704,11 +738,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns unique City+ZipCode combinations from addresses with pagination and optional search.
              *
              * @tags Addresses
              * @name V1AddressesLocationsList
-             * @summary Returns unique City+ZipCode combinations from addresses with pagination and optional search.
+             * @summary City and ZIP combinations
              * @request GET:/api/v1/addresses/locations
              * @secure
              */
@@ -721,11 +755,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns unique cities from addresses with pagination and optional search.
              *
              * @tags Addresses
              * @name V1AddressesCitiesList
-             * @summary Returns unique cities from addresses with pagination and optional search.
+             * @summary Cities
              * @request GET:/api/v1/addresses/cities
              * @secure
              */
@@ -738,11 +772,11 @@ class Api extends HttpClient {
                 ...params,
             }),
             /**
-             * No description
+             * @description Returns unique zip codes from addresses with pagination and optional search.
              *
              * @tags Addresses
              * @name V1AddressesZipcodesList
-             * @summary Returns unique zip codes from addresses with pagination and optional search.
+             * @summary ZIP codes
              * @request GET:/api/v1/addresses/zipcodes
              * @secure
              */