Greece

eKYB Verification in Greece leverages GR's source of truth to validate the legitimacy of businesses, including their tax ID, business name, business address, along with UBOs and directors.

Source

Country	Source	Description
Greece	`GR`	Validates Greek businesses against Greece's official source of truth.

Direct API approach

For general integration notes and shared response semantics, see the eKYB Verification API Reference.

All module configurations and user data can be forwarded directly in the request for performing a KYB search. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb

Request parameters

Parameter	Required	Description
plugins	Mandatory	String array. Must be `["ekyb"]`.
country	Mandatory	String. Two-letter Alpha-2 country code. Must be `GR`.
taxId	Mandatory	String. Greek AFM number or VAT number. See Tax ID formats below for details.
businessName	Optional	String. Registered name of the business.
street	Optional	String. Street name of the business address.
houseNo	Optional	String. Building or house number.
addressLine2	Optional	String. Additional address information.
city	Optional	String. City of the business address.
state	Optional	String. State or region of the business address.
postalCode	Optional	String. Greek postal code. Format: exactly 5 digits (for example, `10560`).
uboNames	Optional	Array of strings. Full legal name(s) of Ultimate Beneficial Owners to check against business records.
directors	Optional	Array of strings. Full legal name(s) of directors to check against business records.

Tax ID formats

The taxId field accepts two Greek business identifier types. Routing between them is determined automatically by the format and length of the submitted value.

ID Type	Description	Format	Routing logic	Example
AFM (Arithmos Forologikou Mitroou)	Greek Tax Registration Number assigned by AADE	Exactly 9 numeric digits	Routes to `vatNo` in source of truth lookup	`123456789`
VAT number	Greek intra-community VAT identifier	`EL` + 9 numeric digits — note the prefix is `EL`, not `GR`	`EL` prefix is stripped before lookup; 9-digit value is used as AFM	`EL123456789`

Inputs that do not match either format return a 400 error. The AFM is a separate identifier from the GEMI number (Genikó Emporikó Mitró / General Commercial Registry number), which is 12 digits and also accepted as taxId — in that case it routes to regNo in the source of truth lookup.

Sample request

{
    "plugins": ["ekyb"],
    "country": "GR",
    "taxId": "123456789",
    "businessName": "EXAMPLE COMPANY E.E.",
    "street": "Example Street",
    "houseNo": "10",
    "addressLine2": "",
    "city": "Athens",
    "state": "",
    "postalCode": "10560",
    "uboNames": ["John Doe"],
    "directors": ["Jane Smith"]
}

Sample response

{
  "kyb": [
    { "key": "name",                 "sub_label": "Verified" },
    { "key": "tin",                  "sub_label": "Verified" },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch",            "sub_label": "Verified" },
    { "key": "postalCodeMatch",      "sub_label": "Verified" },
    { "key": "registrationStatus",   "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": {
        "entityType": "Limited Partnership"
      }
    },
    {
      "key": "directors_name_match",
      "sub_label": "Verified",
      "directorsName_input": "Jane Smith"
    },
    {
      "key": "directors_name_match",
      "sub_label": "Unverified",
      "directorsName_input": "John Johnson"
    },
    {
      "key": "ubo_name_match",
      "sub_label": "Verified",
      "uboName_input": "John Doe"
    },
    {
      "key": "ubo_name_match",
      "sub_label": "Unverified",
      "uboName_input": "Sarah Smith"
    }
  ]
}

Response fields

Incode API Key	Status	Definition
name	Verified, Approximate Match, Unverified	Submitted business name is verified, approximate match, or unverified against the registered legal name associated with the business tax ID in the source of truth. Note: matching is performed against the registered legal name only — trading names are not checked.
tin	Verified, Unverified	Submitted AFM (tax ID) is found or not found in the source of truth.
address_verification	Verified, Approximate Match, Unverified	Submitted address is verified, approximate match, or unverified against the registered address associated with the business tax ID in the source of truth. Fuzzy matching is applied to the full address string.
cityMatch	Verified, Approximate Match, Unverified	Submitted city is verified, approximate match, or unverified against the city associated with the business tax ID in the source of truth.
postalCodeMatch	Verified, Unverified	Submitted postal code is verified or unverified against the postal code associated with the business tax ID in the source of truth. Format: exactly 5 digits (for example, `10560`).
registrationStatus	Active, Not active	Current registration status of the business as returned from the source of truth. `Active` = the business is currently active. `Not active` = the business is no longer active.
entityType	Legal entity type of the business	The legal form of the business as returned from the source of truth (for example, `Limited Partnership`, `Société Anonyme`). Passed through as-is — not fuzzy matched against anything in the request.
ubo_name_match	Verified, Approximate Match, Unverified	Submitted UBO name is matched against shareholders associated with the business tax ID in the source of truth. One entry is returned per submitted UBO name, distinguishable via `uboName_input`.
directors_name_match	Verified, Approximate Match, Unverified	Submitted director name is matched against current directors associated with the business tax ID in the source of truth. One entry is returned per submitted director name, distinguishable via `directorsName_input`.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

Results for Greece eKYB are available on the Business tab in single Session view.