> ## 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.
# Greece
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Greece. 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.
## Data Sources
Greece uses a single official registry operated by the Union of Hellenic Chambers of Commerce.
* **Γ.Ε.ΜΗ. (Γενικό Εμπορικό Μητρώο), General Commercial Registry (GEMI).** Maintained by the Union of Hellenic Chambers of Commerce since 2012, GEMI is the **sole data source** for all Greek commercial entities. It is reached through two surfaces:
* The **GEMI Open Data API** ([businessportal.gr](https://www.businessportal.gr)) — structured data powering the authoritative **verification** mode: company profiles, legal representatives, shareholders, activity codes, documents, and corporate announcements.
* The **GEMI Publicity Portal** ([publicity.businessportal.gr](https://publicity.businessportal.gr)) — powers company **search** and the fast **onboarding** profile (company details, management, ownership, and activity codes), plus printable trade register extracts and financial statements.
**Retrieval modes.** Both modes return authoritative GEMI data for the same datapoints.
* **`mode: "onboarding"`** (fast) — sourced from the GEMI Publicity Portal; returned in seconds.
* **`mode: "verification"`** (default) — sourced from the GEMI Open Data API, additionally geocoding the registered address and standardizing management roles. Slower but richer.
**Rate Limit:** The GEMI Open Data API enforces a rate limit of **8 requests per minute** (handled automatically). Search and the onboarding profile use the Publicity Portal and are not subject to it.
## Company Identifiers
### Query Identifiers
| Company Type | Source | Format | Example | Notes |
| --------------------------- | ------ | ------------------------- | ---------- | ---------------------------------------------- |
| **All commercial entities** | GEMI | 7-12 digits (GEMI Number) | `31301000` | Primary identifier for company profile lookups |
**GEMI Number Format:** GEMI numbers are numeric codes of 7-12 digits. Main companies typically end in `000` (e.g., `31301000`), while branches end in other digits (e.g., `31301001`). Only main company numbers are accepted for `/v2/company` company-data requests.
**GEMI Number only for company retrieval.** `/v2/company` only accepts the GEMI Number for Greek company-data requests. To look up a company by VAT number or name, use the search endpoint first to retrieve the GEMI Number, then use that for the company request.
### Identifiers in API Response
Once you retrieve company data, the `identifiers` object contains all available identifiers for that entity:
| Identifier Type | Format | Example | Found In |
| --------------- | -------------- | ------------- | ----------------------------------- |
| `gemiNumber` | 7-12 digits | `31301000` | All companies |
| `vatNumber` | EL + 9 digits | `EL093808863` | VAT-registered companies |
| `taxNumber` | 9 digits (AFM) | `093808863` | All companies with tax registration |
**VAT derived from AFM:** Greek VAT numbers are simply `EL` + AFM (Tax Number). For example, AFM `093808863` becomes VAT `EL093808863`. Note that Greece uses the prefix `EL` (not `GR`) for EU VAT purposes.
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ------------------ | ------------------------- | ------------- | ---------- | -------------------------------------------------------------------- |
| By GEMI Number | 7+ digits | `31301000` | Exact | Exact match returned first (matchType: id); other results may follow |
| By VAT Number | EL + 9 digits | `EL093808863` | Exact | Exact match returned first (matchType: id); other results may follow |
| By VAT (plain AFM) | 9 digits | `093808863` | Exact | Exact match returned first (matchType: id); other results may follow |
| By VAT (GR prefix) | GR + 9 digits | `GR093808863` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Name | Text string (min 2 chars) | `"CHEMCE"` | Fuzzy | Multiple results (up to 100) |
**Search Performance:** A single query is matched against name, GEMI Number, and AFM at once, and returns quickly for every input type — including broad name terms. Identifier searches return the exact match first (`matchType: id`); name searches are tokenized and may return multiple results. Search is free (no catalog item charge).
## Company Status
Company status is mapped **deterministically** from the GEMI API's official metadata endpoint (`metadata/companyStatuses`). All 12 GEMI status codes are mapped to standardized statuses.
### Active Statuses
| ID | Greek Status | English | Standardized Status | Notes |
| -- | ------------ | ------- | ------------------- | -------------------------------- |
| 3 | Ενεργή | Active | Active | Standard active status |
| 4 | Σε Αδράνεια | Dormant | Active | Legally active but not operating |
### Insolvency Statuses
| ID | Greek Status | English | Standardized Status | Closure Reason |
| -- | ----------------------- | ---------------------- | --------------------------- | -------------- |
| 5 | Πτώχευση | Bankruptcy | Under Insolvency Proceeding | Bankruptcy |
| 15 | Διαδικασία Συνδιαλλαγής | Conciliation Procedure | Under Insolvency Proceeding | N/A |
| 19 | Αναγκαστική διαχείριση | Forced Administration | Under Insolvency Proceeding | N/A |
### Closed Statuses
| ID | Greek Status | English | Standardized Status | Closure Reason |
| -- | ------------------------- | ------------------------- | ------------------- | -------------------------- |
| 7 | Λύση - Εκκαθάριση | Dissolution - Liquidation | Closed | Liquidation |
| 17 | Διαγραφή | Deletion | Closed | Administrative Dissolution |
| 18 | Διαγραφή λόγω συγχώνευσης | Deletion due to Merger | Closed | Merger |
| 20 | Διαγραφή λόγω διάσπασης | Deletion due to Division | Closed | Other |
### Other Statuses
| ID | Greek Status | English | Standardized Status | Notes |
| -- | -------------------- | ---------------------- | ------------------- | ------------------------- |
| 2 | Προεγγραφή | Pre-registration | Unknown | Registration in progress |
| 21 | Αναστολή καταχώρησης | Registration Suspended | Unknown | Registration is suspended |
| 0 | Άλλο | Other | Unknown | Catch-all status |
The local Greek status text is always preserved alongside the standardized status. Closure dates and insolvency start dates are derived from the `lastStatusChange` field when available.
## Legal Forms
Legal forms are mapped **deterministically** from the GEMI API's official metadata endpoint (`metadata/legalTypes`). All mappings include the local Greek abbreviation, English translation, standardized form, and ISO 20275 (ELF) code.
### Corporations
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | ---------------------- | ---------------------- | ------------ | --------- |
| 1 | ΑΕ | Public Limited Company | Corporation | W2NK |
| 12 | Ευρωπαϊκή Εταιρία (SE) | European Company (SE) | Corporation | CQ5X |
### Limited Liability Companies
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | ---------- | ------------------------------- | ------------------------- | --------- |
| 8 | ΕΠΕ | Limited Liability Company (LLC) | Limited Liability Company | H6OR |
| 19 | ΙΚΕ | Private Company (PC) | Limited Liability Company | QCA0 |
### Partnerships
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | ------------------------------------ | ------------------------------------------ | ------------ | --------- |
| 2 | ΟΕ | General Partnership (GP) | Partnership | TIZ2 |
| 4 | ΕΕ | Limited Partnership (LP) | Partnership | 54AL |
| 68 | ΕΕ κατά μετοχές | Limited Partnership by Shares | Partnership | UCU5 |
| 14 | Κοινοπραξία | Consortium / Joint Venture | Partnership | MCWR |
| 10 | Ευρωπαϊκός Όμιλος Οικονομικού Σκοπού | European Economic Interest Grouping (EEIG) | Partnership | QNWW |
### Cooperatives
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | -------------------------------------- | -------------------------------------------- | ------------ | --------- |
| 11 | Συνεταιρισμός | Cooperative | Cooperative | J3VJ |
| 13 | Ευρωπαϊκή Συνεταιριστική Εταιρία (SCE) | European Cooperative Society (SCE) | Cooperative | J3VJ |
| 20 | ΚΟΙ.Σ.Π.Ε | Limited Liability Social Cooperative (LLSCo) | Cooperative | J3VJ |
| 66 | Κοιν.Σ.Επ. | Social Cooperative Enterprise (SoCC) | Cooperative | J3VJ |
| 67 | Συνεταιρισμός Εργαζομένων | Workers' Cooperative | Cooperative | J3VJ |
| 65 | Ενεργειακή Κοινότητα | Energy Community | Cooperative | J3VJ |
| 3 | ΣυνΠΕ | Limited Liability Cooperative | Cooperative | J3VJ |
| 21 | Αγροτικός Συνεταιρισμός | Agricultural Cooperative | Cooperative | J3VJ |
| 69 | Κοινότητα Ανανεώσιμης Ενέργειας | Renewable Energy Community | Cooperative | J3VJ |
| 70 | Ενεργειακή Κοινότητα Πολιτών | Citizens Energy Community | Cooperative | J3VJ |
### Nonprofits & Civil Entities
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | ------------------------ | ----------------------------------- | ---------------------- | --------- |
| 17 | ΕΝΩΣΗ ΠΡΟΣΩΠΩΝ | Association of Persons | Nonprofit Organization | QSYQ |
| 18 | ΑΣΤΙΚΗ ΕΤΑΙΡΕΙΑ 784 Α.Κ. | Civil Company (Art. 784 Civil Code) | Nonprofit Organization | HKVP |
| 9 | ΚΟΙΝΩΝΙΑ | Society / Community | Nonprofit Organization | HKVP |
### Other
| ID | Local Name | English Translation | Standardized | ISO 20275 |
| -- | ---------------------- | ------------------------- | ------------------- | --------- |
| 16 | ΑΤΟΜΙΚΗ | Sole Proprietorship | Sole Proprietorship | N/A |
| 15 | Υποκατάστημα Αλλοδαπής | Branch of Foreign Company | Other | N/A |
| 64 | ΛΟΙΠΩΝ ΥΠΟΧΡΕΩΝ | Other Liable Entities | Other | JYKN |
All legal form mappings are deterministic, not AI-enriched. The local Greek abbreviation is always preserved alongside the English translation, standardized form, and ISO 20275 code.
## Legal Representatives
Legal representatives are extracted from the GEMI registry, and the classification (legal representative vs. other key person) is **legal-form aware**. It follows Greek company law on who legally represents each form (e.g. the *managing director* of an ΑΕ, the *manager* / *διαχειριστής* of an ΙΚΕ/ΕΠΕ, or the *general partner* of an ΟΕ/ΕΕ; a limited partner is never a representative). For a **sole proprietorship (ΑΤΟΜΙΚΗ)**, which has no separate legal personality, the **proprietor** is returned as the legal representative (standardized role `Owner`).
* In **`mode: "onboarding"`** (fast), roles are classified deterministically from the registry's role text and the company's legal form.
* In **`mode: "verification"`**, classification is additionally **AI-enriched** (analyzing each person's role text, category, and representation flags) and role titles are standardized.
### Representation Mode
For **Anonymes Etaireia (AE / SA)** companies with Board of Directors, GEMI provides structured boolean flags (`isRepresentativeAlone`, `isRepresentativeInCommon`) that indicate signing authority. These are enriched onto AI-parsed legal representatives via name matching:
* **`{ mode: "sole" }`**: Can sign alone (`isRepresentativeAlone: true`)
* **`{ mode: "joint" }`**: Must sign jointly (`isRepresentativeInCommon: true`)
* **`null`**: No signing authority flags set, or not applicable for this company type
`representationMode` is only populated for AE (SA) companies where GEMI provides the boolean flags. Other company types (IKE, EPE, OE, EE) do not have this data in GEMI.
### Person Categories from GEMI
| Greek Category | English | Contains |
| -------------------------- | ---------------------- | ---------------------------------------------- |
| Διοικητικό συμβούλιο | Board of Directors | Board members for AE (SA) companies |
| Εταίροι | Partners | Partners for partnerships and LLCs |
| Λοιπές ιδιότητες διοίκησης | Other Management Roles | Liquidators, receivers, special administrators |
### Common Greek Roles
| Greek Role | English Translation | Typical Classification |
| ------------------------- | ---------------------------- | --------------------------------------------------------- |
| Πρόεδρος | President / Chairman | Legal Representative |
| Διευθύνων Σύμβουλος | Managing Director / CEO | Legal Representative |
| Πρόεδρος & Διευθ. Σύμβουλ | Chairman & Managing Director | Legal Representative |
| Διαχειριστής | Manager | Legal Representative |
| Μέλος & Διαχειριστής | Partner & Manager | Legal Representative |
| Ατομικό Μέλος | Sole Proprietor | Legal Representative (`Owner`) for sole traders (ΑΤΟΜΙΚΗ) |
| Εκκαθαριστής | Liquidator | Legal Representative |
| Greek Role | English Translation | Typical Classification |
| ------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Αντιπρόεδρος | Vice President | Other Key Person |
| Εκτελεστικό Μέλος | Executive Member | Other Key Person |
| Μη Εκτελεστικό Μέλος | Non-Executive Member | Other Key Person |
| Ανεξάρτητο μη Εκτελεστικό Μέλος | Independent Non-Executive Member | Other Key Person |
| Μέλος | Board Member (ΑΕ only) | Other Key Person on an ΑΕ; on an ΙΚΕ/ΕΠΕ/ΟΕ/ΕΕ a bare "Μέλος" is a company member (owner) and appears as a **shareholder**, not a key person |
| Greek Role | English Translation | Typical Classification |
| ----------------- | ------------------- | ---------------------------- |
| Ομόρρυθμο Μέλος | General Partner | Shareholder (not key person) |
| Ετερόρρυθμο Μέλος | Limited Partner | Shareholder (not key person) |
**AI Role Classification:** Role names in GEMI are free-form Greek text, not standardized codes. The AI parser classifies each person based on their role text, category, and representation flags (`isRepresentativeAlone`, `isRepresentativeInCommon`). Partners who only hold shares but have no management role are filtered out of key persons and placed in the shareholders array instead.
**Representation Rights:** For board members (AE companies), the `representationMode` field indicates signing authority: `{ mode: "sole" }` for individual signing rights, `{ mode: "joint" }` for joint signing requirements.
## Shareholders
Shareholders are sourced from GEMI's **ownership records** (the register's member/partner data) for applicable company types, in **both** retrieval modes. This includes single-member (**μονοπρόσωπη**) companies, whose sole member is returned at **100%**, and both individual and **corporate** members (a company can be a partner). Only the current owners are returned; historical ownership entries are excluded.
### Legal Forms with Shareholders
| ID | Local Name | English | Notes |
| -- | -------------------- | ----------------------------- | --------------------------------- |
| 19 | ΙΚΕ | Private Company | Members with share percentages |
| 8 | ΕΠΕ | Limited Liability Company | Members with share participation |
| 2 | ΟΕ | General Partnership | General partners with percentages |
| 4 | ΕΕ | Limited Partnership | General and limited partners |
| 11 | Συνεταιρισμός | Cooperative | Members with percentages |
| 66 | Κοιν.Σ.Επ. | Social Cooperative Enterprise | Members with percentages |
| 65 | Ενεργειακή Κοινότητα | Energy Community | Members with percentages |
### Ownership Fields
| Field | Description | Source |
| -------------------- | ---------------------------- | -------------------------------------------------------- |
| `sharePercentage` | Ownership percentage (0-100) | GEMI ownership record. A sole member is `100`. |
| `nominalCapitalHeld` | Calculated capital held | `totalCapital * sharePercentage / 100` |
| `type` | `individual` or `company` | Whether the member is a natural person or a legal entity |
**Corporations (AE) do not expose shareholders** in the public GEMI registry. Shareholder information for corporations is typically only disclosed in annual reports. Only partnerships, private companies, LLCs, and cooperatives provide shareholder data via the API.
**Corporate members are supported.** A partner can be a legal entity (e.g. a holding company owning a single-member ΙΚΕ). Corporate members are returned with `type: "company"`, the member's legal name, and, when GEMI records it, the member's Greek tax number as `identifiers.taxNumber` (and `vatNumber` = `EL` + tax number). No country of domicile is asserted, as GEMI does not publish it (a foreign parent may carry a Greek tax registration).
**Single-member (μονοπρόσωπη) companies.** For a company with a single member, that member is returned at `sharePercentage: 100` holding the full nominal capital, whether the member is an individual or a company.
## Activity Code Mapping
Greece uses the **KAD** (Κωδικός Αριθμός Δραστηριότητας) classification, which extends the European NACE Rev. 2 standard with Greek-specific subdivisions. The system maps activity codes across three levels, all **deterministically** (no AI inference):
```
KAD XXYYZZZZ (Greek) → NACE XX.YY (European) → ISIC (International, via correspondence table)
```
| Classification | Source | Example | AI Inferred? |
| -------------- | ------------------------------------------------- | ---------- | ------------------ |
| **KAD** | GEMI registry | `62010000` | No (official) |
| **NACE** | Derived from KAD (first 4 digits → XX.YY) | `62.01` | No (deterministic) |
| **ISIC** | Derived from NACE (official correspondence table) | `6201` | No (deterministic) |
**All activity code mappings are deterministic for Greece.** Unlike some countries, ISIC codes are derived from NACE via the official NACE-to-ISIC correspondence table, not via AI. The `isAIInferred` flag is always `false`. KAD descriptions are preserved in Greek from the GEMI registry.
**KAD Code Structure:** KAD codes are 8 digits (`XXYYZZZZ`), where the first 4 digits correspond to NACE Rev. 2 (`XX.YY`) and the last 4 digits are Greek-specific subdivisions. For example, KAD `62010000` maps to NACE `62.01` (Computer programming activities).
## Documents by Company Type
Greece provides document access through the GEMI Open Data API (decisions and publications) and the GEMI Publicity Portal (trade register extract). Available documents listing is **free** (no catalog item charge).
### Always Available
| Document Type | API Category | Format | Catalog item | Availability | Notes |
| -------------------------- | ---------------------- | ------ | ---------------------------- | ------------- | ------------------------------------------------------------------- |
| **Trade Register Extract** | `tradeRegisterExtract` | PDF | `GRC_TRADE_REGISTER_EXTRACT` | All companies | Scraped from GEMI Publicity Portal, mixed English/Greek, TTL: 1 day |
### GEMI API Documents (decisions)
| Document Type | API Category | Format | Catalog item | Availability | Notes |
| --------------------------- | ------------------------- | ------ | ----------------------------- | -------------- | -------------------------------------------------------------------------------- |
| **Financial Statements** | `financialStatements[]` | PDF | `GRC_FINANCIAL_STATEMENTS` | When filed | Balance sheets, ELP/IFRS reports, fiscal year inferred |
| **Articles of Association** | `articlesOfAssociation[]` | PDF | `GRC_ARTICLES_OF_ASSOCIATION` | When filed | Establishment notices, statute amendments, conversions |
| **Official Publications** | `officialPublications[]` | PDF | `GRC_GEMI_ANNOUNCEMENT` | When available | Board changes, capital changes, mergers, bankruptcy filings, liquidation notices |
| **Other Documents** | `otherDocuments[]` | PDF | `GRC_DOCUMENT` | When available | Partner withdrawals, general filings, error corrections |
### GEMI API Documents (publications)
| Document Type | API Category | Format | Catalog item | Availability | Notes |
| ----------------------------- | ------------------------- | ------ | ----------------------------- | -------------- | --------------------------------------- |
| **Formation Documents (YMS)** | `articlesOfAssociation[]` | PDF | `GRC_ARTICLES_OF_ASSOCIATION` | When available | One-Stop Shop (YMS) formation documents |
**All GEMI documents are free.** Unlike some countries, there is no per-document fee for Greek company documents. Documents are downloaded directly from the GEMI Open Data API. The Trade Register Extract requires web scraping from the GEMI Publicity Portal.
The GEMI API classifies documents using 114 decision subject IDs from the `metadata/assemblySubjects` endpoint. These are grouped into the following categories:
**Financial Statements** (IDs: 4, 7, 8, 9, 11, 17, 21, 42, 48, 72, 78, 79, 82, 95):
Balance sheet publications, financial statement approvals, bank balance sheets, consolidated statements, liquidation balance sheets.
**Articles of Association** (IDs: 18, 29, 30, 34, 35, 73, 74):
Establishment notices, statute amendments, registration of articles, IKE conversion documents.
**Board/Governance Changes** (IDs: 2, 10, 26, 43, 75, 80, 92, 118):
Board reconstitution, representation changes, first Board establishment, audit committee publicity, administrator designation.
**Capital Changes** (IDs: 3, 23, 24, 31, 45, 46, 54, 56, 66, 67, 68, 76, 77, 105):
Share capital increases/decreases, retrieval certifications, capital adjustments, pre-emption rights.
**Mergers/Splits/Transformations** (IDs: 27, 28, 70, 85, 104, 107, 114, 115):
Merger notices, division notices, draft agreements, conversions, deletion due to merger/division.
**Liquidation/Dissolution** (IDs: 5, 19, 20, 22, 36, 52, 96):
Dissolution announcements, liquidator appointments, end of liquidation, revival.
**Bankruptcy/Insolvency** (IDs: 12, 14, 15, 16, 37, 38, 39, 40, 41):
Bankruptcy petitions, bankruptcy declarations, conciliation proceedings, closure/recall of bankruptcy.
**Registration/Status Changes** (IDs: 55, 81, 94, 99, 100, 106):
Deletion, retroactive deletion, revocation/reversal of registration.
**Branches** (IDs: 101, 108, 116, 119):
Branch creation, branch changes, branch deletion, foreign company representative designation.
**Other** (IDs: 1, 6, 13, 25, 32, 33, 44, 49, 50, 51, 53, 57, 58, 59, 60, 61, 63, 64, 65, 69, 71, 83, 86, 87, 88, 89, 90, 91, 93, 103, 109, 110, 111, 112, 113, 120):
Address changes, stock options, auditor elections, valuation reports, remuneration reports, partner withdrawals, error corrections.
## Data Availability Matrix
| Data Type | All Companies | Notes |
| ------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Company Profile | ✅ Async | Full data from GEMI Open Data API |
| Legal Representatives | ✅ | Legal-form-aware; sole traders (ΑΤΟΜΙΚΗ) return the proprietor as `Owner`. Roles AI-standardized in verification mode |
| Other Key Persons | ✅ | Board members, auditors |
| Shareholders | ⚠️ Not for AE | Partnerships, private companies (ΙΚΕ), LLCs and cooperatives, including single-member (μονοπρόσωπη) companies (sole member at 100%) and corporate members. Not available for AE (Corporations) |
| Ultimate Beneficial Owners | ❌ | Separate register (Ministry of Finance), not publicly accessible |
| Establishments | ❌ | Branch data exists in GEMI but not exposed in current implementation |
| Activity Codes (KAD/NACE/ISIC) | ✅ | All deterministic, no AI inference |
| Trade Register Extract | ✅ | Scraped from Publicity Portal |
| Financial Statements | ⚠️ When filed | From GEMI decisions |
| Articles of Association | ⚠️ When filed | From GEMI decisions/publications |
| Official Publications | ⚠️ When available | Board changes, capital changes, etc. |
**Legend:** ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing
## Example API Responses
Identifiers and personal names below are **illustrative placeholders**, but the response shapes match real GEMI output. Query: `POST /v2/company` with `{ "id": "", "countryCode": "GR", "dataPoints": ["company", "legalRepresentatives", "shareholders", "otherKeyPersons"] }`
```json theme={null}
{
"company": {
"id": "31301000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "31301000",
"vatNumber": "EL093808863",
"taxNumber": "093808863"
},
"taxId": {
"type": "eu_vat",
"value": "EL093808863",
"country": "GR",
"verification": { "status": "verified", "verifiedName": "EXAMPLE INDUSTRIAL AE" }
},
"legalName": "EXAMPLE INDUSTRIAL Ανώνυμος Εμπορική Εταιρεία",
"englishName": "EXAMPLE INDUSTRIAL SA",
"registrationDate": "2005-06-12",
"activityDescription": "Εμπορία χημικών προϊόντων και τυπογραφικών μελανιών.",
"status": {
"localName": "Ενεργή",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "ΑΕ",
"englishTranslation": "Public Limited Company",
"standardized": "Corporation",
"iso20275Code": "W2NK"
},
"capital": { "amount": 120000, "currency": "EUR" },
"activities": {
"KAD": [{ "code": "46751262", "description": "ΧΟΝΔΡΙΚΟ ΕΜΠΟΡΙΟ ΤΥΠΟΓΡΑΦΙΚΗΣ ΜΕΛΑΝΗΣ", "isAIInferred": false }],
"NACE": [{ "code": "46.75", "isAIInferred": false }],
"ISIC": [{ "code": "4690", "description": "Non-specialized wholesale trade", "isAIInferred": false }]
},
"legalAddress": {
"addressLine1": "ΚΗΦΙΣΙΑΣ 102",
"city": "ΑΘΗΝΑ",
"postalCode": "11526",
"region": "ΑΤΤΙΚΗΣ",
"countryCode": "GR"
},
"phones": ["2107010275"],
"emails": ["info@example.gr"],
"website": "https://www.example.gr"
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Πρόεδρος & Διευθ. Σύμβουλ", "standardized": "Managing Director" },
"representationMode": { "mode": "sole" },
"individual": { "name": { "fullName": "ΙΩΑΝΝΗΣ ΠΑΠΑΔΟΠΟΥΛΟΣ", "firstName": "ΙΩΑΝΝΗΣ", "lastName": "ΠΑΠΑΔΟΠΟΥΛΟΣ" } },
"startDate": "2024-04-02",
"endDate": "2027-04-01"
}
],
"otherKeyPersons": [
{
"type": "individual",
"role": { "localName": "Αντιπρόεδρος", "standardized": "Board Member" },
"individual": { "name": { "fullName": "ΜΑΡΙΑ ΓΕΩΡΓΙΟΥ" } },
"startDate": "2024-04-02",
"endDate": "2027-04-01"
},
{
"type": "individual",
"role": { "localName": "Μέλος", "standardized": "Board Member" },
"individual": { "name": { "fullName": "ΝΙΚΟΣ ΑΝΤΩΝΙΟΥ" } },
"startDate": "2024-04-02",
"endDate": "2027-04-01"
}
]
}
```
**Note:** AE (Corporation) companies have Board of Directors. No shareholders are available from the public GEMI registry for this legal form.
```json theme={null}
{
"company": {
"id": "13701000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "13701000",
"vatNumber": "EL082592010",
"taxNumber": "082592010"
},
"legalName": "DIGITAL SOLUTIONS ΙΚΕ",
"registrationDate": "2020-02-15",
"activityDescription": "Δραστηριότητες παροχής συμβουλών σε θέματα πληροφορικής.",
"status": {
"localName": "Ενεργή",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "ΙΚΕ",
"englishTranslation": "Private Company (PC)",
"standardized": "Limited Liability Company",
"iso20275Code": "QCA0"
},
"capital": { "amount": 1000, "currency": "EUR" },
"activities": {
"KAD": [{ "code": "62020000", "description": "Δραστηριότητες παροχής συμβουλών σε θέματα πληροφορικής", "isAIInferred": false }],
"NACE": [{ "code": "62.02", "isAIInferred": false }],
"ISIC": [{ "code": "6202", "description": "Computer consultancy and computer facilities management activities", "isAIInferred": false }]
},
"legalAddress": {
"addressLine1": "ΕΡΜΟΥ 25",
"city": "ΘΕΣΣΑΛΟΝΙΚΗ",
"postalCode": "54624",
"region": "ΘΕΣΣΑΛΟΝΙΚΗΣ",
"countryCode": "GR"
},
"phones": ["2109339090"],
"website": "https://www.example-ike.gr"
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Μέλος & Διαχειριστής", "standardized": "Managing Director" },
"individual": { "name": { "fullName": "ΔΗΜΗΤΡΙΟΣ ΚΩΝΣΤΑΝΤΙΝΟΥ", "firstName": "ΔΗΜΗΤΡΙΟΣ", "lastName": "ΚΩΝΣΤΑΝΤΙΝΟΥ" } },
"startDate": "2025-09-19"
}
],
"shareholders": [
{
"type": "individual",
"sharePercentage": 91,
"nominalCapitalHeld": { "amount": 910, "currency": "EUR" },
"individual": { "name": { "fullName": "ΔΗΜΗΤΡΙΟΣ ΚΩΝΣΤΑΝΤΙΝΟΥ" } }
},
{
"type": "individual",
"sharePercentage": 9,
"nominalCapitalHeld": { "amount": 90, "currency": "EUR" },
"individual": { "name": { "fullName": "ΕΛΕΝΗ ΣΤΑΜΑΤΙΟΥ" } }
}
]
}
```
**Note:** IKE (Private Company) shareholders include ownership percentages and calculated nominal capital held. The managing partner appears as both a legal representative and a shareholder.
```json theme={null}
{
"company": {
"id": "12345601000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "12345601000",
"vatNumber": "EL800000001",
"taxNumber": "800000001"
},
"legalName": "EXAMPLE HOSPITALITY ΜΟΝΟΠΡΟΣΩΠΗ ΙΚΕ",
"registrationDate": "2013-05-03",
"status": {
"localName": "Ενεργή",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "ΙΚΕ",
"englishTranslation": "Private Company (PC)",
"standardized": "Limited Liability Company",
"iso20275Code": "QCA0"
},
"capital": { "amount": 3000, "currency": "EUR" }
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Διαχειριστής", "standardized": "Manager" },
"individual": { "name": { "fullName": "ΑΝΤΩΝΙΟΣ ΡΩΤΑΣ" } },
"startDate": "2013-05-03"
}
],
"shareholders": [
{
"type": "company",
"sharePercentage": 100,
"nominalCapitalHeld": { "amount": 3000, "currency": "EUR" },
"company": {
"id": "800000002",
"identifiers": { "taxNumber": "800000002", "vatNumber": "EL800000002" },
"legalName": "EXAMPLE HOLDINGS ΙΚΕ"
}
}
]
}
```
**Note:** A single-member company returns its sole member at `sharePercentage: 100` holding the full nominal capital. Here the member is another company (`type: "company"`), returned with its Greek tax number as identifiers and no `countryCode`. The manager is a separate individual returned as the legal representative.
```json theme={null}
{
"company": {
"id": "10203001000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "10203001000",
"vatNumber": "EL070000001",
"taxNumber": "070000001"
},
"legalName": "ΓΕΩΡΓΙΟΣ ΠΑΠΑΔΟΠΟΥΛΟΣ ΤΟΥ ΙΩΑΝΝΗ",
"status": {
"localName": "Ενεργή",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "ΑΤΟΜΙΚΗ",
"englishTranslation": "Sole Proprietorship",
"standardized": "Sole Proprietorship"
},
"activities": {
"KAD": [{ "code": "47711203", "description": "ΛΙΑΝΙΚΟ ΕΜΠΟΡΙΟ ΕΝΔΥΜΑΤΩΝ", "isAIInferred": false }],
"NACE": [{ "code": "47.71", "isAIInferred": false }],
"ISIC": [{ "code": "4771", "description": "Retail sale of clothing, footwear and leather articles in specialized stores", "isAIInferred": false }]
},
"legalAddress": {
"addressLine1": "ΠΕΛΟΠΙΔΑ 47",
"city": "ΠΕΡΙΣΤΕΡΙ",
"postalCode": "12135",
"region": "ΑΤΤΙΚΗΣ",
"countryCode": "GR"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Ατομικό Μέλος", "standardized": "Owner" },
"individual": { "name": { "fullName": "ΓΕΩΡΓΙΟΣ ΠΑΠΑΔΟΠΟΥΛΟΣ" } }
}
]
}
```
**Note:** A sole proprietorship (ΑΤΟΜΙΚΗ) has no separate legal personality, so the proprietor is returned as the legal representative with standardized role `Owner`. Sole traders have no shareholders. The legal name is the proprietor's own name as registered in GEMI.
```json theme={null}
{
"company": {
"id": "6101000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "6101000",
"vatNumber": "EL091016194",
"taxNumber": "091016194"
},
"legalName": "(ΥΠΟ ΕΚΚΑΘΑΡΙΣΗ) EXAMPLE ΕΜΠΟΡΙΚΗ Ο.Ε.",
"englishName": "(UNDER LIQUIDATION) EXAMPLE TRADING O.E.",
"tradeNames": ["ELPACO"],
"registrationDate": "1964-08-01",
"activityDescription": "Αντιπροσώπευση εμπορικών οίκων εξωτερικού και εσωτερικού.",
"status": {
"localName": "Λύση - Εκκαθάριση",
"active": false,
"statusDetails": {
"status": "CLOSED",
"closureReason": "Liquidation",
"closureDate": "2021-09-27"
}
},
"legalForm": {
"localName": "ΟΕ",
"englishTranslation": "General Partnership (GP)",
"standardized": "Partnership",
"iso20275Code": "TIZ2"
},
"activities": {
"KAD": [{ "code": "46141330", "description": "ΕΜΠΟΡΙΚΟΙ ΑΝΤΙΠΡΟΣΩΠΟΙ ΠΟΥ ΜΕΣΟΛΑΒΟΥΝ ΣΤΗΝ ΠΩΛΗΣΗ ΜΗΧΑΝΗΜΑΤΩΝ", "isAIInferred": false }],
"NACE": [{ "code": "46.14", "isAIInferred": false }],
"ISIC": [{ "code": "4610", "description": "Wholesale on a fee or contract basis", "isAIInferred": false }]
},
"legalAddress": {
"addressLine1": "ΑΡΤΕΜΙΔΟΣ 3",
"city": "ΜΑΡΟΥΣΙ",
"postalCode": "15125",
"region": "ΑΤΤΙΚΗΣ",
"countryCode": "GR"
},
"phones": ["2106255000"],
"emails": ["info@example.gr"]
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Εκκαθαριστής", "standardized": "Liquidator" },
"individual": { "name": { "fullName": "ΑΛΕΞΑΝΔΡΟΣ ΠΕΤΡΟΥ", "firstName": "ΑΛΕΞΑΝΔΡΟΣ", "lastName": "ΠΕΤΡΟΥ" } },
"startDate": "2021-09-27"
}
]
}
```
**Note:** Closed companies show `active: false` with closure details including the reason and date. Companies in liquidation typically have a Liquidator (Εκκαθαριστής) as a legal representative.
```json theme={null}
{
"company": {
"id": "9901000",
"countryCode": "GR",
"identifiers": {
"gemiNumber": "9901000",
"vatNumber": "EL091607191",
"taxNumber": "091607191"
},
"legalName": "(ΠΤΩΧΕΥΣΗ) EXAMPLE ΕΜΠΟΡΙΚΗ Ο.Ε.",
"tradeNames": ["(ΠΤΩΧΕΥΣΗ) EXAMPLE TRADE"],
"registrationDate": "1968-10-12",
"activityDescription": "Εμπορία ανταλλακτικών αυτοκινήτων.",
"status": {
"localName": "Πτώχευση",
"active": false,
"statusDetails": {
"status": "UNDER_INSOLVENCY_PROCEEDING",
"closureReason": "Bankruptcy",
"insolvencyStartDate": "1968-10-12"
}
},
"legalForm": {
"localName": "ΟΕ",
"englishTranslation": "General Partnership (GP)",
"standardized": "Partnership",
"iso20275Code": "TIZ2"
},
"activities": {
"KAD": [
{ "code": "45311217", "description": "ΧΟΝΔΡΙΚΟ ΕΜΠΟΡΙΟ ΚΑΙΝΟΥΡΓΙΩΝ ΑΝΤΑΛΛΑΚΤΙΚΩΝ ΚΑΙ ΕΞΑΡΤΗΜΑΤΩΝ ΑΥΤΟΚΙΝΗΤΩΝ", "isAIInferred": false },
{ "code": "45321212", "description": "ΛΙΑΝΙΚΟ ΕΜΠΟΡΙΟ ΚΑΙΝΟΥΡΓΙΩΝ ΑΝΤΑΛΛΑΚΤΙΚΩΝ ΚΑΙ ΕΞΑΡΤΗΜΑΤΩΝ ΑΥΤΟΚΙΝΗΤΩΝ", "isAIInferred": false }
],
"NACE": [
{ "code": "45.31", "isAIInferred": false },
{ "code": "45.32", "isAIInferred": false }
],
"ISIC": [{ "code": "4530", "description": "Sale of motor vehicle parts and accessories", "isAIInferred": false }]
},
"legalAddress": {
"addressLine1": "ΘΕΡΜΟΠΥΛΩΝ 57",
"city": "ΑΘΗΝΑ",
"postalCode": "10435",
"region": "ΑΤΤΙΚΗΣ",
"countryCode": "GR"
},
"phones": ["2105249478"],
"emails": ["info@example.gr"]
},
"shareholders": [
{
"type": "individual",
"sharePercentage": 90,
"individual": { "name": { "fullName": "ΚΩΝΣΤΑΝΤΙΝΟΣ ΠΑΠΑΔΟΠΟΥΛΟΣ" } }
},
{
"type": "individual",
"sharePercentage": 10,
"individual": { "name": { "fullName": "ΒΑΣΙΛΙΚΗ ΓΕΩΡΓΙΟΥ" } }
}
]
}
```
**Note:** Companies under insolvency proceeding show `active: false` with `status: "UNDER_INSOLVENCY_PROCEEDING"` and `closureReason: "Bankruptcy"`. Partnership shareholders with ownership percentages are still available.
Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.
| API Category | Document | Catalog item | Notes |
| ------------------------- | --------------------------------- | ----------------------------- | ----------------------------------------------------------- |
| `tradeRegisterExtract` | GEMI Trade Register Extract (PDF) | `GRC_TRADE_REGISTER_EXTRACT` | Always available, scraped from Publicity Portal |
| `financialStatements[]` | Financial Statements (PDF) | `GRC_FINANCIAL_STATEMENTS` | When filed (balance sheets, IFRS/ELP reports) |
| `articlesOfAssociation[]` | Articles of Association (PDF) | `GRC_ARTICLES_OF_ASSOCIATION` | Establishment notices, amendments, YMS formation docs |
| `officialPublications[]` | Official Publications (PDF) | `GRC_GEMI_ANNOUNCEMENT` | Board changes, capital changes, mergers, bankruptcy filings |
| `otherDocuments[]` | Other Documents (PDF) | `GRC_DOCUMENT` | Partner withdrawals, general filings, error corrections |
## Quirks & Gotchas
| Quirk | Details |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **GEMI Number only for company retrieval** | `/v2/company` only accepts the GEMI Number. VAT numbers and company names must use the search endpoint first to retrieve the GEMI Number. |
| **VAT uses EL prefix, not GR** | Greek VAT numbers use the EU prefix `EL` (not the ISO country code `GR`). For example, AFM `093808863` becomes `EL093808863`. Both `EL` and `GR` prefixes are accepted in search. |
| **KAD codes extend NACE** | Greek KAD codes are 8 digits (`XXYYZZZZ`), where the first 4 digits correspond to NACE Rev. 2 (`XX.YY`). The last 4 digits are Greek-specific subdivisions. |
| **ISIC is fully deterministic** | Unlike some countries, ISIC codes for Greece are derived deterministically from NACE via the official correspondence table, not via AI. The `isAIInferred` flag is always `false`. |
| **Shareholders limited to certain forms** | Shareholder data is available for partnerships (OE, EE), private companies (IKE), LLCs (EPE), and cooperatives, including single-member (μονοπρόσωπη) companies (sole member at 100%) and corporate members. Corporations (AE) do not expose shareholders in the public registry. |
| **Sole traders return the proprietor as legal rep** | A sole proprietorship (ΑΤΟΜΙΚΗ) has no separate legal personality, so the proprietor is returned as the legal representative with standardized role `Owner`. Sole traders have no shareholders. |
| **No UBO data** | Ultimate Beneficial Owner data is maintained in a separate register (Μητρώο Πραγματικών Δικαιούχων) managed by the Ministry of Finance and is **not publicly accessible**. |
| **All documents are free** | All GEMI documents (decisions and publications) are available for free download. The Trade Register Extract is generated by scraping the GEMI Publicity Portal. |
| **12 possible GEMI statuses** | GEMI has 12 status codes including Active, Dormant, Pre-registration, Bankruptcy, Dissolution, Deletion (various reasons), Forced Administration, Conciliation, and Suspension. |
| **Dormant = legally active** | Companies with status "Σε Αδράνεια" (Dormant) are mapped as `active: true` because dormant companies are still legally registered entities, just not operating. |
| **Greek text preserved** | Legal names, addresses, activity descriptions, and status names are preserved in Greek. English names are returned when available in the registry. Addresses are geocoded via Nominatim. |
| **Rate limit: 8 req/min** | The GEMI Open Data API enforces a strict rate limit of 8 requests per minute. Rate limiting is handled automatically. |
| **AI-enriched role classification** | Legal representative vs. other key person classification is AI-enriched because GEMI stores roles as free-form Greek text without standardized codes. The AI also produces English translations and standardized role names. |
| **Percentage format inconsistency** | GEMI returns ownership percentages in inconsistent formats: `"91%"`, `"9%"`, `"0.994"` (meaning 99.4%), the bare fraction `"1"` (meaning 100%), or `"-"` (no percentage). The system normalizes all formats to a 0-100 scale, and a single member is always resolved to 100%. |
| **Trade Register Extract via scraping** | The Trade Register Extract is **not** available through the GEMI Open Data API. It requires web scraping of the GEMI Publicity Portal (`publicity.businessportal.gr`), which generates a bilingual (English/Greek) PDF. TTL is 1 day. |