1. Overview
This addendum extends BID API Specification v1.0 with five new identity verification endpoints. The existing BID check/person endpoint verified sanctions, PEP status, adverse media, and name-to-account match. It did not verify whether the person was alive, whether they were eligible for the program paying them, whether their professional license was active, whether they were authorized to work, or whether they held the citizenship status required for the payment type.
The single most important vulnerability: a deceased person with a valid IBAN, a clean OFAC record, and no adverse media scored 80 out of 100 under the existing trust score model. That is the "safe to release funds" threshold. A provider whose license was revoked six months ago scored identically. Both gaps are now closed.
2. Check ID Matrix
| Check ID | Endpoint | Logic Unit | FWEA Pillar | Verdict Impact |
|---|---|---|---|---|
| ID-008 | check/deceased | SSA Death Master File cross-reference | Fraud | BLOCK - hard stop |
| ID-009 | check/deceased | State vital records cross-reference | Fraud | REVIEW |
| ID-010 | check/eligibility | Program enrollment status (SSA, CMS) | Fraud, Waste | BLOCK - hard stop |
| ID-011 | check/eligibility | DHS SAVE residency and entitlement eligibility | Fraud | REVIEW |
| ID-012 | check/license | Professional license active status | Fraud, Abuse | BLOCK - hard stop |
| ID-013 | check/license | OIG exclusion list cross-reference | Fraud, Abuse | BLOCK - hard stop |
| ID-014 | check/employment | E-Verify work authorization status | Fraud | REVIEW |
| ID-015 | check/employment | IRS TIN match (payroll) | Fraud, Abuse | REVIEW |
| ID-016 | check/citizenship | DHS SAVE citizenship and immigration status | Fraud, Abuse | REVIEW |
3. POST /v1/bid/check/deceased
Check IDs: ID-008, ID-009. Annual fraud addressed: $1.8B+ (SSA) + $2B+ (Medicare/Medicaid ghost providers).
Purpose. Cross-reference a person against the SSA Death Master File, state vital records (50 states + DC via CDC/NCHS National Death Index), CMS provider deactivation registry, and LexisNexis deceased alerts. Returns a deceased_flag that overrides trust score when triggered.
Data sources
- SSA Death Master File (DMF) - SSA Information Verification Services DUA, annual certification
- CDC/NCHS National Death Index - NCHS research agreement
- State vital records (50 states + DC) - state-by-state DUA; NDI as primary aggregator
- CMS Provider Deactivation Registry - CMS BPS data sharing agreement
- LexisNexis Deceased Alerts - commercial API (fallback for international and non-NDI states)
Request fields
| Field | Type | Required | Notes |
|---|---|---|---|
full_name | string | YES | Full legal name as on payment instruction |
date_of_birth | ISO date | Recommended | Reduces DMF false-positive rate from ~8% to under 0.5% |
ssn_last4 | string | Optional | Last 4 digits only. Never transmit full SSN. |
date_of_death_est | ISO date | Optional | Suspected death date for targeted lookup |
state | string | Optional | US state code - routes to state vital records |
country | string | YES | ISO 3166-1 alpha-2. Non-US routes to LexisNexis. |
npi | string | Optional | 10-digit NPI for healthcare provider deceased check |
provider_type | string | Optional | "individual" or "organization" |
bid_record_id | string | Optional | Links to existing BID binding for audit trail |
Response
{
"deceased_flag": false,
"deceased_confidence": "none",
"dmf_match": false,
"state_records_match": false,
"cms_deactivated": false,
"date_of_death": null,
"trust_score_delta": 0,
"verdict_override": null
}
Verdict logic
deceased_confidence = "confirmed"ORdmf_match = trueORcms_deactivated = true- trust score set to 0, verdict overridden to BLOCK.deceased_confidence = "probable"- trust score -40, routed to REVIEW.deceased_confidence = "possible"- trust score -15, flagged for monitoring.
date_of_birth and ssn_last4 when available - this reduces false positives to under 0.02%. When deceased_confidence = "probable" without DOB confirmation, route to REVIEW rather than BLOCK.
Pricing
| Tier | Price |
|---|---|
| Starter | $0.45 per check |
| Pilot | $0.32 per check |
| Pro | $0.22 per check |
| Enterprise | $0.14 per check |
4. POST /v1/bid/check/eligibility
Check IDs: ID-010, ID-011. Annual fraud addressed: $175B+ (federal improper payments).
Purpose. Verify that a person or entity is currently enrolled in and eligible for the specific program associated with the payment. Cross-references SSA NUMIDENT, CMS PECOS, DHS SAVE, OIG LEIE, SAM.gov, and state MMIS systems.
Supported program types
program_type | Program | Primary Source |
|---|---|---|
| medicare | Medicare Part A/B/C/D | CMS PECOS, MBI registry |
| medicaid | State Medicaid | State MMIS, CMS |
| social_security | SSA retirement, disability, survivor | SSA NUMIDENT |
| ssdi | Social Security Disability Insurance | SSA NUMIDENT |
| ssi | Supplemental Security Income | SSA NUMIDENT |
| va_benefits | Veterans Affairs benefits | VA eBenefits / VBA |
| federal_vendor | Federal contractor and vendor payment | SAM.gov |
| snap | Supplemental Nutrition Assistance | State SNAP systems |
| tanf | Temporary Assistance for Needy Families | State TANF systems |
| unemployment | Unemployment insurance | State UI systems |
Hard BLOCK conditions
oig_excluded = trueenrollment_status = "terminated"or"suspended"sam_debarred = true
REVIEW conditions
payment_exceeds_limiteligibility_expiring_soon(within 30 days)dhs_save_mismatchprogram_id_not_foundwork_activity_detected(for SSDI)
Pricing
| Tier | Price |
|---|---|
| Starter | $0.65 per check |
| Pro | $0.34 per check |
| Enterprise | $0.22 per check |
5. POST /v1/bid/check/license
Check IDs: ID-012, ID-013. Annual fraud addressed: $60B+ (healthcare billing fraud).
Purpose. Verify that a professional, provider, or institutional license is currently active and in good standing at the time of payment. Cross-references NPI registry, state licensing boards, OIG exclusion list, and DEA controlled substance schedules.
Data sources
- CMS NPPES (NPI Registry) - public API
- OIG LEIE - public API
- DEA Practitioner Registration - DEA Diversion Control Division API
- State medical licensing boards (50 states) - direct state APIs + Docktor aggregator
- NURSYS - national nursing licensure database
- State bar associations
- FINRA BrokerCheck - public API
- SEC EDGAR / IARD - public access
Supported license types
license_type | Profession | Primary Sources |
|---|---|---|
| medical | Physicians, surgeons, specialists | CMS NPPES, state medical board, OIG LEIE |
| nursing | RN, LPN, NP, CRNA | State nursing boards, NURSYS |
| pharmacy | Pharmacists, technicians | State pharmacy boards, DEA, NABP |
| dental | Dentists, oral surgeons | State dental boards, NPPES |
| mental_health | Psychologists, therapists, social workers | State licensing boards, NPPES |
| legal | Attorneys | State bar associations |
| financial_advisor | Registered investment advisors | SEC IARD, FINRA BrokerCheck |
| broker_dealer | Registered representatives | FINRA BrokerCheck, SEC EDGAR |
| insurance | Insurance agents and brokers | State insurance departments, NIPR |
| contractor | Licensed contractors, engineers | State contractor boards |
| dea_registrant | DEA controlled substance authorization | DEA Diversion Control Division |
Hard BLOCK conditions
license_status = "revoked"or"suspended"oig_excluded = truenpi_active = false(healthcare providers)
Pricing
| Tier | Price |
|---|---|
| Starter | $0.55 per check |
| Pro | $0.28 per check |
| Enterprise | $0.18 per check |
6. POST /v1/bid/check/employment
Check IDs: ID-014, ID-015. Annual fraud addressed: $50B+ (payroll fraud).
Purpose. Verify work authorization status and payroll identity integrity. Detects ghost employees, unauthorized workers, and payroll identity fraud. Cross-references E-Verify, IRS TIN Match, and SSA wage records.
check_work_auth = true must be explicitly set to trigger E-Verify. E-Verify is not a general-purpose lookup - employer enrollment is required and JIL enrolls as an E-Verify Employer Agent (EEA) with an employer MOU per client.
Data sources
- E-Verify (DHS/USCIS) - JIL enrolls as EEA; employer MOU required per client
- IRS TIN Matching Program - IRS e-Services enrollment; payer status required
- SSA Wage Record Query (WRIS) - SSA agency agreement
- DHS SAVE - benefit-issuing entity enrollment
- Equifax The Work Number - commercial API with permissible purpose
Response
{
"work_authorized": true,
"work_auth_status": "authorized",
"work_auth_expiration": null,
"authorization_basis": "usc",
"tin_match": true,
"tin_match_status": "match",
"employment_confirmed": true,
"wage_range_flag": false
}
Pricing
| Tier | Price |
|---|---|
| Starter | $0.50 per check |
| Pro | $0.25 per check |
| Enterprise | $0.16 per check |
7. POST /v1/bid/check/citizenship
Check IDs: ID-016. Annual fraud addressed: $10B+ (improper entitlement payments).
Purpose. Verify citizenship status, immigration status, and residency eligibility as required for program participation or payment authorization. Also serves as the foundation for voter registration integrity checks.
Data sources
- DHS SAVE (Systematic Alien Verification for Entitlements)
- USCIS immigration records
- SSA Citizenship Records (NUMIDENT)
- State vital records (birthplace and naturalization)
- State DMV records (residency confirmation)
Supported check types
citizenship_check_type | Verifies | Sources |
|---|---|---|
| us_citizen | US citizenship by birth or naturalization | SSA NUMIDENT, State Dept, state vital records |
| lawful_permanent_resident | LPR / Green Card status and expiration | DHS SAVE, USCIS I-551 |
| visa_holder | Active non-immigrant visa status | DHS SAVE, USCIS, CBP |
| daca | DACA work authorization and renewal | DHS SAVE, USCIS |
| refugee_asylee | Refugee or asylee grant status | DHS SAVE, USCIS I-94 |
| residency_only | Current US residency (no citizenship determination) | State DMV, USPS NCOA |
| program_eligibility | Citizenship meets requirements for specified program | DHS SAVE + program-specific rules |
check/citizenship (type us_citizen) with check/deceased and check/address for a three-check voter roll verification pipeline. Result is a cryptographically attested eligibility verdict with immutable audit trail per record.
Pricing
| Tier | Price |
|---|---|
| Starter | $0.60 per check |
| Pro | $0.30 per check |
| Enterprise | $0.20 per check |
8. Composite Bundle Pricing
| Bundle | Starter | Pilot | Pro | Enterprise |
|---|---|---|---|---|
| All 5 extended checks | $2.25 | $1.65 | $1.15 | $0.75 |
10% bundle discount applied. Recommended for government payment corridors and healthcare rails.
Appendix A - Investigation Engine Input Schema
When running a retroactive identity integrity investigation, submit a structured payment record dataset. See the full schema at JIL Investigation Engine Input Schema for required and optional fields, including payment record, person identity, entity identity, professional credentials, address, bank account, marital status, and investigation configuration sections.
Related specifications
- BID API Specification v1.0 - core endpoints
- Ignore Flag API - operator override with immutable audit trail
- Retroactive Identity Integrity Audit - full forensic product spec
- FWEA Framework - the 9-category, 69-check Verdict Engine
(c) 2026 JIL Sovereign Technologies, Inc. All rights reserved. Patent Pending. Data handling subject to applicable privacy laws including HIPAA, the Privacy Act of 1974, the Computer Fraud and Abuse Act, and applicable state statutes. Government database access requires applicable data use agreements, enrollment, and legal review prior to production deployment.