India

eKYB Prefill in India leverages India's source of truth to automatically retrieve and populate business information based on a company's tax identifier (CIN or GSTIN), including the business name, entity type, registration status, registration date, credit rating, PAN details, and GST registrations, 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

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

Routing logic: if taxId is exactly 21 characters, it is treated as a CIN. Otherwise, if it matches the 15-character GSTIN format, it is treated as a GSTIN. Any other length or format returns a 400 error.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "IN_KYB_PREFILL",
    "country": "IN",
    "taxId": "U12345MH2020PTC123456",
    "businessName": "",
    "address": "123 Sample Road, Mumbai, MH 123 456"
}

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 entity type — see the notes under each example below.

Example 1 — public company (CIN-based)

{
    "kyb-prefill": [
        {
            "tin": "U12345MH2020PTC123456",
            "vatNo": "14AAAAA0000A1Z1",
            "allGSTINs": [
                { "gstin": "14AAAAA0000A1Z1", "status": "Active" },
                { "gstin": "32AAAAA0000A1Z2", "status": "Active" },
                { "gstin": "02AAAAA0000A1Z3", "status": "Cancelled" }
            ],
            "panNumber": "AAAAA0000A",
            "panName": "SAMPLE INDUSTRIES LIMITED",
            "leiNumber": "5493000000000000AB12",
            "name": "SAMPLE INDUSTRIES LIMITED",
            "nameMatch": "Verified",
            "address": "1ST FLOOR SAMPLE TOWER 100 EXAMPLE ROAD NA MUMBAI Maharashtra India 400001",
            "entityType": "Public",
            "registrationStatus": "Active",
            "registrationDate": "1990-01-15T00:00:00Z",
            "creditRating": "C",
            "creditRatingDescription": "Moderate Risk",
            "industryDesc": "Manufacture of fuels, oils, and related chemical products.",
            "activityDesc": "The company is engaged in the business of manufacturing, refining, and distribution of industrial products.",
            "turnover": { "currency": "INR", "value": 5000000000000 },
            "websites": ["www.sampleindustries.example"],
            "shareholders": [
                { "name": "Public", "percentSharesHeld": 49.52 },
                { "name": "Example Commercials LLP", "percentSharesHeld": 11.12 }
            ],
            "directors": [
                { "name": "ANANYA SAMPLE RAO", "positionName": "Whole-time director" },
                { "name": "ROHAN SAMPLE MEHTA", "positionName": "Director" }
            ]
        }
    ]
}

(ultimateParent/immediateParent omitted — this entity sits at the top of its own group.)

Example 2 — sole proprietorship (GSTIN/PAN-based, no CIN)

{
    "kyb-prefill": [
        {
            "vatNo": "27BBBBB1111B1Z1",
            "allGSTINs": [
                { "gstin": "27BBBBB1111B1Z1", "status": "Active" }
            ],
            "panNumber": "BBBBB1111B",
            "panName": "SAMPLE PROPRIETOR NAME",
            "name": "Sample Engineering Works",
            "nameMatch": "Verified",
            "address": "Plot 12, Sample Industrial Estate, Sample Road, Pune - 411000, Maharashtra, India",
            "entityType": "Proprietorship",
            "registrationStatus": "Active",
            "creditRating": "C",
            "creditRatingDescription": "Moderate Risk",
            "industryDesc": "Manufacture of fabricated metal products.",
            "activityDesc": "The entity is engaged in the business of manufacturing metal components and providing related services.",
            "otherAddresses": [
                { "type": "PAN Address", "otherAddress": "Flat 5, Sample Apartments, Sample Nagar, Pune - 411001, Maharashtra, INDIA" }
            ]
        }
    ]
}

Response fields

Error responses

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

taxId is not a valid 21-character CIN or a valid 15-character GSTIN:

{
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid CIN (21 characters) or GSTIN (15 characters)",
    "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"
}

Single Session Dashboard results

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