curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=NUMBER&country=GR" \ -H "Authorization: Bearer YOUR_API_KEY"
Το Γ.Ε.ΜΗ. είναι το Γενικό Εμπορικό Μητρώο, που τηρεί η Κεντρική Υπηρεσία Γ.Ε.ΜΗ. της Ένωσης Ελληνικών Επιμελητηρίων (ΚΕΕΕ). Δοκιμάστε εδώ μια αναζήτηση με αριθμό ΓΕΜΗ και δείτε την ίδια κλήση ως API: τι επιστρέφει και τι δεν δημοσιεύει το μητρώο.
Με «Γ.Ε.ΜΗ. API» εννοούμε μια κλήση REST που δίνει την εγγραφή μιας ελληνικής εταιρείας σε JSON. Στέλνετε τον αριθμό ΓΕΜΗ, το LEI, τον αριθμό ΦΠΑ (EL και ΑΦΜ) ή την επωνυμία και παίρνετε επωνυμία, νομική μορφή, κατάσταση, έδρα, ημερομηνία σύστασης και κωδικό δραστηριότητας (ΚΑΔ), στο ίδιο σχήμα με κάθε άλλη χώρα.
Το API είναι υπηρεσία του Prometiam και όχι του Γ.Ε.ΜΗ. Δεν αντικαθιστά τα πιστοποιητικά και τα επικυρωμένα αντίγραφα του μητρώου. Χρησιμεύει όταν ο έλεγχος πρέπει να γίνεται αυτόματα: στην ένταξη πελατών, στον έλεγχο προμηθευτών, στην παρακολούθηση ενός χαρτοφυλακίου.
Ο αριθμός ΓΕΜΗ (ΑΡ. ΓΕΜΗ) έχει 12 ψηφία, με τα αρχικά μηδενικά (005048301000). Τα τρία τελευταία ψηφία είναι η κατάληξη εγκατάστασης: το 000 είναι η έδρα, το 001 και πάνω υποκαταστήματα, που δεν επιστρέφονται ποτέ. Δεν υπάρχει ψηφίο ελέγχου: ελέγχεται μόνο η μορφή, άρα ένας αριθμός μπορεί να φαίνεται σωστός και να μην ανήκει σε καμία εταιρεία. Τα κενά, οι τελείες και οι παύλες αγνοούνται και ένας σύντομος αριθμός συμπληρώνεται με μηδενικά.
Το ΑΦΜ είναι άλλος αριθμός: εννέα ψηφία με ψηφίο ελέγχου. Επιστρέφεται ως ταυτότητα της εγγραφής (afm), και ο αριθμός ΦΠΑ είναι EL και το ΑΦΜ, σχηματισμένος με κανόνα: η μορφή είναι σωστή, η εγγραφή στο ΦΠΑ δεν επιβεβαιώνεται (ελέγξτε τον με GET /vat/{number}). Μια αναζήτηση με vat= δέχεται EL και ΑΦΜ. Το LEI είναι τρίτη ταυτότητα όπου το GLEIF δηλώνει τον αριθμό ΓΕΜΗ της εταιρείας (lei=), και δεν το έχει κάθε εταιρεία.
Η αναζήτηση με αριθμό ΓΕΜΗ είναι μία κλήση. Αν ξέρετε μόνο την επωνυμία, βάλτε name= αντί για company_number= (δέχεται ελληνικά ή λατινικά γράμματα). Η απάντηση βρίσκεται κάτω από το κλειδί data:
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=GR&company_number=196583401000' \ -H 'Authorization: Bearer rk_live_...'
Μια αναζήτηση εταιρείας κοστίζει 1 μονάδα χρέωσης και ένα σφάλμα τίποτα. Για πολλούς αριθμούς σε μία κλήση υπάρχει το POST /companies/lookup, όπου κάθε αριθμός μετράει ως μία κλήση.
| Πεδίο | Τι σημαίνει |
|---|---|
company_name και name_latin | Η επωνυμία όπως τηρείται στο μητρώο και η λατινική της μορφή (του μητρώου, αλλιώς του GLEIF, αλλιώς μεταγραφή κατά ELOT 743) |
company_number | Ο αριθμός ΓΕΜΗ, 12 ψηφία |
legal_form | ΑΕ, ΙΚΕ, ΕΠΕ, ΟΕ, ΕΕ, ΕΕ επί μετοχών, ΕΥΡΩΠΑΪΚΗ ΕΤΑΙΡΕΙΑ (SE) ή μία από τις μορφές συνεταιρισμού |
status | Τυποποιημένη κατάσταση· το registry_details.status_code κρατά τον κωδικό του μητρώου και το registry_details.status_date την ημέρα της τελευταίας αλλαγής |
founding_date | Ημερομηνία σύστασης, από την οποία μετράται η ηλικία της εταιρείας· δεν υπάρχει ημερομηνία εγγραφής |
activity_code και nace_class | Ο κύριος ΚΑΔ (8 ψηφία, ΚΑΔ 2008 ή ΚΑΔ 2025 όπως τον έχει η εταιρεία) και η κλάση NACE, που διαβάζεται από τα τέσσερα πρώτα ψηφία |
| Διεύθυνση | Καταστατική έδρα και νομός |
Το API επιστρέφει μία από τις καταστάσεις: active, not_yet_active, suspended, in_administration, in_restructuring, in_liquidation, in_liquidation_insolvent, deregistered ή merged. Η «αδρανής» εταιρεία του μητρώου διαβάζεται ως suspended, η υπό αναγκαστική διοίκηση ως in_administration και η εταιρεία που διασπάστηκε ως deregistered. Για μια διαγραμμένη ή συγχωνευμένη εταιρεία η dissolution_date είναι η ημέρα της τελευταίας αλλαγής κατάστασης. Μια ένδειξη κατάστασης μέσα στην επωνυμία, όπως «(ΔΙΑΓΡΑΦΗΚΕ)», διαβάζεται και αφαιρείται από το όνομα· η επωνυμία όπως καταχωρίστηκε είναι στο registry_details.name_as_registered.
Για την Ελλάδα υπάρχουν συμβάντα αλλαγών του μητρώου: νέα επωνυμία, νέα κατάσταση, νέα νομική μορφή και νέα καταστατική έδρα, από GET /company-events/search?country=GR&company_number=196583401000 (2 μονάδες χρέωσης). Η ημερομηνία ενός συμβάντος είναι η ημέρα που η αλλαγή φάνηκε για πρώτη φορά στα δεδομένα, και δεν υπάρχουν συμβάντα πριν από τις 24 Οκτωβρίου 2026. Με το POST /monitor ο λογαριασμός σας παίρνει webhook για αλλαγή κατάστασης, διάλυση, ταύτιση με λίστες κυρώσεων (beta) και για τα συμβάντα του μητρώου.
Το μητρώο δεν έχει αρχείο μαζικής λήψης ούτε ροή αλλαγών: οι νέες εγγραφές διαβάζονται κάθε ημέρα και ολόκληρο το μητρώο κάθε επτά ημέρες, οπότε μια αλλαγή σε υπάρχουσα εταιρεία μπορεί να χρειαστεί έως και μία εβδομάδα για να εμφανιστεί.
Contains data from the General Commercial Registry (Γ.Ε.ΜΗ.), Central GEMI Service, Hellenic Federation of Chambers of Commerce (KEEE), available under the ODC-BY 1.0 licence (http://www.opendefinition.org/licenses/odc-by). Adapted by Prometiam. Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0.
Η δοκιμή διαρκεί 14 ημέρες και περιλαμβάνει 500 μονάδες χρέωσης. Απαιτείται κάρτα, δεν γίνεται καμία χρέωση κατά τη διάρκειά της, και στη συνέχεια ισχύει το πακέτο Starter (9,99 € τον μήνα), εκτός αν ακυρώσετε.