Skip to main content

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.

Greece coverage, pricing, and sources

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) — 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) — 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

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:
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 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

Insolvency Statuses

Closed Statuses

Other Statuses

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 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

Limited Liability Companies

Partnerships

Cooperatives

Nonprofits & Civil Entities

Other

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 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

Common Greek Roles

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.

Ownership Fields

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):
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

GEMI API Documents (decisions)

GEMI API Documents (publications)

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

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": "<GEMI Number>", "countryCode": "GR", "dataPoints": ["company", "legalRepresentatives", "shareholders", "otherKeyPersons"] }
Note: AE (Corporation) companies have Board of Directors. No shareholders are available from the public GEMI registry for this legal form.
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.
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.
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.
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.

Quirks & Gotchas