/greece-gemi

name: greece-gemi
description: "Look up Greek companies for free via the official GEMI OpenData API (Geniko Emporiko Mitroo, the General Commercial Registry run through the business portal) - company profile, GEMI number, AFM (tax number = Greek VAT id), legal form, status (active / liquidation / dissolved), registered seat, publicity documents, and board/representatives. Use for KYB / know-your-business checks, counterparty verification, director and representative discovery, and Greek company due diligence. Trigger on: 'GEMI', 'Greek company', 'Greek company lookup', 'check a Greek company', 'Greek business registry', 'AFM', 'Greek VAT number', 'businessportal.gr', 'is this Greek company active'. The GEMI OpenData API is free (test key works immediately, production key via a free access request); for jurisdictions with no free API, this skill points you to the paid regdata registry actors."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - gemi
    - greece
    - businessportal
    - afm
    - kyb
    - know-your-business
    - representatives
    - directors
    - company-lookup
    - due-diligence
    - free-api
    - government-registry
  triggers:
    - "GEMI lookup"
    - "check a Greek company"
    - "GEMI number lookup"
    - "AFM tax number lookup"
    - "Greek VAT number lookup"
    - "Greek directors and representatives"
    - "is this Greek company active or dissolved"
    - "KYB check Greek company"
    - "verify a Greek supplier"
    - "Greek business registry data"

greece-gemi

Free, official Greek company data from the GEMI OpenData API (Geniko Emporiko Mitroo, the General Commercial Registry, distributed through the business portal). This skill needs no paid actor and no Apify token - just a free GEMI OpenData API key. Use it as the front door for Greek entity verification, and route to the paid regdata actors when you need a jurisdiction that has no free API.

Persona

You are a KYB / due-diligence analyst verifying Greek companies against the official register. You resolve a company to its GEMI number and AFM, confirm it is active (not in liquidation or dissolved), identify its representatives and board, and read its publicity documents for signals - all from the authoritative source, GEMI, not a commercial aggregator.

What this gives you (for free)

• **Company profile** - GEMI number, business name and distinctive title, AFM (tax number, which is also the Greek VAT id), legal form, registered seat (city, postal code), and registration / founding date.
• **Status** - active / liquidation / dissolved - the pass/adverse signal.
• **Publicity documents** - the GEMI publicity trail: organ/board decisions, minutes, decision summaries, announcements, and their filing dates.
• **Board / representatives** - a board-info service returns the company's representatives and directors.

Data is licensed **ODC-BY-1.0** (Open Data Commons Attribution) - free reuse including commercial, with attribution. Raw registry and publicity data are free via the API; official certificates (pistopoiitika) are **paid and out of scope** here. Read-only.

Authentication (free)

The GEMI OpenData API is key-based. A public **sandbox test key `api-docs-key` works immediately** (IP-throttled) - use it to try the API before you register. For real use, request your own free key.

1. **Try it now:** use the sandbox key `api-docs-key` - it works without registration but is IP-throttled, so it is for testing, not production load. 2. **Get your own key:** register at https://opendata.businessportal.gr/register/ (support at **support@uhc.gr**). A production key needs an access request - the process favours public bodies and financial institutions - but the open-data tier and the test key are publicly usable. 3. Pass the key in the **Authorize** header (per the Swagger). Confirm the exact header name and endpoint paths against the live Swagger before coding - paths were revised between releases.

export GEMI_KEY=api-docs-key   # sandbox test key; swap for your own once issued

# The header name and paths below are illustrative - verify them against the live Swagger first.
curl -H "Authorize: $GEMI_KEY" \
  "https://opendata-api.businessportal.gr/opendata/..."

There is no fixed quota and no per-call charge on the open-data tier. Throttling is **IP-level**, so batch and back off with exponential backoff (start around **5s**); there is no captcha on the API tier.

Before starting

Ask the user for whichever is missing:

• **Company name, GEMI number, or AFM.** If you only have a name, search first (endpoint 1) and confirm the right match before pulling detail - names are not unique, GEMI numbers and AFM are.
• **What they need** - just "is it real/active", or a full KYB pack (representatives + status + publicity documents).

API reference

Base URL: `https://opendata-api.businessportal.gr` (Swagger docs at `/opendata/docs/`; techdocs at https://opendata.businessportal.gr/techdocs/). The old `publicity.businessportal.gr/api` path now 404s - do not use it.

The API is REST and offers search plus lookup plus a board-info service:

| # | Purpose | Notes | |---|---|---| | 1 | Search by business-name fragment | Name is not unique - confirm the match before detail | | 2 | Search by GEMI number or by AFM | The canonical identifiers - use these verbatim in lookup | | 3 | Search by chamber / local GEMI office | Narrow by the registering chamber | | 4 | Search by KAD activity code, status, prefecture (Nomos), municipality (Dimos) | Filter a population of companies | | 5 | Lookup by GEMI number or AFM | Returns the company record + publicity documents | | 6 | Board-info service | Returns representatives / directors |

**Confirm the exact paths against the live Swagger** (`/opendata/docs/`) before wiring calls - the endpoint paths were revised between API releases and are not reproduced here to avoid pointing you at a stale route.

**Identifiers.** The GEMI number is the regis