--- title: "Austria" url: "https://developer.incode.com/general-reference/austria/" section: "general-reference" group: "eKYB Reference / eKYB Prefill Coverage" version: "v1.1" status: "live" --- # 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](/general-reference/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](#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 ```json { "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)** ```json { "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** ```json { "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)** ```json { "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): ```json { "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: ```json { "status": 400, "error": "Bad Request", "message": "must not be blank", "path": "/omni/externalVerification/ekyb-prefill" } ``` No business match is found for the submitted `taxId`: ```json { "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](/dashboard-platform-administration/single-session-view/).