Το Prometiam είναι ένα REST API με επίσημα δεδομένα μητρώων εταιρειών για 27 χώρες. Για την Κύπρο διαβάζετε τα στοιχεία του Τμήματος Εφόρου Εταιρειών και Διανοητικής Ιδιοκτησίας με έναν αριθμό εγγραφής, σε μορφή JSON.
Το Prometiam είναι ένα API που επιστρέφει δεδομένα από επίσημα μητρώα εταιρειών σε ένα κοινό σχήμα. Οι 27 χώρες είναι: Ισπανία, Γαλλία, Ηνωμένο Βασίλειο, Ιρλανδία, Πολωνία, Νορβηγία, Φινλανδία, Σουηδία, Κροατία, Βέλγιο, Δανία, Εσθονία, Σλοβακία, Ελβετία, Λετονία, Κύπρος, Ρουμανία, Λιθουανία, Καναδάς, Αυστραλία, Ιαπωνία, Ισραήλ, Σιγκαπούρη, Κολομβία, Ταϊβάν, Βραζιλία και Ηνωμένες Πολιτείες. Η ίδια κλήση, με την παράμετρο country, δουλεύει για όλες. Έτσι ο έλεγχος μιας κυπριακής εταιρείας και ο έλεγχος μιας γαλλικής ή ισπανικής μοιάζουν ακριβώς το ίδιο στον κώδικά σας.
Η πηγή είναι το Τμήμα Εφόρου Εταιρειών και Διανοητικής Ιδιοκτησίας (ΤΕΕΔΙ, DRCOR). Το αναγνωριστικό είναι ο αριθμός εγγραφής: πρόθεμα και αριθμός, όπως HE165 για την Τράπεζα Κύπρου ή HE835 για την KEO PLC. Το πρόθεμα HE σημαίνει εταιρεία και το AE αλλοδαπή εταιρεία. Δεν υπάρχει ψηφίο ελέγχου, άρα επαληθεύεται μόνο η μορφή.
| Πεδίο | Τι σημαίνει |
|---|---|
company_name | Η επωνυμία όπως υποβλήθηκε στο μητρώο, σε ελληνικούς ή λατινικούς χαρακτήρες |
company_number | Ο αριθμός εγγραφής, π.χ. HE165 |
status και local_status | Τυποποιημένη κατάσταση και η κατάσταση με τα λόγια του μητρώου (διαγραφή σε εκκρεμότητα, εθελοντική ή υποχρεωτική εκκαθάριση, διαχείριση) |
legal_form και local_legal_form | Νομική μορφή: ιδιωτική, δημόσια ή περιορισμένη με εγγύηση |
founding_date | Ημερομηνία σύστασης, όπου την δημοσιεύει το μητρώο |
| Διεύθυνση | Καταστατική έδρα με την επαρχία |
Η ίδια εγγραφή έχει τη μορφή που έχουν όλες οι χώρες, οπότε δεν γράφετε ειδικό κώδικα για την Κύπρο. Σε αυτήν υπάρχουν επίσης συμβάντα αλλαγών του μητρώου (επωνυμία, κατάσταση, νομική μορφή, έδρα) και παρακολούθηση με webhook, μέσω POST /monitor.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CY&company_number=HE165' \ -H 'Authorization: Bearer rk_live_...'
Η απάντηση περιέχει το id της εγγραφής. Με αυτό ζητάτε το πλήρες προφίλ με GET /companies/{id}, και με GET /company-events/search?country=CY&company_number=HE165 τα συμβάντα του μητρώου. Αν ξέρετε μόνο την επωνυμία, χρησιμοποιήστε name= αντί για company_number=.
Τα κυπριακά δεδομένα ανανεώνονται μηνιαία. Δεν είναι ροή πραγματικού χρόνου: μια εταιρεία που διαγράφηκε ή άλλαξε έδρα την περασμένη εβδομάδα μπορεί να εμφανιστεί στην επόμενη ανανέωση. Τα συμβάντα αλλαγών φέρουν ημερομηνία από τότε που η αλλαγή εμφανίστηκε πρώτη φορά στα δεδομένα του μητρώου, και δεν υπάρχουν πριν από την πρώτη φόρτωση των κυπριακών δεδομένων, τον Οκτώβριο 2026. Για άλλες χώρες η ανανέωση είναι ημερήσια ή κάθε εργάσιμη ημέρα, ενώ για τις Ηνωμένες Πολιτείες εβδομαδιαία.
vat= για την Κύπρο απορρίπτεται. Τον αριθμό ΦΠΑ που σας έδωσε ο πελάτης τον ελέγχετε ξεχωριστά με GET /vat/{number} (έλεγχος VIES).Οι τιμές είναι δημόσιες και δεν χρειάζεται τηλεφώνημα πωλήσεων. Starter 9,99 € τον μήνα (1.000 μονάδες χρέωσης), Professional 29,99 € (10.000 μονάδες χρέωσης, webhooks και έλεγχος κυρώσεων σε beta), Scale 99,99 € (50.000 μονάδες χρέωσης και οικονομικές καταστάσεις), και Enterprise κατόπιν συμφωνίας. Με ετήσια χρέωση παίρνετε δύο μήνες δωρεάν. Δείτε όλες τις τιμές. Η δοκιμή των 14 ημερών περιλαμβάνει 500 μονάδες χρέωσης, απαιτεί κάρτα και δεν χρεώνεται τίποτα όσο διαρκεί.
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 ημερών · Τεκμηρίωση API
Η δοκιμή διαρκεί 14 ημέρες και περιλαμβάνει 500 μονάδες χρέωσης. Απαιτείται κάρτα, δεν γίνεται καμία χρέωση κατά τη διάρκειά της, και στη συνέχεια ισχύει το πακέτο Starter (9,99 € τον μήνα), εκτός αν ακυρώσετε.