Greece

eKYB Prefill in Greece leverages Greece's source of truth to automatically retrieve and populate business information based on a company's AFM or GEMI number, including the business name, entity type, registration status, registration date, credit rating, and other corporate details, without requiring manual input from the user.

Source

Direct API approach

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

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

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Tax ID formats

Greece supports two business identifier formats as search input. Requests with an invalid format return a 400 error.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "GR_KYB_PREFILL",
    "country": "GR",
    "taxId": "801725938",
    "businessName": "",
    "address": ""
}

Sample response

The Prefill response returns business data retrieved directly from the source of truth. Passthrough fields are returned as-is from the source, without fuzzy matching or verification scoring. Match fields (nameMatch, addressMatch) are only returned when the corresponding input (businessName, address) was submitted. Field availability varies by company — see the notes under each example below.

Example 1 — small company with trading name and previous name

{
    "kyb-prefill": [
        {
            "tin": "123456789000",
            "vatNo": "801725938",
            "name": "SAMPLE BOAT I.K.E.",
            "nameMatch": "Verified",
            "address": "Sample Street 1 Kerkyra Kerkyra 49100",
            "city": "Kerkyra",
            "postalCode": "49100",
            "entityType": "Private Capital Company",
            "registrationStatus": "Active",
            "registrationDate": "2023-05-12T00:00:00Z",
            "creditRating": "E",
            "creditRatingDescription": "Not Rated",
            "activityDesc": "Yachting",
            "turnover": { "currency": "EUR", "value": 74882 },
            "websites": ["www.sampleboat.example"],
            "shareholders": [
                { "name": "Sample Owner Name", "percentSharesHeld": 100 }
            ],
            "directors": [
                { "name": "Sample Director Name", "positionName": "Administrator" }
            ],
            "otherNames": [
                { "name": "SAMPLE BOAT", "businessNameType": "Trading Name" },
                { "name": "SAMPLE BOAT SINGLE MEMBER P.C.", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

Example 2 — company with multiple shareholders (limited turnover/contact data)

{
    "kyb-prefill": [
        {
            "tin": "987654321000",
            "vatNo": "802498747",
            "name": "SAMPLE RENTAL E.E.",
            "nameMatch": "Verified",
            "address": "Sample Avenue 86 Kavala Kavala 65404",
            "city": "Kavala",
            "postalCode": "65404",
            "entityType": "Limited Partnership",
            "registrationStatus": "Active",
            "registrationDate": "2026-02-02T00:00:00Z",
            "creditRating": "E",
            "creditRatingDescription": "Not Rated",
            "shareholders": [
                { "name": "Sample Shareholder One", "percentSharesHeld": 35 },
                { "name": "Sample Shareholder Two", "percentSharesHeld": 35 },
                { "name": "Sample Shareholder Three", "percentSharesHeld": 30 }
            ],
            "directors": [
                { "name": "Sample Director One", "positionName": "Administrator" },
                { "name": "Sample Director Two", "positionName": "Administrator" }
            ],
            "otherNames": [
                { "name": "SAMPLE TRADING NAME", "businessNameType": "Trading Name" },
                { "name": "SAMPLE RENTAL O.E.", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

(turnover, employeeCount, websites, otherAddresses omitted — not present in this response.)

Example 3 — larger company (with otherAddresses/employeeCount)

{
    "kyb-prefill": [
        {
            "tin": "456789123000",
            "vatNo": "094232831",
            "name": "SAMPLE SHOES SA",
            "nameMatch": "Verified",
            "address": "Sample Road 7 Argyroupoli 16452 Attiki",
            "entityType": "Societe Anonyme",
            "registrationStatus": "Active",
            "creditRating": "C",
            "creditRatingDescription": "Moderate Risk",
            "industryDesc": "Wholesale of clothing and footwear",
            "turnover": { "currency": "EUR", "value": 4887918 },
            "employeeCount": "19",
            "websites": ["www.sampleshoes.example"],
            "otherAddresses": [
                { "otherAddress": "Sample Secondary Address, Glyfada, Attiki 16675" }
            ],
            "otherNames": [
                { "name": "SAMPLE SHOES S.A.", "businessNameType": "Trading Name" },
                { "name": "SAMPLE SHOES S.A.", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

(otherNames entries here are near-duplicates of name, differing only in punctuation — a real, if unremarkable, response.)

Response fields

Error responses

For standard HTTP response codes, see the API Error Response page. Greece Prefill returns the following country-specific 400 errors.

taxId is not a valid 9-digit AFM or 12-digit GEMI number:

{
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid AFM (9 digits) or GEMI number (12 digits)",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Any mandatory field (plugins, source, country, or taxId) is missing:

{
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

No business match is found for the submitted taxId:

{
    "timestamp": 1782851583695,
    "status": 200,
    "message": "No business found matching the provided tax ID.",
    "path": "/omni/externalVerification/ekyb-prefill"
}`

Single Session Dashboard results

Prefill results are available on the Business tab in single Session view.