Έγγραφα

Ποια έγγραφα υπάρχουν και σε ποια μορφή.

Με το fetch-document κατεβάζεις επίσημα έγγραφα από το μητρώο ως αρχείο. Πέρασε το entity_id της εταιρείας στο company_id και επίλεξε ένα document_type. Κάθε έγγραφο που παραδίδεται κοστίζει 15 πιστώσεις.

Τύποι εγγράφων

Υπάρχουν πέντε τύποι εγγράφων. Γράψε τις τιμές για το document_type ακριβώς όπως στον πίνακα, με κεφαλαία και πεζά. Το παράδειγμα αιτήματος ανακτά τον Aktueller Abdruck της Hetzner Online GmbH, Ansbach HRB 6089.

document_type
document_type	Έγγραφο	Μορφή
AD	Aktueller Abdruck (τρέχον απόσπασμα)Όλες οι εγγραφές που ισχύουν σήμερα. Το κλασικό απόσπασμα μητρώου.	PDF
CD	Chronologischer Abdruck (χρονολογικό απόσπασμα)Όλες οι εγγραφές με χρονολογική σειρά, μαζί με τις διαγραμμένες, από τότε που το μητρώο τηρείται ηλεκτρονικά.	PDF
SI	Strukturierter Registerinhalt (δομημένο περιεχόμενο μητρώου)Το περιεχόμενο του μητρώου ως XML στο πρότυπο XJustiz, κατάλληλο για μηχανική επεξεργασία.	XML
shareholders_list	Gesellschafterliste (λίστα εταίρων)Η λίστα των εταίρων με τα μερίδιά τους, όπως την καταθέτει η GmbH στο μητρώο.	PDF
articles_of_association	Gesellschaftsvertrag ή Satzung (καταστατικό)Η σύμβαση που διέπει την εταιρεία. Για μια GmbH λέγεται Gesellschaftsvertrag, για μια AG και eG Satzung.	PDF

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'company_id=94eb910fef13f94585c48c263fa446d4' \
  --data-urlencode 'document_type=AD'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-document",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "company_id": "94eb910fef13f94585c48c263fa446d4",
        "document_type": "AD",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-document");
url.searchParams.append("company_id", "94eb910fef13f94585c48c263fa446d4");
url.searchParams.append("document_type", "AD");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

Έγγραφα ανά νομική μορφή

Ο Aktueller Abdruck, ο Chronologischer Abdruck και το Strukturierter Registerinhalt υπάρχουν για κάθε εγγεγραμμένη εταιρεία. Ποια κατατεθειμένα έγγραφα υπάρχουν πέρα από αυτά εξαρτάται από τη νομική μορφή.

Νομική μορφή
Νομική μορφή	AD, CD, SI	Λίστα εταίρων	Καταστατικό
GmbH, UG	ναι	ναι, υποχρεωτικά	ναι, το Gesellschaftsvertrag
AG, SE, KGaA	ναι	όχι	ναι, η Satzung
eG	ναι	όχι	ναι, η Satzung
KG, GmbH & Co. KG, OHG	ναι	όχι	συνήθως όχι
PartG, PartG mbB	ναι	όχι	συνήθως όχι
e.K.	ναι	όχι	συνήθως όχι

Λίστα εταίρων υπάρχει μόνο για GmbH και UG. Για άλλες νομικές μορφές και για έγγραφα που λείπουν, το API απαντά με 404 και δεν χρεώνει τίποτα.

Μορφές

Η απάντηση είναι το ίδιο το αρχείο, όχι JSON. Τον τύπο τον αναγνωρίζεις από το header Content-Type, το όνομα αρχείου από το header Content-Disposition.

Το όνομα αρχείου περιέχει το entity_id, τον τύπο εγγράφου και την ημερομηνία ανάκτησης, π.χ. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

Οι λίστες εταίρων και τα καταστατικά είναι συχνά σαρωμένες σελίδες, ορισμένες χωρίς επίπεδο κειμένου. Για να πάρεις το κείμενο χρειάζεσαι τότε OCR.

Ορισμένα έγγραφα διατίθενται από το μητρώο μόνο ως εικόνα TIFF. Το API απαντά τότε με 415 και δεν χρεώνει τίποτα.

Στο παράδειγμά μας της Hetzner Online GmbH τα αρχεία είχαν αυτά τα μεγέθη: Aktueller Abdruck περίπου 35 KB, Strukturierter Registerinhalt περίπου 14 KB, Gesellschaftsvertrag περίπου 450 KB.

Ανακτούμε τα έγγραφα απευθείας από το μητρώο όταν χρειάζεται. Αυτό μπορεί να διαρκέσει έως δύο λεπτά. Γι’ αυτό όρισε το timeout του client σου σε τουλάχιστον 120 δευτερόλεπτα ή ανάκτησε το έγγραφο στο παρασκήνιο με async=true. Αν το μητρώο δεν απαντήσει εγκαίρως, λαμβάνεις 504 με Retry-After. Τότε δεν χρεώνεται τίποτα.

fetch-document Παράμετροι, απάντηση και σφάλματα αναλυτικά. Λήψη εγγράφων Βήμα βήμα στο πρώτο σου έγγραφο.