BID API - Specification Addendum v1.0

Extended Identity Checks: ID-008 through ID-016

Five new endpoints extending Category 1 of the JIL Verdict Engine with deceased, eligibility, license, employment, and citizenship verification. Closes the $380B+ annual loss gap in federal improper payments, healthcare billing fraud, and ghost-provider schemes. Every check is date-anchored, cryptographically sealed, and independently reproducible.

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.

Check ID assignment. New checks extend Category 1: Identity and Counterparty Integrity (existing ID-001 through ID-007). Nine new logic units are introduced, ID-008 through ID-016.

2. Check ID Matrix

Check IDEndpointLogic UnitFWEA PillarVerdict Impact
ID-008check/deceasedSSA Death Master File cross-referenceFraudBLOCK - hard stop
ID-009check/deceasedState vital records cross-referenceFraudREVIEW
ID-010check/eligibilityProgram enrollment status (SSA, CMS)Fraud, WasteBLOCK - hard stop
ID-011check/eligibilityDHS SAVE residency and entitlement eligibilityFraudREVIEW
ID-012check/licenseProfessional license active statusFraud, AbuseBLOCK - hard stop
ID-013check/licenseOIG exclusion list cross-referenceFraud, AbuseBLOCK - hard stop
ID-014check/employmentE-Verify work authorization statusFraudREVIEW
ID-015check/employmentIRS TIN match (payroll)Fraud, AbuseREVIEW
ID-016check/citizenshipDHS SAVE citizenship and immigration statusFraud, AbuseREVIEW

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

Request fields

FieldTypeRequiredNotes
full_namestringYESFull legal name as on payment instruction
date_of_birthISO dateRecommendedReduces DMF false-positive rate from ~8% to under 0.5%
ssn_last4stringOptionalLast 4 digits only. Never transmit full SSN.
date_of_death_estISO dateOptionalSuspected death date for targeted lookup
statestringOptionalUS state code - routes to state vital records
countrystringYESISO 3166-1 alpha-2. Non-US routes to LexisNexis.
npistringOptional10-digit NPI for healthcare provider deceased check
provider_typestringOptional"individual" or "organization"
bid_record_idstringOptionalLinks 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

DMF false-positive guidance. The SSA DMF has a documented false-positive rate of approximately 0.3% for living persons. Always provide 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

TierPrice
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_typeProgramPrimary Source
medicareMedicare Part A/B/C/DCMS PECOS, MBI registry
medicaidState MedicaidState MMIS, CMS
social_securitySSA retirement, disability, survivorSSA NUMIDENT
ssdiSocial Security Disability InsuranceSSA NUMIDENT
ssiSupplemental Security IncomeSSA NUMIDENT
va_benefitsVeterans Affairs benefitsVA eBenefits / VBA
federal_vendorFederal contractor and vendor paymentSAM.gov
snapSupplemental Nutrition AssistanceState SNAP systems
tanfTemporary Assistance for Needy FamiliesState TANF systems
unemploymentUnemployment insuranceState UI systems

Hard BLOCK conditions

REVIEW conditions

Pricing

TierPrice
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

Supported license types

license_typeProfessionPrimary Sources
medicalPhysicians, surgeons, specialistsCMS NPPES, state medical board, OIG LEIE
nursingRN, LPN, NP, CRNAState nursing boards, NURSYS
pharmacyPharmacists, techniciansState pharmacy boards, DEA, NABP
dentalDentists, oral surgeonsState dental boards, NPPES
mental_healthPsychologists, therapists, social workersState licensing boards, NPPES
legalAttorneysState bar associations
financial_advisorRegistered investment advisorsSEC IARD, FINRA BrokerCheck
broker_dealerRegistered representativesFINRA BrokerCheck, SEC EDGAR
insuranceInsurance agents and brokersState insurance departments, NIPR
contractorLicensed contractors, engineersState contractor boards
dea_registrantDEA controlled substance authorizationDEA Diversion Control Division

Hard BLOCK conditions

Pricing

TierPrice
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.

Important. 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

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

TierPrice
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

Supported check types

citizenship_check_typeVerifiesSources
us_citizenUS citizenship by birth or naturalizationSSA NUMIDENT, State Dept, state vital records
lawful_permanent_residentLPR / Green Card status and expirationDHS SAVE, USCIS I-551
visa_holderActive non-immigrant visa statusDHS SAVE, USCIS, CBP
dacaDACA work authorization and renewalDHS SAVE, USCIS
refugee_asyleeRefugee or asylee grant statusDHS SAVE, USCIS I-94
residency_onlyCurrent US residency (no citizenship determination)State DMV, USPS NCOA
program_eligibilityCitizenship meets requirements for specified programDHS SAVE + program-specific rules
Voter integrity use case. Combine 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

TierPrice
Starter$0.60 per check
Pro$0.30 per check
Enterprise$0.20 per check

8. Composite Bundle Pricing

BundleStarterPilotProEnterprise
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

(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.