Το DRCOR είναι το Τμήμα Εφόρου Εταιρειών και Διανοητικής Ιδιοκτησίας της Κύπρου (ΤΕΕΔΙ), το μητρώο όπου εγγράφονται οι κυπριακές εταιρείες. Δοκιμάστε εδώ μια αναζήτηση με αριθμό εγγραφής και δείτε την ίδια κλήση ως API: τι επιστρέφει, τι δεν επιστρέφει και πόσο κοστίζει.
Αριθμός εγγραφής (HE165) — ή επωνυμία εταιρείας
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=HE165&country=CY" \ -H "Authorization: Bearer YOUR_API_KEY"
Με «DRCOR API» εννοούμε μια κλήση REST που δίνει την εγγραφή μιας κυπριακής εταιρείας σε JSON. Στέλνετε τον αριθμό εγγραφής, όπως HE165, ή την επωνυμία και παίρνετε επωνυμία, νομική μορφή, κατάσταση, καταχωρισμένη διεύθυνση με την επαρχία και ημερομηνία εγγραφής. Το αντικείμενο της εταιρείας είναι το ίδιο με των άλλων χωρών που καλύπτει το Prometiam, άρα ο κώδικας για την Κύπρο διαφέρει από τον κώδικα για οποιαδήποτε άλλη χώρα μόνο στην παράμετρο country.
Το API είναι υπηρεσία του Prometiam και όχι του Τμήματος. Δεν αντικαθιστά τα πιστοποιητικά και τα επικυρωμένα αντίγραφα του μητρώου, που τα εκδίδει το ίδιο το Τμήμα. Χρησιμεύει όταν ο έλεγχος πρέπει να γίνεται αυτόματα: στην ένταξη πελατών, στην πληρωμή προμηθευτών, σε ένα CRM ή σε ένα ERP.
Ο κυπριακός αριθμός εγγραφής είναι πρόθεμα και αριθμός: HE για εταιρεία (HE165, Τράπεζα Κύπρου) και AE για αλλοδαπή εταιρεία εγγεγραμμένη στην Κύπρο (AE3834). Ο αριθμός έχει έως εννέα ψηφία και δεν ξεκινά με μηδέν. Δεν υπάρχει ψηφίο ελέγχου, επομένως το API επιβεβαιώνει μόνο τη μορφή του αριθμού, ποτέ ότι η εταιρεία υπάρχει· γι’ αυτό υπάρχει η αναζήτηση.
Το API είναι ανεκτικό στον τρόπο γραφής: ένας αριθμός χωρίς πρόθεμα (165) διαβάζεται ως αριθμός εταιρείας (HE), τα κενά και οι παύλες ανάμεσα στο πρόθεμα και τον αριθμό αγνοούνται και τα ελληνικά γράμματα Η και Ε γίνονται δεκτά στο πρόθεμα. Ένας αριθμός με λάθος μορφή παίρνει σφάλμα επικύρωσης 400 και όχι κενή απάντηση, ώστε μια τυπογραφική αβλεψία να μη μοιάζει με εταιρεία που δεν υπάρχει. Οι ομόρρυθμες και ετερόρρυθμες εταιρείες και οι εμπορικές επωνυμίες έχουν άλλα προθέματα και δεν επιστρέφονται.
Η αναζήτηση με αριθμό εγγραφής είναι μία κλήση. Αν ξέρετε μόνο την επωνυμία, βάλτε name= αντί για company_number= (δέχεται ελληνικά ή λατινικά γράμματα). Η απάντηση βρίσκεται κάτω από το κλειδί data:
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CY&company_number=HE165' \ -H 'Authorization: Bearer rk_live_...'
Ένα σύντομο απόσπασμα της απάντησης για το HE165 (η πραγματική απάντηση έχει περισσότερα πεδία):
{
"data": [{
"id": 19000000000165,
"country": "CY",
"company_number": "HE165",
"company_name": "BANK OF CYPRUS PUBLIC COMPANY LIMITED",
"legal_form": "PLC",
"local_legal_form_name": "Public company limited by shares",
"status": "active",
"local_status": "active",
"founding_date": "1943-12-31",
"address": "ΣΤΑΣΊΝΟΥ, 51",
"postal_code": "2002",
"city": "ΑΓΊΑ ΠΑΡΑΣΚΕΥΉ",
"region": "NICOSIA",
"registry_details": { "status_code": "Εγγεγραμμένη" }
}],
"meta": { "country": "CY", "data_as_of": "2026-11-02" }
}
Η διεύθυνση και η πόλη μένουν όπως τις υπέβαλε η εταιρεία, εδώ με ελληνικούς χαρακτήρες και τόνους, και η επαρχία είναι στο region. Το registry_details.status_code κρατά την κατάσταση με τα λόγια του μητρώου και το meta.data_as_of δείχνει σε ποια ημερομηνία αναφέρονται τα δεδομένα. Με το id ζητάτε το πλήρες προφίλ με GET /companies/{id}.
Μια αναζήτηση εταιρείας κοστίζει 1 μονάδα χρέωσης και ένα σφάλμα τίποτα. Για πολλούς αριθμούς σε μία κλήση υπάρχει το POST /companies/lookup, όπου κάθε αριθμός μετράει ως μία κλήση.
| Πεδίο | Τι σημαίνει |
|---|---|
company_name | Η επωνυμία όπως υποβλήθηκε στο μητρώο, σε ελληνικούς ή λατινικούς χαρακτήρες |
company_number | Ο αριθμός εγγραφής, π.χ. HE165 |
status και local_status | Τυποποιημένη κατάσταση και η κατάσταση με τα λόγια του μητρώου (διαγραφή σε εκκρεμότητα, εθελοντική ή υποχρεωτική εκκαθάριση, διαχείριση) |
legal_form και local_legal_form | Νομική μορφή: ιδιωτική, δημόσια ή περιορισμένη με εγγύηση |
founding_date | Ημερομηνία σύστασης, όπου την δημοσιεύει το μητρώο |
| Διεύθυνση | Καταστατική έδρα με την επαρχία |
registry_details | Η κατάσταση με τα λόγια του μητρώου στο status_code, π.χ. «Εγγεγραμμένη» |
statusΤο μητρώο γράφει την κατάσταση με ελληνικές λέξεις. Το API την επιστρέφει ως τυποποιημένο status, ίδιο σε κάθε χώρα, και ως local_status με τους όρους του μητρώου, ενώ το registry_details.status_code κρατά το ελληνικό κείμενο όπως δημοσιεύεται. Στον πίνακα, η τυποποιημένη τιμή:
| Κατάσταση στο μητρώο | status |
|---|---|
| Εγγεγραμμένη (και «στάλθηκε επιστολή υπενθύμισης») | active |
| Δημοσιεύτηκε η τρίμηνη ειδοποίηση διαγραφής | active_strike_off_pending |
| Εκούσια εκκαθάριση από μετόχους ή πιστωτές, προσωρινός εκκαθαριστής, υπό εκκαθάριση | in_liquidation |
| Εκκαθάριση με διάταγμα δικαστηρίου | in_compulsory_liquidation |
| Υπό διαχείριση | in_administration |
| Διαγραμμένη, διάλυση μετά την ολοκλήρωση της εκκαθάρισης | deregistered |
| Διαλύθηκε λόγω συγχώνευσης | merged |
Η υπενθύμιση για εκπρόθεσμη ετήσια έκθεση είναι ένα πρώτο βήμα συμμόρφωσης και δεν αλλάζει την κατάσταση· μόνο η δημοσιευμένη τρίμηνη ειδοποίηση σημαίνει ότι ξεκινά η διαγραφή.
Για την Κύπρο υπάρχουν συμβάντα αλλαγών του μητρώου: νέα επωνυμία, νέα κατάσταση, νέα νομική μορφή και νέο εγγεγραμμένο γραφείο, από GET /company-events/search?country=CY&company_number=HE165 (2 μονάδες χρέωσης). Η ημερομηνία ενός συμβάντος είναι η ημέρα που η αλλαγή εμφανίστηκε πρώτη φορά στα δεδομένα του μητρώου, όχι η ημέρα της δήλωσης στο ΤΕΕΔΙ, και δεν υπάρχουν συμβάντα πριν από την πρώτη φόρτωση των κυπριακών δεδομένων, τον Οκτώβριο 2026.
Με το POST /monitor ο λογαριασμός σας παίρνει webhook για αλλαγή κατάστασης, διάλυση, ταύτιση με λίστες κυρώσεων (beta) και για τα συμβάντα του μητρώου. Η παρακολούθηση δεν καταναλώνει μονάδες χρέωσης· το πακέτο ορίζει πόσες εταιρείες παρακολουθείτε (3 στη δοκιμή, 25 στο Starter, 250 στο Professional, 2.500 στο Scale). Τα συμβάντα και τα webhooks περιγράφονται αναλυτικά στη σελίδα νέες εταιρείες και αλλαγές μητρώου.
vat= για την Κύπρο απορρίπτεται. Έναν κυπριακό αριθμό ΦΠΑ τον ελέγχετε ξεχωριστά στο VIES με GET /vat/{number}.Contains data from the Department of the Registrar of Companies and Intellectual Property (DRCOR), Republic of Cyprus, via data.gov.cy, CC BY 4.0
Η δωρεάν δοκιμή διαρκεί 14 ημέρες και περιλαμβάνει 500 μονάδες χρέωσης. Απαιτείται κάρτα, δεν γίνεται καμία χρέωση κατά τη διάρκειά της και στη συνέχεια ισχύει το Starter (9,99 € τον μήνα, 1.000 μονάδες χρέωσης), εκτός αν ακυρώσετε. Το Professional κοστίζει 29,99 € (10.000 μονάδες χρέωσης), το Scale 99,99 € (50.000) και το Enterprise κατόπιν συμφωνίας. Μια αναζήτηση εταιρείας κοστίζει 1 μονάδα χρέωσης, μια αναζήτηση συμβάντων 2 και τα σφάλματα τίποτα. Δείτε τις τιμές.
Ξεκινήστε τη δωρεάν δοκιμή 14 ημερών · Τεκμηρίωση API
Η δοκιμή διαρκεί 14 ημέρες και περιλαμβάνει 500 μονάδες χρέωσης. Απαιτείται κάρτα, δεν γίνεται καμία χρέωση κατά τη διάρκειά της, και στη συνέχεια ισχύει το πακέτο Starter (9,99 € τον μήνα), εκτός αν ακυρώσετε.