FSSAI FoSCoS Licence Verification

Verify one to 20 exact, 14-digit FSSAI licence numbers through the official FoSCoS public lookup. Each successful dataset row contains the matching licence holder, public status/address fields, and any business/product details returned by the public detail endpoint.

What this Actor guarantees

• Uses the official FoSCoS public lookup and verifies that each returned licence number exactly matches the request.
• Requires the returned licence number to exactly match the requested number.
• Emits one canonical field per fact; missing optional facts remain absent and legitimate empty detail lists remain empty.
• Preserves verified rows if another lookup fails. A partial multi-licence run remains failed and reports partialSuccess: true.
• Provides a run summary with the overall result and lookup counts.

The current parser does not extract validity dates through this lookup route, so the Actor does not invent them. Public product-detail enrichment is optional: a verified licence remains valid output when that secondary endpoint is unavailable.

Source availability

FoSCoS availability can vary. If the public lookup does not return an exact, verifiable match, the Actor reports an unsuccessful run and does not create a placeholder licence record.

Input

{
    "fssaiNos": ["12421012003663"],
    "maxRequestRetries": 1,
    "requestTimeoutSecs": 90
}

Output

The default dataset contains verified fssai_licence rows. Optional fields appear only when FoSCoS supplies a real value. Arrays such as businessGroups, kindsOfBusiness, and foodProducts are source-backed and may correctly be empty.

The following is a synthetic shape example, not a live result:

{
    "recordType": "fssai_licence",
    "fssaiNumber": "12345678901234",
    "companyName": "Synthetic business",
    "licenseCategoryName": "State Licence",
    "licenseStatus": "Active",
    "stateName": "Tamil Nadu",
    "enrichmentAvailable": false,
    "searchEndpoint": "https://foscos.fssai.gov.in/webgateway/commonauth_readonly/commonapi/getsearchapplicationdetails/1",
    "scrapedAt": "2026-10-02T00:00:00.000Z",
    "sourcePageUrl": "https://foscos.fssai.gov.in/"
}

Verified counts describe lookups; a later storage failure still makes the run fail and does not prove dataset persistence. The OUTPUT summary reports the overall run result and requested, verified, and failed lookup counts.