> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Cyprus
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Cyprus. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)
## Data Sources
Cyprus uses a single official registry for all company data:
* **DRCOR (Department of Registrar of Companies and Official Receiver).** Operated by the Ministry of Energy, Commerce and Industry. This is the **sole data source** for all Cypriot entities. Company profile data (name, status, legal form, registered address, officers) is extracted from the DRCOR public e-filing portal at [efiling.drcor.mcit.gov.cy](https://efiling.drcor.mcit.gov.cy). Shareholder data is extracted from the **Trade Register Extract (Study File)** PDF, which is retrieved from DRCOR and parsed using OCR and AI.
DRCOR provides company profile data through its public ASP.NET web portal (no API). The system navigates the portal programmatically, extracting structured data from HTML responses. For shareholders, the Trade Register Extract PDF is retrieved, OCR-processed via Mistral, and parsed with AI to extract shareholder information.
## Company Identifiers
### Query Identifiers
Cyprus uses a unique identifier system where **Greek letter prefixes** are part of the registration number and indicate the company type:
| Prefix | Greek | English Translation | Company Type | Example |
| ------ | ----------------- | ------------------- | -------------------------------- | ---------- |
| **HE** | Ηταιρεία Εταιρεία | Private Company | Limited Company | `HE433437` |
| **EE** | Εμπορική Επωνυμία | Business Name | Business Name / Sole Trader | `EE25556` |
| **S** | Συνεταιρισμός | Partnership | Partnership (Limited or General) | `S12593` |
| **AE** | Αλλοδαπή Εταιρεία | Overseas Company | Overseas Company (Branch) | `AE2642` |
**Critical: Greek letter prefixes are mandatory**
The registration number **must** include the Greek letter prefix (HE, EE, S, AE). The actual characters used are Greek Unicode: **HE** = `ΗΕ`, **EE** = `ΕΕ`, **S** = `Σ`, **AE** = `ΑΕ`. Latin equivalents (HE, EE, S, AE with Latin characters) are **not accepted**. Use the actual Greek characters when querying the API.
**Same number, different companies:** The numeric portion of a registration number is NOT unique across prefixes. For example, `ΗΕ12593` (a limited company), `ΕΕ12593` (a business name), and `Σ12593` (a partnership) are **three completely different entities**. The unique identifier is always the full prefix + number combination.
### Identifiers in API Response
| Identifier Type | Format | Example | Found In |
| -------------------- | --------------------- | ---------- | ------------- |
| `registrationNumber` | Greek prefix + digits | `ΗΕ433437` | All companies |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| --------------------------- | --------------------- | ----------------- | ---------- | -------------------------------------------------------------------- |
| By Full Registration Number | Greek prefix + digits | `ΗΕ433437` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Number Only | Digits only | `433437` | Partial | Multiple results (all prefixes for that number) |
| By Company Name | Text string | `"YIAZOU GALAXY"` | Fuzzy | Multiple results (up to 200) |
**Search Performance:** Use the full registration number with Greek prefix for exact matching. Number-only searches return all companies sharing that numeric portion across different prefixes (ΗΕ, ΕΕ, Σ, ΑΕ). Name searches use a "starts with all words" matching strategy.
**Search limit:** DRCOR returns a maximum of 200 results per search. If a name search exceeds this limit, an error is returned asking the user to refine their query. Use more specific search terms or the full registration number for best results.
## Quirks & Gotchas
| Quirk | Details |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Greek letter prefixes are mandatory** | The registration number **must** include the Greek letter prefix (ΗΕ, ΕΕ, Σ, ΑΕ). Latin equivalents (HE, EE, S, AE) are **not accepted**. Use the actual Greek Unicode characters. |
| **Same number, different companies** | Number `12593` with different prefixes (ΗΕ12593, ΕΕ12593, Σ12593) are **completely different entities**. Searching without a prefix returns all matching prefixes. |
| **No activity codes** | DRCOR does not provide structured activity codes (NACE, ISIC, etc.). Activity information is not available for Cypriot companies. |
| **No share capital in structured data** | Share capital is not extracted from the web portal. It is available within the Study File PDF but not parsed into structured fields. |
| **No VAT numbers** | DRCOR does not provide VAT identification numbers. The only identifier returned is the registration number. |
| **Shareholders require document retrieve** | Shareholders are extracted from the Study File PDF, which must be retrieved from DRCOR. Billing occurs via the `CYP_REGISTER_EXTRACT` catalog item. The shareholders datapoint itself does not incur additional charges beyond the document cost. |
| **Entity type classification is AI-powered** | DRCOR does not indicate whether a legal representative is an individual or a company. AI classifies entity type from name patterns (e.g., suffixes like "LIMITED", "LTD", "ΛΙΜΙΤΕΝΤ"). This may occasionally misclassify edge cases. |
| **Legal form and status are AI-enriched** | Legal forms (in Greek) and statuses are enriched via AI for English translations, standardized values, and ISO 20275 codes. The Greek local names are always preserved verbatim. |
| **Legacy legal names tracked** | When a company has changed its name, both current and previous names are returned. DRCOR search results include name history (Τελευταίο Όνομα = Current Name, Προηγούμενο Όνομα = Previous Name). |
| **ASP.NET session-based navigation** | DRCOR uses an ASP.NET portal with ViewState. Each request requires session initialization and form field management. This can occasionally lead to session timeouts requiring retry. |
| **Study File is in English** | Unlike many other country registries, the Cyprus Trade Register Extract (Study File) is provided in English, making it more accessible for international users. |
| **Names may be in Greek or English** | Company names, officer names, and addresses on DRCOR can appear in either Greek or English (or a mix). The system preserves whichever language is used in the registry. |
## Mappings
### Company Status
Company status is extracted from the DRCOR `organizationStatus` field. The raw status is in Greek, and the standardized status is **AI-enriched**.
| Local Status (Greek) | English Translation | Standardized Status | Notes |
| ---------------------------- | -------------------- | --------------------------- | ------------------------------------------- |
| Εγγεγραμμένη | Registered | Active | Company is actively registered |
| Διαγραμμένη | Struck Off / Deleted | Closed | Company has been removed from the register |
| Στάληκε επιστολή Υπενθύμισης | Reminder Letter Sent | Closed | Pre-strike-off warning; treated as inactive |
| Διαλυμένη | Dissolved | Closed | Company has been formally dissolved |
| Υπό Εκκαθάριση | In Liquidation | Under Insolvency Proceeding | Company is undergoing liquidation |
Status values can appear in Greek or English depending on the DRCOR portal language. The system handles both. When a company is closed, a closure date (`statusDate`) is captured when available from DRCOR.
### Legal Forms
The local legal form is preserved from DRCOR in Greek and **AI-enriched** to English with standardized categories and ISO 20275 codes. DRCOR provides a `type` and an optional `subType` field; these are combined (e.g., "Εταιρεία - Ιδιωτική") to form the local name.
#### Private & Public Companies
| Greek Local Name | English Translation | Standardized | ISO 20275 |
| ------------------- | ------------------- | ------------------------- | --------- |
| Εταιρεία - Ιδιωτική | Private Company | Limited Liability Company | RCPI |
| Εταιρεία - Δημόσια | Public Company | Corporation | N/A |
#### Overseas Companies
| Greek Local Name | English Translation | Standardized | ISO 20275 |
| ----------------- | ------------------------ | ------------------------------- | --------- |
| Αλλοδαπή Εταιρεία | Foreign/Overseas Company | Branch or Representative Office | HIL6 |
#### Business Names (Sole Traders)
| Greek Local Name | English Translation | Standardized | ISO 20275 |
| ----------------- | -------------------------- | ------------------- | --------- |
| Εμπορική Επωνυμία | Trade Name / Business Name | Sole Proprietorship | FV0K |
#### Partnerships
| Greek Local Name | English Translation | Standardized | ISO 20275 |
| ---------------- | ------------------------- | ------------ | --------- |
| Συνεταιρισμός | Partnership / Cooperative | Partnership | N/A |
Because legal form standardization and ISO 20275 assignment are AI-enriched, exact mappings may evolve. The Greek local legal form name is always preserved verbatim from DRCOR. The `subType` field (e.g., "Ιδιωτική" for Private, "Δημόσια" for Public) distinguishes variants within the same base type.
### Legal Representatives
Legal representatives are extracted from the DRCOR company profile page ("Officials" section). Both **individuals and corporate entities** can hold these roles. Role names are preserved in the local language (Greek or English as provided by DRCOR) and translated/standardized via AI.
The classification of a name as **individual vs. company** is **AI-powered** based on name patterns and context (e.g., suffixes like "LIMITED", "LTD", "ΠΕΡΙΟΡΙΣΜΕΝΗΣ", "ΛΤΔ", "ΕΤΑΙΡΕΙΑ" indicate a corporate entity).
| Local Role (Greek) | English Translation | Standardized Role | Typical Entity Type |
| ----------------------- | ------------------- | -------------------- | --------------------- |
| Διευθυντής | Director | Director | Individual or Company |
| Γραμματέας | Secretary | Secretary | Individual or Company |
| Ιδιοκτήτης | Owner | Owner | Individual |
| Εξουσιοδοτημένο Πρόσωπο | Authorized Person | Authorized Signatory | Individual or Company |
| Διαχειριστής | Manager | Manager | Individual |
| Διευθύνων Σύμβουλος | Managing Director | CEO | Individual |
| General Partner | General Partner | Partner | Individual |
| Limited Partner | Limited Partner | Partner | Individual |
Roles in DRCOR can appear in Greek or English depending on the entity type. Private companies (ΗΕ) typically show Greek roles (Διευθυντής, Γραμματέας), while partnerships (Σ) may show English roles (General Partner, Limited Partner). The AI parser handles both languages.
**Entity Type Classification:** DRCOR does not explicitly indicate whether a legal representative is an individual or a company. The system uses AI-powered classification based on name patterns and context. While generally accurate, this may occasionally misclassify edge cases (e.g., a person with a company-like name, or a company without typical corporate suffixes).
### Shareholders
Shareholders are extracted from the **Trade Register Extract (Study File)** PDF using OCR and AI parsing. This is the only source for shareholder data in Cyprus.
#### Extraction Flow
1. The Trade Register Extract PDF is retrieved from DRCOR (triggers `CYP_REGISTER_EXTRACT` billing)
2. The PDF is processed with Mistral OCR to extract text
3. AI parses the extracted text to identify shareholders, share counts, and percentages
#### Shareholder Data
| Field | Description | Source |
| ----------------- | --------------------- | ------------------------------------------------------------------ |
| `type` | Individual or Company | AI-classified from name patterns in Study File |
| `numberOfShares` | Number of shares held | Extracted from Study File |
| `sharePercentage` | Ownership percentage | Calculated from share count vs total shares, or extracted directly |
#### Greek Terms in Study File
| Greek Term | English Translation |
| ----------------- | ------------------- |
| Μέτοχοι | Shareholders |
| Μετοχικό Κεφάλαιο | Share Capital |
| Μετοχές | Shares |
| Ποσοστό | Percentage |
| Ιδιοκτήτης | Owner |
Shareholder extraction requires the Trade Register Extract to be retrieved. Billing occurs via the `CYP_REGISTER_EXTRACT` catalog item when the document is fetched. The shareholders datapoint itself does not incur additional charges beyond the document retrieve. Both individual and corporate shareholders are supported, including foreign corporate shareholders with international addresses.
### Activity Code Mapping
DRCOR **does not provide** structured activity codes (NACE, ISIC, or any national classification). Activity information is not available for Cypriot companies.
## Data Availability
### Data Availability Matrix
| Data Type | DRCOR (Web Portal) | Study File (PDF) | Notes |
| -------------------------- | ------------------ | ---------------- | ------------------------------------------------------------- |
| Company Profile | ✅ Async | ❌ | Name, status, legal form, address, registration date |
| Legal Representatives | ✅ | ❌ | Directors, secretaries, partners, owners from portal |
| Other Key Persons | ❌ | ❌ | Not separately classified |
| Shareholders | ❌ | ✅ | Extracted from Study File PDF via OCR + AI |
| Ultimate Beneficial Owners | ❌ | ❌ | Not available |
| Establishments | ❌ | ❌ | Not available |
| Activity Codes | ❌ | ❌ | Not provided by DRCOR |
| Share Capital | ❌ | ⚠️ | Available in Study File but not parsed into structured fields |
| Documents | ❌ | ✅ | Trade Register Extract (Study File) |
**Legend:** ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing
### Documents by Company Type
All entity types (ΗΕ, ΕΕ, Σ, ΑΕ) have access to the same document:
| Document Type | API Category | Format | Catalog item | Availability | Notes |
| --------------------------------------- | ---------------------- | ------ | ---------------------- | --------------- | ---------------------------------------------------------------------- |
| **Trade Register Extract (Study File)** | `tradeRegisterExtract` | PDF | `CYP_REGISTER_EXTRACT` | ✅ All companies | English language, \~2 min delivery, comprehensive registration history |
The Trade Register Extract is commonly referred to as a "Study File" in Cyprus. It provides the most comprehensive view of a company's registration history from DRCOR, including company structure, officers, shareholders, filings, and status since incorporation. The document is always in English.
### Example API Responses
All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "", "countryCode": "CY", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "ΗΕ400001",
"countryCode": "CY",
"identifiers": { "registrationNumber": "ΗΕ400001" },
"legalName": "EXAMPLE VENTURES LTD",
"registrationDate": "2022-04-19",
"status": { "localName": "Εγγεγραμμένη", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Εταιρεία - Ιδιωτική", "englishTranslation": "Private Company", "standardized": "Limited Liability Company", "iso20275Code": "RCPI" },
"legalAddress": { "addressLine1": "25 Makariou Avenue", "city": "Nicosia", "postalCode": "1065", "countryCode": "CY" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Διευθυντής", "englishTranslation": "Director", "standardized": "Director" }, "individual": { "name": { "fullName": "Αντρέας Γεωργίου", "firstName": "Αντρέας", "lastName": "Γεωργίου" } } },
{ "type": "individual", "role": { "localName": "Γραμματέας", "englishTranslation": "Secretary", "standardized": "Secretary" }, "individual": { "name": { "fullName": "Μαρία Χριστοδούλου", "firstName": "Μαρία", "lastName": "Χριστοδούλου" } } }
]
}
```
```json theme={null}
{
"company": {
"id": "ΗΕ100001",
"countryCode": "CY",
"identifiers": { "registrationNumber": "ΗΕ100001" },
"legalName": "OLD TRADING LIMITED",
"registrationDate": "2005-09-09",
"status": { "localName": "Διαγραμμένη", "active": false, "statusDetails": { "status": "CLOSED", "closureDate": "2014-09-15" } },
"legalForm": { "localName": "Εταιρεία - Ιδιωτική", "englishTranslation": "Private Company", "standardized": "Limited Liability Company", "iso20275Code": "RCPI" },
"legalAddress": { "addressLine1": "6 Michail Michailidi", "addressLine2": "Tower 3", "city": "Limassol", "postalCode": "3030", "countryCode": "CY" }
},
"legalRepresentatives": [
{ "type": "company", "role": { "localName": "Διευθυντής", "englishTranslation": "Director", "standardized": "Director" }, "company": { "id": "CORPORATE DIRECTORS LIMITED", "legalName": "CORPORATE DIRECTORS LIMITED", "countryCode": "CY" } },
{ "type": "company", "role": { "localName": "Γραμματέας", "englishTranslation": "Secretary", "standardized": "Secretary" }, "company": { "id": "CORPORATE SECRETARIAL SERVICES LIMITED", "legalName": "CORPORATE SECRETARIAL SERVICES LIMITED", "countryCode": "CY" } }
]
}
```
**Note:** Closed companies have `active: false`, status `Διαγραμμένη` (Struck Off), and `closureDate` when available. Corporate legal representatives are common in Cyprus, especially for holding structures.
```json theme={null}
{
"company": {
"id": "ΑΕ2001",
"countryCode": "CY",
"identifiers": { "registrationNumber": "ΑΕ2001" },
"legalName": "FOREIGN HOLDINGS PLC",
"registrationDate": "2011-09-21",
"status": { "localName": "Εγγεγραμμένη", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Αλλοδαπή Εταιρεία", "englishTranslation": "Foreign Company", "standardized": "Branch or Representative Office", "iso20275Code": "HIL6" },
"legalAddress": { "addressLine1": "2 Dramas", "city": "Nicosia", "postalCode": "1077", "countryCode": "CY" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Διευθυντής", "englishTranslation": "Director", "standardized": "Director" }, "individual": { "name": { "fullName": "John Smith", "firstName": "John", "lastName": "Smith" } } },
{ "type": "company", "role": { "localName": "Εξουσιοδοτημένο Πρόσωπο", "englishTranslation": "Authorized Person", "standardized": "Authorized Signatory" }, "company": { "id": "LOCAL AGENT LTD", "legalName": "LOCAL AGENT LTD", "countryCode": "CY" } }
]
}
```
**Note:** Overseas companies (ΑΕ prefix) are foreign entities registered in Cyprus. They commonly have a mix of individual directors and corporate authorized persons acting as local agents.
```json theme={null}
{
"company": {
"id": "ΕΕ20001",
"countryCode": "CY",
"identifiers": { "registrationNumber": "ΕΕ20001" },
"legalName": "EXAMPLE TRADE & SERVICES",
"registrationDate": "2004-04-19",
"status": { "localName": "Εγγεγραμμένη", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Εμπορική Επωνυμία", "englishTranslation": "Trade Name", "standardized": "Sole Proprietorship", "iso20275Code": "FV0K" },
"legalAddress": { "addressLine1": "70 Grivas Digenis Avenue", "city": "Nicosia", "postalCode": "2682", "countryCode": "CY" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Ιδιοκτήτης", "englishTranslation": "Owner", "standardized": "Owner" }, "individual": { "name": { "fullName": "Ελένη Παπαδοπούλου", "firstName": "Ελένη", "lastName": "Παπαδοπούλου" } } }
]
}
```
**Note:** Business names (ΕΕ prefix) are sole trader registrations. They typically have a single legal representative with role `Ιδιοκτήτης` (Owner).
```json theme={null}
{
"company": {
"id": "ΕΕ5001",
"countryCode": "CY",
"identifiers": { "registrationNumber": "ΕΕ5001" },
"legalName": "NIKOS RESTAURANT",
"registrationDate": "1985-06-20",
"status": { "localName": "Διαγραμμένη", "active": false, "statusDetails": { "status": "CLOSED" } },
"legalForm": { "localName": "Εμπορική Επωνυμία", "englishTranslation": "Trade Name", "standardized": "Sole Proprietorship", "iso20275Code": "FV0K" }
}
}
```
**Note:** Inactive sole traders may not have address data or legal representatives in the registry. No closure date is provided for this entity type.
Shareholders are returned when `"dataPoints": ["shareholders"]` is requested. This requires retrieving the Trade Register Extract.
```json theme={null}
{
"shareholders": [
{ "type": "individual", "numberOfShares": 500, "individual": { "name": { "fullName": "Αντρέας Γεωργίου" } } },
{ "type": "company", "numberOfShares": 1000, "company": { "legalName": "FOREIGN HOLDING INC.", "countryCode": "US", "legalAddress": { "city": "Wilmington", "state": "Delaware", "countryCode": "US" } } }
]
}
```
**Note:** Shareholders extraction triggers billing via the `CYP_REGISTER_EXTRACT` catalog item. Share counts are extracted from the Study File; percentages are calculated when total share capital is available. Both Cypriot and foreign corporate shareholders are supported.
Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.
```json theme={null}
{
"availableDocuments": [
{
"id": "doc-uuid-placeholder",
"name": "Trade Register Extract",
"type": "trade_register_extract",
"format": "pdf",
"description": "Study File - public registry record from DRCOR containing company structure, officers, shareholders, filings, and status since incorporation",
"estimatedDeliverySeconds": 120
}
]
}
```
| API Category | Document | Notes |
| ---------------------- | ----------------------------------- | ------------------------------------------------------ |
| `tradeRegisterExtract` | Study File (Trade Register Extract) | \~2 min retrieval, English language, all company types |