KYB Prefill

KYB Prefill streamlines the business verification experience by automatically populating company details using trusted, authoritative data sources. Available across Trulioo’s supported countries, Prefill reduces manual data entry, improves data accuracy, and helps you onboard businesses faster and with greater confidence.

Prefill is designed to work seamlessly with Trulioo Business Verification. It accelerates the initial data collection step and guides users toward the correct legal entity before verification is performed.

How KYB Prefiil Works

Step 1: Initiate a search

Start by submitting a partial business name along with the country where the business is registered. To improve precision— especially for common business names — you may also include optional attributes such as state or city. You can control how many suggestions are returned by using the Limit parameter. This allows you to tailor the response to your UI needs (for example, limiting results in a dropdown or autocomplete experience). Typical inputs include:

• Country
• Partial business name
• Optional: state, city
• Result limit

This step is optimized for real-time user input and works well for search-as-you-type or autocomplete flows.

Sample Request:

POST https://api.trulioo.com/v3/business/autocomplete
Authorization: Bearer Token
Content-Type: application/json
Request Body:  
{
    "PackageId": "<packageId>",
    "CountryCode":"US",
    "CompanyName":"Microso",
    "State":"WA",
    "City":"Redmond",
    "Limit": 2
}

Step 2: Review Smart Suggestions

Trulioo returns a ranked list of matching businesses based on relevance and confidence. Each result includes key attributes to help you quickly identify the correct entity, such as:

• Registered legal business name
• Business address
• Unique Trulioo identifier (Trulioo ID)

Results are ordered by confidence, with the most likely match appearing first. When multiple businesses share the same name, location inputs (if provided) are used to improve ranking and relevance.

A duplicate count is also included to indicate how many other businesses exist with the same or similar name. This helps provide context and signals when additional user confirmation may be needed.

Sample Response

{
    "results": [
        {
            "TruliooID": "us11111111-1111-1111-1111-111111111111",
            "CompanyName": "MICROSOFT",
            "BusinessRegistrationNumber": "0000000",
            "Address": "15120 NE 40TH ST BLDG 22, REDMOND, WA, 98052",
            "Address1": "15120 NE 40TH ST BLDG 22",
            "Region": "WA",
            "City": "REDMOND",
            "PostalCode": "98052",
            "PrefillId": "00000000-0000-0000-0000-000000000000-1",
            "NumberOfDuplicates": 57,
            "Ranking": 57.72414,
            "BusinessIdentifiers": [
                {
                    "Number": "0000000",
                    "Type": "Business Registration Number"
                },
                {
                    "Number": "123456789",
                    "Type": "Tax Id Number"
                }
            ]
        },
        {
            "TruliooID": "us22222222-2222-2222-2222-222222222222",
            "CompanyName": "MICROSOFT CAFE #16",
            "BusinessRegistrationNumber": "11111",
            "Address": "3600 157TH AVE NE, REDMOND, WA, 98052",
            "Address1": "3600 157TH AVE NE",
            "Region": "WA",
            "City": "REDMOND",
            "PostalCode": "98052",
            "PrefillId": "00000000-0000-0000-0000-000000000000-2",
            "NumberOfDuplicates": 0,
            "Ranking": 29.855078,
            "BusinessIdentifiers": [
                {
                    "Number": "11111",
                    "Type": "Business Registration Number"
                },
                {
                    "Number": "2222222",
                    "Type": "Tax Id Number"
                }
            ]
        }
    ]
}

Step 3: Continue with KYB Verification

Once a business is selected, you can pass the prefilled values directly into the KYB Verification request. Alternatively, you may allow end users to review or edit the prefilled fields before submission.

Running KYB Verification returns a comprehensive, compliance-ready profile of the business, including registry data, ownership information, and verification signals.

Prefill does not replace verification; it improves accuracy and efficiency by ensuring the verification starts with the right entity.

For details on running KYB Verification, see the related API guide - Business Verification --> Step 6: Verify