Austria

eKYB Prefill in Austria leverages Austria's source of truth to automatically retrieve and populate business information based on a company's FN number or VAT 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

Country	Source	Description
Austria	`AT_KYB_PREFILL`	Returns matching Austrian business details from Austria's source of truth for pre-fill.

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

Parameter	Required	Description
`plugins`	Mandatory	String array. Must be `["ekyb-prefill"]`. Specifies the Prefill flow.
`source`	Mandatory	String. Must be `AT_KYB_PREFILL`. Identifies the Prefill source.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `AT`.
`taxId`	Mandatory	String. FN number or VAT number. See Tax ID formats for details.
`businessName`	Optional	String. Registered business name, used to verify the match against the source of truth.
`address`	Optional	String. Business address, used to verify the match against the source of truth.

Tax ID formats

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

Entity Type	Format
FN (Firmenbuchnummer)	`FN` + a space + digits + a check letter (e.g. `FN 109608P`)
VAT number	`AT` + `U` + 8 digits (e.g. `ATU25486907`)

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "AT_KYB_PREFILL",
    "country": "AT",
    "taxId": "FN 109608P",
    "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 significantly by company — see the notes under each example below.

Example 1 — large, established company (with parent)

{
    "kyb-prefill": [
        {
            "tin": "FN 109608p",
            "vatNo": "ATU25486907",
            "name": "Sample Shoes Austria GmbH",
            "nameMatch": "Verified",
            "address": "Sample Straße 2, 9560 Sampletown",
            "city": "Sampletown",
            "postalCode": "9560",
            "entityType": "limited liability company",
            "registrationStatus": "Active",
            "registrationDate": "1969-08-13T00:00:00Z",
            "creditRating": "A",
            "creditRatingDescription": "Very Low Risk",
            "industryDesc": "Wholesale of footwear",
            "activityDesc": "WHOLESALE AND RETAIL TRADE",
            "turnover": { "currency": "EUR", "value": 56160000 },
            "employeeCount": "81",
            "leiNumber": "5299000000000000AB12",
            "websites": ["https://www.sampleshoes.example"],
            "shareholders": [
                { "name": "Sample Shoes GmbH", "percentSharesHeld": 100 }
            ],
            "ultimateParent": { "name": "SAMPLE SHOES HOLDING", "country": "DE" },
            "immediateParent": { "name": "SAMPLE SHOES HOLDING", "country": "DE" },
            "otherNames": [
                { "name": "Sample Shoes GmbH", "businessNameType": "Previous Name" },
                { "name": "Sample-Schuhfabriken Gesellschaft m.b.H.", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

Example 2 — small, single-owner company

{
    "kyb-prefill": [
        {
            "tin": "FN 292309t",
            "vatNo": "ATU63372512",
            "name": "Sample Planning GmbH",
            "nameMatch": "Verified",
            "address": "Sample Weg B8, 7093 Sample Village",
            "city": "Sample Village",
            "postalCode": "7093",
            "entityType": "limited liability company",
            "registrationStatus": "Active",
            "registrationDate": "2007-04-28T00:00:00Z",
            "creditRating": "A",
            "creditRatingDescription": "Very Low Risk",
            "industryDesc": "Other renting and operating of own or leased real estate",
            "activityDesc": "REAL ESTATE ACTIVITIES",
            "employeeCount": "1",
            "shareholders": [
                { "name": "Sample Owner Name", "percentSharesHeld": 100 }
            ],
            "otherNames": [
                { "name": "Sample Architect Studio GmbH", "businessNameType": "Previous Name" },
                { "name": "Sample Planning GmbH (old)", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

Example 3 — large holding-type entity (cross-border parent)

{
    "kyb-prefill": [
        {
            "tin": "FN 364103x",
            "name": "Sample Glass Trading GmbH",
            "nameMatch": "Verified",
            "address": "Sample Platz 7, 1010 Sample City",
            "city": "Sample City",
            "postalCode": "1010",
            "entityType": "limited liability company",
            "registrationStatus": "Active",
            "registrationDate": "2011-06-17T00:00:00Z",
            "creditRating": "A",
            "creditRatingDescription": "Very Low Risk",
            "industryDesc": "Wholesale of china and glassware and cleaning materials",
            "activityDesc": "WHOLESALE AND RETAIL TRADE",
            "employeeCount": "0",
            "leiNumber": "5299000000000000CD34",
            "shareholders": [
                { "name": "Sample Green Energy GmbH", "percentSharesHeld": 100 }
            ],
            "ultimateParent": { "name": "SAMPLE GLASS HOLDING GMBH", "country": "LI" },
            "immediateParent": { "name": "SAMPLE GLASS HOLDING GMBH", "country": "LI" },
            "otherNames": [
                { "name": "Sample-East Glass Trading GmbH", "businessNameType": "Previous Name" }
            ]
        }
    ]
}

Info

Field availability differs significantly by company, regardless of size. vatNo, turnover, leiNumber, ultimateParent/immediateParent, and websites may all be absent even for large, established companies — this is expected and does not indicate an error.

Response fields

Key	Value	Description
`tin`	FN number	Firmenbuchnummer, as returned from the source of truth.
`vatNo`	VAT number	May not be present, even for large companies.
`name`	Business name	The registered legal name of the business as returned from the source of truth.
`nameMatch`	Verified, Approximate Match, Unverified	Match result comparing the submitted `businessName` against the registered name. Only returned when `businessName` is submitted.
`address`	Address	The registered business address as returned from the source of truth.
`addressMatch`	Verified, Approximate Match, Unverified	Match result comparing the submitted `address` against the registered address. Only returned when `address` is submitted.
`city`	City	The city associated with the registered business address, when available.
`postalCode`	Postal code	The postal code associated with the registered business address, when available.
`entityType`	Entity type	The legal entity type of the business (e.g. limited liability company). Defaults to "Unknown" when not available.
`registrationStatus`	Active, Expired, Unknown, Not Found	Current registration status of the business. Defaults to "Unknown" when not available.
`registrationDate`	Date	The date the business was registered.
`creditRating`	Rating value (e.g. A, C)	The business's credit rating, as returned from the source of truth. Defaults to "Unknown" when not available.
`creditRatingDescription`	Description (e.g. Very Low Risk)	Human-readable description of the credit rating. Defaults to "Unknown" when not available.
`industryDesc`	Industry description	A specific description of the business's main activity (e.g. "Wholesale of footwear").
`activityDesc`	Activity description	A broader category describing the business's principal activity (e.g. "WHOLESALE AND RETAIL TRADE"). Genuinely distinct from `industryDesc` for Austria.
`turnover`	`{currency, value}` object	The business's latest reported turnover figure. May not be present.
`employeeCount`	Number (as string)	Latest reported number of employees. May not be present, or may be `"0"` for pure holding entities.
`shareholders`	Array of `{name, percentSharesHeld}`	Shareholder information. May be an individual person or a corporate entity.
`directors`	Array of `{name, positionName}`	Directors associated with the business, if available. May not be present.
`ultimateParent`	`{name, country}`	The business's ultimate parent company, if the business is a subsidiary. May not be present.
`immediateParent`	`{name, country}`	The business's immediate parent company, if the business is a subsidiary. May not be present.
`leiNumber`	LEI	Legal Entity Identifier, if available. May not be present for smaller companies.
`otherNames`	Array of `{name, businessNameType}`	Former legal names of the business, with `businessNameType` set to `"Previous Name"`.
`websites`	Array of strings	Websites associated with the business, if available.

Error responses

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

taxId is not a valid FN number (FN + digits + check letter) or VAT number (AT + U + 8 digits):

{
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid Austrian FN number or VAT number",
    "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.