{"openapi":"3.1.0","paths":{"/v1/companies":{"get":{"description":"Einfache Firmensuche. Diese Suche wird nicht auf das Monatskontingent angerechnet.","operationId":"PublicApiController_searchCompanies","parameters":[{"name":"query","required":true,"in":"query","description":"Firmenname, früherer Name oder Firmenbuchnummer. Die Suche liefert kompakte Treffer, kein vollständiges Profil.","schema":{"minLength":1,"maxLength":120,"example":"Firmenatlas","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl Treffer auf dieser Seite.","schema":{"minimum":1,"maximum":20,"default":10,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor aus der vorherigen Antwort unverändert übernehmen.","schema":{"example":"eyJvZmZzZXQiOjEwfQ","type":"string"}}],"responses":{"200":{"description":"Passende Unternehmen in absteigender Relevanz.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicCompanySearchDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Unternehmen suchen","tags":["Öffentliche API"]}},"/v1/companies/search":{"post":{"description":"Filtert Unternehmen nach öffentlichen deutschen Feldnamen und liefert nur die angeforderten Ergebnisfelder. Gültige Felder, Datentypen, Operatoren und Sortierbarkeit stehen unter GET /v1/company-search/fields. Diese Suche zählt zum Monatskontingent.","operationId":"PublicApiController_searchCompaniesAdvanced","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanyAdvancedSearchDto"}}}},"responses":{"200":{"description":"Gefilterte und projizierte Unternehmensdaten.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicCompanyAdvancedSearchDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Erweiterte Unternehmenssuche ausführen","tags":["Öffentliche API"]}},"/v1/company-search/fields":{"get":{"description":"Liefert den maßgeblichen Vertrag für POST /v1/companies/search: öffentliche Feldpfade, Labels, Datentypen, Einheiten, Filteroperatoren und Sortierbarkeit.","operationId":"PublicApiController_getCompanySearchFields","parameters":[],"responses":{"200":{"description":"Feldpfade, Datentypen, Einheiten und Operatoren.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicCompanySearchFieldsDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Filter- und Ergebnisfelder der Suche abrufen","tags":["Öffentliche API"]}},"/v1/company-search/facets":{"post":{"description":"Berechnet kategoriale Segmente und numerische Histogramme innerhalb derselben Filtermenge wie die erweiterte Suche.","operationId":"PublicApiController_getCompanySearchFacets","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompanySearchFacetsDto"}}}},"responses":{"200":{"description":"Kategorische Segmente und numerische Histogramme.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicCompanySearchFacetsDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Facetten für Unternehmensfilter abrufen","tags":["Öffentliche API"]}},"/v1/companies/{firmenbuchnummer}":{"get":{"description":"Lädt Registerdaten, die letzten Finanzkennzahlen und kompakte Beziehungskennzahlen. KI-recherchierte Unternehmensinformationen sind nicht Bestandteil dieses Standardabrufs. Vollständige Abschlüsse und Eigentümerbeziehungen haben eigene Endpunkte.","operationId":"PublicApiController_getCompany","parameters":[{"name":"firmenbuchnummer","required":true,"in":"path","description":"Österreichische Firmenbuchnummer ohne Leerzeichen. Sie kommt aus der Unternehmenssuche.","schema":{"example":"123456a","type":"string"}}],"responses":{"200":{"description":"Registerdaten, letzte Finanzkennzahlen und kompakte Beziehungskennzahlen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicCompanyDetailDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Unternehmensprofil abrufen","tags":["Öffentliche API"]}},"/v1/companies/{firmenbuchnummer}/financial-statements":{"get":{"description":"Liefert strukturierte Abschlüsse. Ohne years wird der neueste verfügbare Abschluss geladen; weitere Jahre können explizit oder über Pagination angefordert werden.","operationId":"PublicApiController_getFinancialStatements","parameters":[{"name":"firmenbuchnummer","required":true,"in":"path","description":"Firmenbuchnummer aus der Unternehmenssuche.","schema":{"example":"123456a","type":"string"}},{"name":"years","required":false,"in":"query","description":"Kommagetrennte Geschäftsjahre, maximal zwölf. Ohne years werden die neuesten verfügbaren Abschlüsse geladen.","schema":{"example":"2025,2024","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl ausgelieferter Jahresabschlüsse.","schema":{"minimum":1,"maximum":12,"default":1,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Cursor für weitere ältere Abschlüsse. Beim ersten Aufruf weglassen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Strukturierte Jahresabschlüsse mit deutschsprachigen Feldbezeichnungen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicFinancialStatementsDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Jahresabschlüsse und Finanzkennzahlen abrufen","tags":["Öffentliche API"]}},"/v1/companies/{firmenbuchnummer}/documents":{"get":{"description":"Erster Schritt des Downloads. Die Antwort enthält dokumentKey; damit wird anschließend POST /v1/documents/{documentKey}/download-link aufgerufen.","operationId":"PublicApiController_getDocuments","parameters":[{"name":"firmenbuchnummer","required":true,"in":"path","description":"Firmenbuchnummer aus der Unternehmenssuche.","schema":{"example":"123456a","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl Dokumente auf dieser Seite.","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor unverändert übernehmen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Metadaten der verfügbaren Dokumente.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicDocumentsDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Verfügbare Unternehmensdokumente auflisten","tags":["Öffentliche API"]}},"/v1/documents/{documentKey}/download-link":{"post":{"description":"Zweiter Schritt des Downloads. documentKey kommt aus der Dokumentliste und muss als URL-Pfadsegment URL-encodiert werden. Der erzeugte Link ist standardmäßig fünf Minuten gültig und enthält bereits die Download-Autorisierung.","operationId":"PublicApiController_createDownloadLink","parameters":[{"name":"documentKey","required":true,"in":"path","description":"Undurchsichtiger dokumentKey aus GET /v1/companies/{firmenbuchnummer}/documents; URL-encodiert einsetzen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Signierter Link zum Dokument-Download.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicDocumentDownloadLinkDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Kurzlebigen Download-Link erzeugen","tags":["Öffentliche API"]}},"/v1/companies/{firmenbuchnummer}/ownership":{"get":{"description":"Liefert direkte Beziehungen. owners sind Eigentümer des angefragten Unternehmens; holdings sind Unternehmen, an denen das angefragte Unternehmen beteiligt ist.","operationId":"PublicApiController_getOwnership","parameters":[{"name":"firmenbuchnummer","required":true,"in":"path","description":"Firmenbuchnummer des betrachteten Unternehmens.","schema":{"example":"123456a","type":"string"}},{"name":"direction","required":false,"in":"query","description":"owners liefert Eigentümer des Unternehmens, holdings dessen Beteiligungen, both beide Gruppen.","schema":{"default":"both","type":"string","enum":["owners","holdings","both"]}},{"name":"status","required":false,"in":"query","description":"current liefert aktuelle Beziehungen; all schließt historische Beziehungen ein.","schema":{"default":"current","type":"string","enum":["current","all"]}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl Beziehungen auf dieser Seite.","schema":{"minimum":1,"maximum":100,"default":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor unverändert übernehmen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Direkte Eigentümer- und Beteiligungsbeziehungen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicOwnershipDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Eigentümer und Beteiligungen abrufen","tags":["Öffentliche API"]}},"/v1/companies/{firmenbuchnummer}/ownership-graph":{"get":{"description":"Eine Kante zeigt immer vom Eigentümer zum Beteiligungsziel. upstream verfolgt Eigentümer, downstream Beteiligungen. Es gelten die UI-Grenzen von Tiefe 3, 200 Knoten und 5.000 Kanten; abgeschnitten und abbruchgruende erklären Teilgraphen.","operationId":"PublicApiController_getOwnershipGraph","parameters":[{"name":"firmenbuchnummer","required":true,"in":"path","description":"Firmenbuchnummer des Wurzelunternehmens (Tiefe 0).","schema":{"example":"123456a","type":"string"}},{"name":"direction","required":false,"in":"query","description":"upstream verfolgt Eigentümer nach oben, downstream Beteiligungen nach unten, both beide Richtungen.","schema":{"default":"both","type":"string","enum":["upstream","downstream","both"]}},{"name":"depth","required":false,"in":"query","description":"Automatische Expansionstiefe ab der Wurzel. Der Wurzelknoten hat Tiefe 0.","schema":{"minimum":1,"maximum":3,"default":3,"type":"number"}},{"name":"status","required":false,"in":"query","description":"current liefert den aktuellen Graphen; all schließt historische Beziehungen ein.","schema":{"default":"current","type":"string","enum":["current","all"]}}],"responses":{"200":{"description":"UI-konformer Eigentümergraph mit Knoten, Kanten und Abbruchgründen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicOwnershipGraphDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Mehrstufigen Eigentümergraph abrufen","tags":["Öffentliche API"]}},"/v1/people":{"get":{"description":"Sucht Personen nach Namen und optionalem Geburtsjahr. Die Antwort liefert die undurchsichtige personId für Personenprofil und Netzwerk. Diese Suche zählt nicht zum Monatskontingent.","operationId":"PublicApiController_searchPeople","parameters":[{"name":"query","required":true,"in":"query","description":"Name der gesuchten Person. Die Antwort liefert die personId für Profil und Netzwerk.","schema":{"minLength":2,"maxLength":120,"example":"Max Mustermann","type":"string"}},{"name":"birthYear","required":false,"in":"query","description":"Optionales Geburtsjahr zur Unterscheidung gleichnamiger Personen.","schema":{"minimum":1800,"maximum":2200,"example":1975,"type":"number"}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl Treffer auf dieser Seite.","schema":{"minimum":1,"maximum":20,"default":10,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor unverändert übernehmen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Eindeutig referenzierbare Personen mit aktuellen Kennzahlen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicPeopleSearchDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Personen suchen","tags":["Öffentliche API"]}},"/v1/people/{personId}":{"get":{"description":"Liefert Funktionen, persönliche Beteiligungen, verbundene Unternehmen und Kennzahlen. personId muss zuvor über GET /v1/people ermittelt werden.","operationId":"PublicApiController_getPersonProfile","parameters":[{"name":"personId","required":true,"in":"path","description":"Undurchsichtige personId aus der Personensuche; unverändert übernehmen.","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","description":"current liefert aktuelle Funktionen und Beteiligungen; all zusätzlich historische Einträge.","schema":{"default":"current","type":"string","enum":["current","all"]}},{"name":"limit","required":false,"in":"query","description":"Maximale Anzahl Beziehungen auf dieser Seite.","schema":{"minimum":1,"maximum":100,"default":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor unverändert übernehmen.","schema":{"type":"string"}}],"responses":{"200":{"description":"Funktionen, Beteiligungen und sichtbare Unternehmensverbindungen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicPersonProfileDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Personenprofil abrufen","tags":["Öffentliche API"]}},"/v1/people/{personId}/relationship-graph":{"get":{"description":"Beginnt bei der Person, ergänzt direkt verbundene Unternehmen und dort verbundene Personen. Verbundene Personen werden nicht rekursiv expandiert; für weitere Tiefe wird deren personId als neue Wurzel aufgerufen.","operationId":"PublicApiController_getPersonRelationshipGraph","parameters":[{"name":"personId","required":true,"in":"path","description":"Undurchsichtige personId aus der Personensuche; unverändert übernehmen.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximale Zahl direkter Netzwerkbeziehungen auf dieser Seite.","schema":{"minimum":1,"maximum":100,"default":100,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"Beim ersten Aufruf weglassen. Danach meta.nextCursor unverändert übernehmen.","schema":{"type":"string"}}],"responses":{"200":{"description":"UI-konformes Netzwerk mit direkten Unternehmen und verbundenen Personen.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicPersonRelationshipGraphDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Personen-/Firmennetzwerk abrufen","tags":["Öffentliche API"]}},"/v1/lists":{"get":{"description":"Liefert die accountweiten Listen. Optional kann nach Listen gefiltert werden, die eine bestimmte Firmenbuchnummer enthalten.","operationId":"PublicApiController_listLists","parameters":[{"name":"firmenbuchnummer","required":false,"in":"query","description":"Optional nur Listen zurückgeben, die dieses Unternehmen enthalten.","schema":{"example":"123456a","type":"string"}}],"responses":{"200":{"description":"Listen des Accounts.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicListsDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Eigene Unternehmenslisten abrufen","tags":["Öffentliche API"]},"post":{"description":"Legt eine neue accountweite Liste an. Die zurückgegebene listenId wird für weitere Listenoperationen verwendet.","operationId":"PublicApiController_createList","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCreateListDto"}}}},"responses":{"200":{"description":"Neu angelegte Liste.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicListSummaryDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Unternehmensliste anlegen","tags":["Öffentliche API"]}},"/v1/lists/{listId}":{"get":{"description":"Liefert die Liste, ihre Unternehmen und die kompakte letzte Finanzansicht. listId kommt aus GET oder POST /v1/lists.","operationId":"PublicApiController_getList","parameters":[{"name":"listId","required":true,"in":"path","description":"listenId aus GET oder POST /v1/lists.","schema":{"type":"string"}}],"responses":{"200":{"description":"Liste und analytisch angereicherte Einträge.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicListDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Liste mit Unternehmen abrufen","tags":["Öffentliche API"]}},"/v1/lists/{listId}/items":{"post":{"description":"Fügt ein über seine Firmenbuchnummer identifiziertes Unternehmen und optional einen accountweit sichtbaren Kommentar hinzu.","operationId":"PublicApiController_addListItem","parameters":[{"name":"listId","required":true,"in":"path","description":"listenId aus GET oder POST /v1/lists.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAddListItemDto"}}}},"responses":{"200":{"description":"Angelegter Listeneintrag.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicListMutationDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Unternehmen zu Liste hinzufügen","tags":["Öffentliche API"]}},"/v1/lists/{listId}/items/{itemId}":{"delete":{"description":"Entfernt genau den angegebenen Listeneintrag. itemId kommt aus GET /v1/lists/{listId}.","operationId":"PublicApiController_removeListItem","parameters":[{"name":"listId","required":true,"in":"path","description":"listenId der betroffenen Liste.","schema":{"type":"string"}},{"name":"itemId","required":true,"in":"path","description":"eintragId aus GET /v1/lists/{listId}.","schema":{"type":"string"}}],"responses":{"200":{"description":"Löschbestätigung.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicListRemovalDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Unternehmen aus Liste entfernen","tags":["Öffentliche API"]}},"/v1/usage":{"get":{"description":"Liefert das gemeinsame monatliche REST-/MCP-Kontingent und die gezählten Operationen. Einfache Firmen- und Personensuchen zählen nicht; erfolgreiche Datenabrufe und erweiterte Suchen grundsätzlich einmal.","operationId":"PublicApiController_getUsage","parameters":[],"responses":{"200":{"description":"Nutzung und aktuelle Limits.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublicUsageDataDto"},"meta":{"$ref":"#/components/schemas/PublicApiMetaDto"}}}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"403":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}},"429":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"security":[{"firmenatlasApiKey":[]}],"summary":"Aktuelles API-Kontingent abrufen","tags":["Öffentliche API"]}},"/v1/document-downloads/{token}":{"get":{"operationId":"PublicDocumentDownloadController_download","parameters":[{"name":"token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Das angeforderte Dokument.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiErrorResponseDto"}}}}},"summary":"Dokument über einen signierten, kurzlebigen Link herunterladen","tags":["Dokumente"]}}},"info":{"title":"Firmenatlas API","description":"Öffentliche Schnittstelle für österreichische Unternehmens-, Finanz-, Beteiligungs- und Personendaten. Fachliche Guides, ID-Herkunft und vollständige Beispiele stehen in der Firmenatlas Entwicklerdokumentation.","version":"1.0","contact":{}},"tags":[],"servers":[{"url":"https://api.firmenatlas.com"}],"components":{"securitySchemes":{"firmenatlasApiKey":{"scheme":"bearer","bearerFormat":"Firmenatlas API Key","type":"http","description":"Den vollständigen API-Key aus der Firmenatlas Accountverwaltung eingeben (fa_api_...). In der späteren Accountansicht ist nur noch sichtbar, auf welche vier Zeichen der Key endet. Ist der vollständige Key nicht mehr vorhanden, muss er rotiert werden."}},"schemas":{"PublicApiErrorBodyDto":{"type":"object","properties":{"code":{"type":"string","example":"INVALID_REQUEST"},"message":{"type":"string","example":"Die Anfrage ist ungültig."},"details":{"type":"object","additionalProperties":true},"requestId":{"type":"string","example":"req_d2d75c86-4d23-44d7-92fd-563352cc2553"}},"required":["code","message","details","requestId"]},"PublicApiErrorResponseDto":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/PublicApiErrorBodyDto"}},"required":["error"]},"PublicCompanySearchHitDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","example":"123456a"},"name":{"type":"string","example":"Beispiel GmbH"},"sitz":{"type":["object","null"],"example":"Wien"},"rechtsform":{"type":["object","null"],"example":"Gesellschaft mit beschränkter Haftung"},"status":{"type":["object","null"],"example":"Aktiv"},"trefferGrund":{"type":"string","enum":["name","fruehererName"]},"fruehererName":{"type":["object","null"]}},"required":["firmenbuchnummer","name","sitz","rechtsform","status","trefferGrund"]},"PublicCompanySearchDataDto":{"type":"object","properties":{"suchbegriff":{"type":"string","example":"Firmenatlas"},"unternehmen":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanySearchHitDto"}}},"required":["suchbegriff","unternehmen"]},"PublicApiMetaDto":{"type":"object","properties":{"requestId":{"type":"string","example":"req_d2d75c86-4d23-44d7-92fd-563352cc2553"},"generatedAt":{"type":"string","example":"2026-08-18T18:30:00.000Z"},"limit":{"type":"number","example":20},"nextCursor":{"type":["object","null"],"example":"eyJvZmZzZXQiOjIwfQ"},"hasMore":{"type":"boolean","example":false}},"required":["requestId","generatedAt"]},"PublicAnalyticsFinancialYearDto":{"type":"object","properties":{"geschaeftsjahr":{"type":["object","null"]},"geschaeftsjahrBeginn":{"type":["object","null"]},"geschaeftsjahrEnde":{"type":["object","null"]},"umsatzerloese":{"type":["object","null"]},"bilanzsumme":{"type":["object","null"]},"eigenkapital":{"type":["object","null"]},"jahresueberschuss":{"type":["object","null"]},"ebit":{"type":["object","null"]},"ebitMarge":{"type":["object","null"]},"gewinnvortrag":{"type":["object","null"]},"bilanzgewinn":{"type":["object","null"]},"laufendesErgebnis":{"type":["object","null"]},"ergebnisVorSteuern":{"type":["object","null"]},"finanzerfolg":{"type":["object","null"]},"eigenkapitalquote":{"type":["object","null"]},"nettomarge":{"type":["object","null"]},"liquiditaetGrad1":{"type":["object","null"]},"personalaufwand":{"type":["object","null"]},"materialaufwand":{"type":["object","null"]},"workingCapital":{"type":["object","null"]},"mitarbeiterGesamt":{"type":["object","null"]},"arbeiter":{"type":["object","null"]},"angestellte":{"type":["object","null"]},"lehrlinge":{"type":["object","null"]},"mitarbeiterQuelle":{"type":["object","null"]},"anlagevermoegen":{"type":["object","null"]},"immaterielleVermoegenswerte":{"type":["object","null"]},"sachanlagen":{"type":["object","null"]},"finanzanlagen":{"type":["object","null"]},"umlaufvermoegen":{"type":["object","null"]},"vorraete":{"type":["object","null"]},"forderungen":{"type":["object","null"]},"kurzfristigeForderungen":{"type":["object","null"]},"langfristigeForderungen":{"type":["object","null"]},"wertpapiere":{"type":["object","null"]},"liquideMittel":{"type":["object","null"]},"aktiveRechnungsabgrenzung":{"type":["object","null"]},"verbindlichkeiten":{"type":["object","null"]},"kurzfristigeVerbindlichkeiten":{"type":["object","null"]},"langfristigeVerbindlichkeiten":{"type":["object","null"]},"rueckstellungen":{"type":["object","null"]},"verbindlichkeitenAusLieferungenUndLeistungen":{"type":["object","null"]},"passiveRechnungsabgrenzung":{"type":["object","null"]},"stammkapital":{"type":["object","null"]},"kapitalruecklagen":{"type":["object","null"]},"gewinnruecklagen":{"type":["object","null"]},"abschreibungen":{"type":["object","null"]},"bestandsveraenderung":{"type":["object","null"]},"aktivierteEigenleistungen":{"type":["object","null"]},"sonstigeErtraege":{"type":["object","null"]},"sonstigeAufwendungen":{"type":["object","null"]},"zinsenertraege":{"type":["object","null"]},"zinsaufwendungen":{"type":["object","null"]},"betriebsergebnis":{"type":["object","null"]},"personalquote":{"type":["object","null"]},"materialquote":{"type":["object","null"]},"umsatzwachstum":{"type":["object","null"]}}},"PublicCompanyAnalyticsItemDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string"},"name":{"type":"string"},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"status":{"type":["object","null"]},"letztesGeschaeftsjahr":{"$ref":"#/components/schemas/PublicAnalyticsFinancialYearDto"},"finanzhistorie":{"type":"array","items":{"$ref":"#/components/schemas/PublicAnalyticsFinancialYearDto"}}},"required":["firmenbuchnummer","name"]},"PublicCompanyAdvancedSearchDataDto":{"type":"object","properties":{"unternehmen":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanyAnalyticsItemDto"}},"gesamt":{"type":"number"},"seite":{"type":"number"},"seitengroesse":{"type":"number"},"maximalAbrufbar":{"type":"number"},"ausgelieferteFelder":{"type":"array","items":{"type":"string"}},"ignorierteFelder":{"type":"array","items":{"type":"string"}},"angewendeteHistorienjahre":{"type":"number","minimum":1,"maximum":20}},"required":["unternehmen","gesamt","seite","seitengroesse","maximalAbrufbar","ausgelieferteFelder","ignorierteFelder"]},"PublicCompanySearchSortDto":{"type":"object","properties":{"field":{"type":"string","description":"Öffentlicher, sortierbarer Feldpfad aus GET /v1/company-search/fields.","example":"letztesGeschaeftsjahr.bilanzsumme"},"order":{"type":"string","description":"Aufsteigende oder absteigende Sortierung.","enum":["asc","desc"],"default":"desc"}}},"PublicCompanyAdvancedSearchDto":{"type":"object","properties":{"filters":{"type":"object","description":"Filter mit öffentlichen deutschen Feldnamen. Zulässige Felder, Werte und Operatoren liefert GET /v1/company-search/fields.","additionalProperties":true,"example":{"rechtsformen":["Gesellschaft mit beschränkter Haftung"],"bundeslaender":["Wien"],"bilanzsumme":{"min":1000000}}},"fields":{"description":"Gewünschte öffentliche Ergebnisfelder, maximal 64. Unbekannte Felder werden unter ignorierteFelder genannt.","maxItems":64,"example":["firmenbuchnummer","name","letztesGeschaeftsjahr.bilanzsumme"],"type":"array","items":{"type":"string"}},"sort":{"description":"Optionale Sortierung nach einem freigegebenen Feld.","allOf":[{"$ref":"#/components/schemas/PublicCompanySearchSortDto"}]},"page":{"type":"number","description":"Seitennummer, beginnend bei 1.","minimum":1,"default":1},"pageSize":{"type":"number","description":"Ergebnisse pro Seite.","minimum":1,"maximum":100,"default":50},"historyYearsLimit":{"type":"number","description":"Maximale Zahl historischer Finanzjahre, wenn historische Ergebnisfelder angefordert werden.","minimum":1,"maximum":20,"default":5}}},"PublicCompanySearchFieldDescriptorDto":{"type":"object","properties":{"pfad":{"type":"string"},"bezeichnung":{"type":"string"},"beschreibung":{"type":"string"},"kategorie":{"type":"string","enum":["identitaet","unternehmen","letztesGeschaeftsjahr","historie"]},"datentyp":{"type":"string","enum":["string","number","object","array"]},"einheit":{"type":["string","null"],"enum":["EUR","Prozent","Anzahl","Jahr"]},"sortierbar":{"type":"boolean"},"filteroperatoren":{"type":"array","items":{"type":"string"}},"standard":{"type":"boolean"},"immerEnthalten":{"type":"boolean"}},"required":["pfad","bezeichnung","beschreibung","kategorie","datentyp","einheit","sortierbar","filteroperatoren","standard","immerEnthalten"]},"PublicCompanySearchFilterDescriptorDto":{"type":"object","properties":{"pfad":{"type":"string"},"bezeichnung":{"type":"string"},"beschreibung":{"type":"string"},"datentyp":{"type":"string","enum":["string","string[]","number[]","boolean","range"]},"operatoren":{"type":"array","items":{"type":"string"}},"einheit":{"type":["string","null"],"enum":["EUR","Prozent","Anzahl","Jahr"]},"sortierbar":{"type":"boolean"}},"required":["pfad","bezeichnung","beschreibung","datentyp","operatoren","einheit","sortierbar"]},"PublicCompanySearchFieldsDataDto":{"type":"object","properties":{"ergebnisfelder":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanySearchFieldDescriptorDto"}},"standardErgebnisfelder":{"type":"array","items":{"type":"string"}},"filterfelder":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanySearchFilterDescriptorDto"}},"sortierreihenfolgen":{"type":"array","items":{"type":"string","enum":["asc","desc"]}}},"required":["ergebnisfelder","standardErgebnisfelder","filterfelder","sortierreihenfolgen"]},"PublicSegmentDto":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"count":{"type":"number"},"percentage":{"type":"number"}},"required":["key","label","count","percentage"]},"PublicSearchSegmentsDto":{"type":"object","properties":{"rechtsformen":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"geschaeftsjahre":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"status":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"bundeslaender":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"vertretungsfunktionen":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"eigentuemerzusammensetzung":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"gisaWortlaute":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"gisaIndustriebetrieb":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"insolvenzstatus":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}},"edikteStatus":{"type":"array","items":{"$ref":"#/components/schemas/PublicSegmentDto"}}},"required":["rechtsformen","geschaeftsjahre","status","bundeslaender","vertretungsfunktionen","eigentuemerzusammensetzung","gisaWortlaute","gisaIndustriebetrieb","insolvenzstatus","edikteStatus"]},"PublicHistogramBucketDto":{"type":"object","properties":{"from":{"type":["number","null"]},"to":{"type":["number","null"]},"label":{"type":"string"},"count":{"type":"number"},"percentage":{"type":"number"}},"required":["label","count","percentage"]},"PublicSearchHistogramsDto":{"type":"object","properties":{"umsatzerloese":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"bilanzsumme":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"eigenkapital":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"ebitMarge":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"nettomarge":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"eigenkapitalquote":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"bilanzgewinn":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"laufendesErgebnis":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"liquiditaetGrad1":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"liquiditaetGrad2":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"liquiditaetGrad3":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"verschuldungsgrad":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"workingCapital":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"workingCapitalQuote":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"umsatzwachstum":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"eigenkapitalwachstum":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"personalquote":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}},"materialquote":{"type":"array","items":{"$ref":"#/components/schemas/PublicHistogramBucketDto"}}}},"PublicOenaceNodeDto":{"type":"object","properties":{"id":{"type":"string"},"parentId":{"type":["object","null"]},"level":{"type":"number"},"code":{"type":"string"},"label":{"type":"string"},"companyCount":{"type":"number"},"children":{"type":"array","items":{"$ref":"#/components/schemas/PublicOenaceNodeDto"}}},"required":["id","parentId","level","code","label","companyCount","children"]},"PublicCompanySearchFacetsDataDto":{"type":"object","properties":{"gesamtUnternehmen":{"type":"number"},"segmente":{"$ref":"#/components/schemas/PublicSearchSegmentsDto"},"histogramme":{"$ref":"#/components/schemas/PublicSearchHistogramsDto"},"oenace":{"type":"array","items":{"$ref":"#/components/schemas/PublicOenaceNodeDto"}}},"required":["gesamtUnternehmen","segmente","histogramme","oenace"]},"PublicCompanySearchFacetsDto":{"type":"object","properties":{"filters":{"type":"object","description":"Dieselben öffentlichen Filter wie bei POST /v1/companies/search. Die Facetten werden innerhalb dieser Ergebnismenge berechnet.","additionalProperties":true,"example":{"bundeslaender":["Wien"]}}}},"PublicCompanyAddressDto":{"type":"object","properties":{"adresszeile":{"type":["object","null"]},"vollstaendig":{"type":["object","null"]},"postleitzahl":{"type":["object","null"]},"ort":{"type":["object","null"]},"land":{"type":["object","null"]}},"required":["adresszeile","vollstaendig","postleitzahl","ort","land"]},"PublicCompanyLegalFormDto":{"type":"object","properties":{"code":{"type":["object","null"],"example":"GMBH"},"bezeichnung":{"type":["object","null"],"example":"Gesellschaft mit beschränkter Haftung"}},"required":["code","bezeichnung"]},"PublicRepresentativeDto":{"type":"object","properties":{"name":{"type":"string"},"funktion":{"type":["object","null"]},"vertretungsbefugnis":{"type":["object","null"]},"seit":{"type":["object","null"]},"personId":{"type":["object","null"]},"geburtsdatum":{"type":["object","null"],"description":"Geburtsdatum, soweit verfügbar."}},"required":["name","funktion","vertretungsbefugnis","seit","personId","geburtsdatum"]},"PublicCompanyDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","example":"123456a"},"name":{"type":"string","example":"Beispiel GmbH"},"unternehmensgegenstand":{"type":["object","null"]},"adresse":{"$ref":"#/components/schemas/PublicCompanyAddressDto"},"sitz":{"type":["object","null"]},"rechtsform":{"$ref":"#/components/schemas/PublicCompanyLegalFormDto"},"euid":{"type":["object","null"]},"firmenbuchgericht":{"type":["object","null"]},"status":{"type":"string"},"vertretungsbefugte":{"type":"array","items":{"$ref":"#/components/schemas/PublicRepresentativeDto"}},"zweigniederlassungen":{"type":"array","items":{"type":"object","additionalProperties":true}},"namenshistorie":{"type":"array","items":{"type":"object","additionalProperties":true}},"registerereignisse":{"type":"array","items":{"type":"object","additionalProperties":true}},"registerstatistik":{"type":"object","additionalProperties":true},"stichtag":{"type":["object","null"]},"abgerufenAm":{"type":["object","null"],"format":"date-time"}},"required":["firmenbuchnummer","name","unternehmensgegenstand","adresse","sitz","rechtsform","euid","firmenbuchgericht","status","vertretungsbefugte","zweigniederlassungen","namenshistorie","registerereignisse","registerstatistik","stichtag","abgerufenAm"]},"PublicLatestFinancialsDto":{"type":"object","properties":{"geschaeftsjahr":{"type":["object","null"]},"bilanzsumme":{"type":["object","null"]},"bilanzsummeVeraenderungProzent":{"type":["object","null"]},"bilanzgewinn":{"type":["object","null"]},"bilanzgewinnVeraenderungProzent":{"type":["object","null"]},"laufendesErgebnis":{"type":["object","null"]},"laufendesErgebnisVeraenderungProzent":{"type":["object","null"]},"eigenkapitalquote":{"type":["object","null"]},"strukturierteFinanzdatenVorhanden":{"type":"boolean"}},"required":["geschaeftsjahr","bilanzsumme","bilanzsummeVeraenderungProzent","bilanzgewinn","bilanzgewinnVeraenderungProzent","laufendesErgebnis","laufendesErgebnisVeraenderungProzent","eigenkapitalquote","strukturierteFinanzdatenVorhanden"]},"PublicCompanyDetailDataDto":{"type":"object","properties":{"unternehmen":{"$ref":"#/components/schemas/PublicCompanyDto"},"letzteFinanzkennzahlen":{"type":["object","null"],"allOf":[{"$ref":"#/components/schemas/PublicLatestFinancialsDto"}]},"beziehungskennzahlen":{"type":"object","properties":{"anzahlAktuellerEigentuemer":{"type":"integer"},"anzahlAktuellerBeteiligungen":{"type":"integer"},"hatPersonenAlsEigentuemer":{"type":"boolean"},"hatUnternehmenAlsEigentuemer":{"type":"boolean"}}},"aktualitaet":{"type":"object","properties":{"registerdatenStand":{"type":["string","null"]},"registerdatenAbgerufenAm":{"type":["string","null"],"format":"date-time"}}}},"required":["unternehmen","letzteFinanzkennzahlen","beziehungskennzahlen","aktualitaet"]},"PublicFinancialStatementDto":{"type":"object","properties":{"geschaeftsjahrBeginn":{"type":"string","example":"2025-01-01"},"geschaeftsjahrEnde":{"type":"string","example":"2025-12-31"},"waehrung":{"type":"string","example":"EUR"},"bilanz":{"type":["object","null"],"additionalProperties":{"type":["number","null"]},"description":"Bilanzpositionen mit deutschsprachigen Fachbezeichnungen."},"gewinnUndVerlustrechnung":{"type":["object","null"],"additionalProperties":{"type":["number","null"]},"description":"Positionen der Gewinn- und Verlustrechnung."},"kennzahlen":{"type":"object","additionalProperties":true},"mitarbeiter":{"type":["object","null"],"additionalProperties":true},"freiePositionen":{"type":"array","items":{"type":"object","additionalProperties":true}},"quelle":{"type":["object","null"],"additionalProperties":true}},"required":["geschaeftsjahrBeginn","geschaeftsjahrEnde","waehrung","bilanz","gewinnUndVerlustrechnung","kennzahlen","mitarbeiter","freiePositionen","quelle"]},"PublicFinancialStatementsDataDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","example":"123456a"},"verfuegbareGeschaeftsjahre":{"example":[2025,2024],"type":"array","items":{"type":"number"}},"ausgelieferteGeschaeftsjahre":{"example":[2025],"type":"array","items":{"type":"number"}},"fehlendeGeschaeftsjahre":{"example":[2022],"description":"Explizit angeforderte Geschäftsjahre, für die keine Daten vorliegen.","type":"array","items":{"type":"number"}},"weitereGeschaeftsjahreVorhanden":{"type":"boolean","description":"Gibt an, ob neben den ausgelieferten noch weitere Geschäftsjahre verfügbar sind."},"abschluesse":{"type":"array","items":{"$ref":"#/components/schemas/PublicFinancialStatementDto"}}},"required":["firmenbuchnummer","verfuegbareGeschaeftsjahre","ausgelieferteGeschaeftsjahre","fehlendeGeschaeftsjahre","weitereGeschaeftsjahreVorhanden","abschluesse"]},"PublicDocumentDto":{"type":"object","properties":{"dokumentKey":{"type":"string"},"dokumentart":{"type":"string"},"dokumentartCode":{"type":["object","null"]},"abschlussstichtag":{"type":["object","null"]},"eingereichtAm":{"type":["object","null"]},"dateigroesseBytes":{"type":["object","null"]},"mimeType":{"type":["object","null"]},"dateiendung":{"type":["object","null"]},"geschaeftszahl":{"type":["object","null"]},"bemerkung":{"type":["object","null"]},"kategorie":{"type":["object","null"]},"neuereVersionVorhanden":{"type":"boolean"}},"required":["dokumentKey","dokumentart","dokumentartCode","abschlussstichtag","eingereichtAm","dateigroesseBytes","mimeType","dateiendung","geschaeftszahl","bemerkung","kategorie","neuereVersionVorhanden"]},"PublicDocumentsDataDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","example":"123456a"},"dokumente":{"type":"array","items":{"$ref":"#/components/schemas/PublicDocumentDto"}}},"required":["firmenbuchnummer","dokumente"]},"PublicDocumentDownloadLinkDataDto":{"type":"object","properties":{"downloadUrl":{"type":"string","format":"uri"},"gueltigBis":{"type":"string","format":"date-time"},"ttlSekunden":{"type":"number","example":300}},"required":["downloadUrl","gueltigBis","ttlSekunden"]},"PublicOwnershipEntityDto":{"type":"object","properties":{"typ":{"type":"string","enum":["unternehmen","person","sonstigeOrganisation"]},"id":{"type":"string"},"name":{"type":"string"},"firmenbuchnummer":{"type":["object","null"]},"geburtsjahr":{"type":["object","null"]}},"required":["typ","id","name","firmenbuchnummer"]},"PublicOwnershipRelationDto":{"type":"object","properties":{"beziehungsId":{"type":"string"},"eigentuemer":{"$ref":"#/components/schemas/PublicOwnershipEntityDto"},"beteiligungsziel":{"$ref":"#/components/schemas/PublicOwnershipEntityDto"},"anteilProzent":{"type":["object","null"]},"anteilText":{"type":["object","null"]},"beziehungsart":{"type":["object","null"]},"bezeichnung":{"type":["object","null"]},"gueltigVon":{"type":["object","null"]},"gueltigBis":{"type":["object","null"]},"aktuell":{"type":"boolean"}},"required":["beziehungsId","eigentuemer","beteiligungsziel","anteilProzent","anteilText","beziehungsart","bezeichnung","gueltigVon","gueltigBis","aktuell"]},"PublicOwnershipDataDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","example":"123456a"},"eigentuemer":{"type":"array","items":{"$ref":"#/components/schemas/PublicOwnershipRelationDto"}},"beteiligungen":{"type":"array","items":{"$ref":"#/components/schemas/PublicOwnershipRelationDto"}},"aktualitaet":{"type":"object","properties":{"zuletztGeprueftAm":{"type":["string","null"],"format":"date-time"}}}},"required":["firmenbuchnummer","eigentuemer","beteiligungen","aktualitaet"]},"PublicGraphNodeDto":{"type":"object","properties":{"id":{"type":"string"},"typ":{"type":"string","enum":["unternehmen","person","sonstigeOrganisation"]},"name":{"type":"string"},"firmenbuchnummer":{"type":["object","null"]},"personId":{"type":["object","null"]},"geburtsdatum":{"type":["object","null"]},"geburtsjahr":{"type":["object","null"]},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"kurzbeschreibung":{"type":["object","null"]},"tiefe":{"type":"number"}},"required":["id","typ","name","tiefe"]},"PublicGraphOwnershipEntityDto":{"type":"object","properties":{"typ":{"type":"string","enum":["unternehmen","person","sonstigeOrganisation"]},"id":{"type":"string"},"name":{"type":"string"},"firmenbuchnummer":{"type":["object","null"]},"geburtsjahr":{"type":["object","null"]}},"required":["typ","id","name","firmenbuchnummer"]},"PublicGraphEdgeDto":{"type":"object","properties":{"beziehungsId":{"type":"string"},"typ":{"type":"string"},"vonKnotenId":{"type":"string"},"zuKnotenId":{"type":"string"},"eigentuemer":{"$ref":"#/components/schemas/PublicGraphOwnershipEntityDto"},"beteiligungsziel":{"$ref":"#/components/schemas/PublicGraphOwnershipEntityDto"},"anteilProzent":{"type":["object","null"]},"anteilText":{"type":["object","null"]},"beziehungsart":{"type":["object","null"]},"bezeichnung":{"type":["object","null"]},"gueltigVon":{"type":["object","null"]},"gueltigBis":{"type":["object","null"]},"aktuell":{"type":"boolean"},"funktion":{"type":["object","null"]},"vertretungsbefugnis":{"type":["object","null"]},"seit":{"type":["object","null"]},"beschreibung":{"type":["object","null"]}},"required":["beziehungsId","vonKnotenId","zuKnotenId"]},"PublicOwnershipGraphDataDto":{"type":"object","properties":{"wurzelId":{"type":"string"},"richtung":{"type":"string","enum":["upstream","downstream","both"]},"angeforderteTiefe":{"type":"number"},"erreichteTiefe":{"type":"number"},"knoten":{"type":"array","items":{"$ref":"#/components/schemas/PublicGraphNodeDto"}},"kanten":{"type":"array","items":{"$ref":"#/components/schemas/PublicGraphEdgeDto"}},"abgeschnitten":{"type":"boolean"},"abbruchgruende":{"type":"array","items":{"type":"string"}},"zyklenErkannt":{"type":"array","items":{"type":"string"}}},"required":["wurzelId","richtung","angeforderteTiefe","erreichteTiefe","knoten","kanten","abgeschnitten","abbruchgruende","zyklenErkannt"]},"PublicPersonSearchHitDto":{"type":"object","properties":{"personId":{"type":"string"},"name":{"type":"string"},"geburtsdatum":{"type":["object","null"]},"geburtsjahr":{"type":["object","null"]},"anzahlAktiverFunktionen":{"type":["object","null"]},"anzahlAktiverBeteiligungen":{"type":["object","null"]},"anzahlVerbundenerUnternehmen":{"type":["object","null"]}},"required":["personId","name","geburtsdatum","geburtsjahr","anzahlAktiverFunktionen","anzahlAktiverBeteiligungen","anzahlVerbundenerUnternehmen"]},"PublicPeopleSearchDataDto":{"type":"object","properties":{"suchbegriff":{"type":"string"},"personen":{"type":"array","items":{"$ref":"#/components/schemas/PublicPersonSearchHitDto"}}},"required":["suchbegriff","personen"]},"PublicPersonFunctionDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string"},"unternehmenName":{"type":"string"},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"funktion":{"type":["object","null"]},"vertretungsbefugnis":{"type":["object","null"]},"seit":{"type":["object","null"]}},"required":["firmenbuchnummer","unternehmenName","sitz","rechtsform","funktion","vertretungsbefugnis","seit"]},"PublicPersonOwnershipDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string"},"unternehmenName":{"type":"string"},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"anteilProzent":{"type":["object","null"]},"anteilText":{"type":["object","null"]},"seit":{"type":["object","null"]},"gueltigVon":{"type":["object","null"]},"gueltigBis":{"type":["object","null"]},"aktuell":{"type":"boolean"}},"required":["firmenbuchnummer","unternehmenName","sitz","rechtsform","anteilProzent","anteilText","seit"]},"PublicConnectedCompanyDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string"},"name":{"type":"string"},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"kurzbeschreibung":{"type":["object","null"]},"hatFunktion":{"type":"boolean"},"hatBeteiligung":{"type":"boolean"}},"required":["firmenbuchnummer","name","sitz","rechtsform","kurzbeschreibung","hatFunktion","hatBeteiligung"]},"PublicConnectedPersonDto":{"type":"object","properties":{"personId":{"type":"string"},"name":{"type":"string"},"geburtsdatum":{"type":["object","null"]},"geburtsjahr":{"type":["object","null"]},"gemeinsameFirmenbuchnummern":{"type":"array","items":{"type":"string"}},"verbindungsarten":{"type":"array","items":{"type":"string"}}},"required":["personId","name","geburtsdatum","geburtsjahr","gemeinsameFirmenbuchnummern","verbindungsarten"]},"PublicPersonMetricsDto":{"type":"object","properties":{"anzahlAktiverFunktionen":{"type":"number"},"anzahlAktiverBeteiligungen":{"type":"number"},"anzahlVerbundenerUnternehmen":{"type":"number"},"letzteBekannteAenderung":{"type":["object","null"]}},"required":["anzahlAktiverFunktionen","anzahlAktiverBeteiligungen","anzahlVerbundenerUnternehmen","letzteBekannteAenderung"]},"PublicPersonFunctionHistoryDto":{"type":"object","properties":{"ereignisId":{"type":"string"},"datum":{"type":"string"},"art":{"type":"string"},"firmenbuchnummer":{"type":"string"},"unternehmenName":{"type":"string"},"funktion":{"type":["object","null"]},"funktionVorher":{"type":["object","null"]},"funktionNachher":{"type":["object","null"]},"zusammenfassung":{"type":"string"}},"required":["ereignisId","datum","art","firmenbuchnummer","unternehmenName","funktion","funktionVorher","funktionNachher","zusammenfassung"]},"PublicPersonProfileDataDto":{"type":"object","properties":{"personId":{"type":"string"},"name":{"type":"string"},"geburtsjahr":{"type":["object","null"]},"geburtsdatum":{"type":["object","null"]},"aliasnamen":{"type":"array","items":{"type":"string"}},"funktionen":{"type":"array","items":{"$ref":"#/components/schemas/PublicPersonFunctionDto"}},"beteiligungen":{"type":"array","items":{"$ref":"#/components/schemas/PublicPersonOwnershipDto"}},"verbundeneUnternehmen":{"type":"array","items":{"$ref":"#/components/schemas/PublicConnectedCompanyDto"}},"verbundenePersonen":{"type":"array","items":{"$ref":"#/components/schemas/PublicConnectedPersonDto"}},"kennzahlen":{"$ref":"#/components/schemas/PublicPersonMetricsDto"},"funktionshistorie":{"type":"array","items":{"$ref":"#/components/schemas/PublicPersonFunctionHistoryDto"}}},"required":["personId","name","geburtsjahr","geburtsdatum","aliasnamen","funktionen","beteiligungen","verbundeneUnternehmen","verbundenePersonen","kennzahlen"]},"PublicPersonRelationshipGraphDataDto":{"type":"object","properties":{"wurzelId":{"type":"string"},"knoten":{"type":"array","items":{"$ref":"#/components/schemas/PublicGraphNodeDto"}},"kanten":{"type":"array","items":{"$ref":"#/components/schemas/PublicGraphEdgeDto"}},"abgeschnitten":{"type":"boolean"},"abbruchgruende":{"type":"array","items":{"type":"string"}}},"required":["wurzelId","knoten","kanten","abgeschnitten","abbruchgruende"]},"PublicListSummaryDto":{"type":"object","properties":{"listenId":{"type":"string"},"name":{"type":"string"},"anzahlUnternehmen":{"type":"number"},"erstelltAm":{"type":"string","format":"date-time"},"aktualisiertAm":{"type":"string","format":"date-time"},"enthaeltUnternehmen":{"type":"boolean"},"eintragId":{"type":["object","null"]},"kommentar":{"type":["object","null"]}},"required":["listenId","name","anzahlUnternehmen","erstelltAm","aktualisiertAm"]},"PublicListsDataDto":{"type":"object","properties":{"listen":{"type":"array","items":{"$ref":"#/components/schemas/PublicListSummaryDto"}}},"required":["listen"]},"PublicListSummaryDataDto":{"type":"object","properties":{"liste":{"$ref":"#/components/schemas/PublicListSummaryDto"}},"required":["liste"]},"PublicCreateListDto":{"type":"object","properties":{"name":{"type":"string","description":"Name der neuen accountweiten Unternehmensliste.","minLength":1,"maxLength":120,"example":"Wiener Zielkunden"}},"required":["name"]},"PublicListItemDto":{"type":"object","properties":{"eintragId":{"type":"string"},"listenId":{"type":"string"},"firmenbuchnummer":{"type":"string"},"unternehmenName":{"type":"string"},"sitz":{"type":["object","null"]},"rechtsform":{"type":["object","null"]},"status":{"type":["object","null"]},"letztesGeschaeftsjahr":{"$ref":"#/components/schemas/PublicAnalyticsFinancialYearDto"},"kommentar":{"type":["object","null"]},"hinzugefuegtAm":{"type":"string","format":"date-time"},"aktualisiertAm":{"type":"string","format":"date-time"}},"required":["eintragId","listenId","firmenbuchnummer","unternehmenName","kommentar","hinzugefuegtAm","aktualisiertAm"]},"PublicListDataDto":{"type":"object","properties":{"liste":{"$ref":"#/components/schemas/PublicListSummaryDto"},"eintraege":{"type":"array","items":{"$ref":"#/components/schemas/PublicListItemDto"}}},"required":["liste","eintraege"]},"PublicListMutationDataDto":{"type":"object","properties":{"eintrag":{"$ref":"#/components/schemas/PublicListItemDto"}},"required":["eintrag"]},"PublicAddListItemDto":{"type":"object","properties":{"firmenbuchnummer":{"type":"string","description":"Firmenbuchnummer des hinzuzufügenden Unternehmens.","example":"123456a"},"kommentar":{"type":"string","description":"Optionaler accountweit sichtbarer Kommentar zum Eintrag.","maxLength":2000,"example":"Im nächsten Quartal kontaktieren"}},"required":["firmenbuchnummer"]},"PublicListRemovalDataDto":{"type":"object","properties":{"entfernt":{"type":"boolean"},"eintragId":{"type":"string"},"listenId":{"type":"string"}},"required":["entfernt","eintragId","listenId"]},"PublicUsageDataDto":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"plan":{"type":"string"},"subscriptionStatus":{"type":"string"}}},"kontingent":{"type":"object","properties":{"monatlichesLimit":{"type":["integer","null"]},"diesenMonatVerbraucht":{"type":"integer"},"diesenMonatVerbleibend":{"type":["integer","null"]},"einfacheSuchenZaehlen":{"type":"boolean"},"erweiterteSuchenZaehlen":{"type":"boolean"},"zurueckgesetztAm":{"type":"string","format":"date-time"},"operationenDiesenMonat":{"type":"array","items":{"type":"object","additionalProperties":true}},"kurzfristigesLimitProMinute":{"type":"integer"}}}},"required":["account","kontingent"]}}},"externalDocs":{"description":"Firmenatlas Entwicklerdokumentation","url":"https://www.firmenatlas.com/api-dokumentation"}}