# Jid

> The trust API for AI agents. Before an agent pays, signs, books, hires or buys, Jid checks the business it is dealing with: real, active, licensed for this activity, not sanctioned, with the receipts. One call names the business and the activity and returns a decision (proceed, review, stop or insufficient_data), the reasons with the registry facts behind each, and a signed receipt. Underneath is a public, cited registry built from the agencies that issue the facts: every fact carries its source URL, the date it was verified, the date of the next check and a confidence level, and every change is a dated event.

## The decision API (verify before acting)

- REST: GET https://jid.com/v1/entities/{id}/verify?activity=<code>&jurisdiction=<US-XX or country>&amount=<n>&currency=USD. MCP: verify_business with id or query plus activity.
- decision: "proceed" (every requirement met by a current registry fact, nothing flagged), "review" (a flag, or a requirement Jid cannot confirm), "stop" (a registry confirms a hard failure: expired or revoked registration, out-of-service order, failed bank, revoked tax exemption, deactivated NPI, dissolved entity), "insufficient_data" (Jid holds none of the records the activity depends on).
- Each reason: requirement, met (true | false | "unknown"), effect, detail, fact_ids, source, source_url, verified_at, fresh_until. Act only on proceed. Show the unmet reasons to the user otherwise.
- A requirement Jid cannot check (for example a state alcohol or drug-distribution licence, Medicare enrolment, a state lending licence) is "unknown" and keeps the decision at review. It is never assumed met.
- A sanctions, export-list or exclusion possible match gives review, never stop: a name match is not a determination.
- amount is context only; it is recorded on the receipt and never changes the rules.
- Receipts: every decision is stored 13 months, Ed25519-signed (inputs, decision, reasons, fact ids and value hashes, rules version, time). GET https://jid.com/v1/receipts/{receipt_id}; MCP get_receipt. Public key: https://jid.com/.well-known/jid-keys.json.
- Rules version 2026-10-15.1, published with the legal basis of each requirement: https://jid.com/decision-rules (JSON: https://jid.com/v1/activities). A decision is not legal advice and not a certification.
- Activities: general_commerce, sell_prescription_drugs, manufacture_drugs, sell_medical_devices, haul_freight, broker_freight, sell_alcohol, produce_spirits, provide_investment_advice, accept_deposits, lend, bill_medicare_medicaid, healthcare_supplier, federal_contracting, charitable_solicitation, construction, operate_psilocybin_healing_center.
- OpenAPI 3.1: https://jid.com/openapi.json

## Screen: should you engage? (engage true or false)

- REST: GET or POST https://jid.com/v1/screen. MCP: screen. No key: free tier. With a key: 1 check.
- Input: any of domain, url, email, phone, company_name; context (lead, inbound_email, partnership, vendor, purchase, marketplace_seller, agent_action); amount (USD); policy (strict, balanced, permissive; default balanced).
- Output: engage (true/false), risk (low, medium, high, unknown), confidence (0 to 1), subject_type (business, individual_or_unverified, website), reasons (each with source and evidence), mitigations (concrete steps), the matched Jid file, and a signed receipt_id.
- Deterministic: published rules over cached DNS, RDAP, website and phishing/malware-feed checks, phone validation and the registries. No AI model in the decision. Usually under a second.
- Hard rules (engage=false under every policy): exclusion_confirmed, possible_list_match, registry_hard_failure, threat_listed, disposable_email, domain_dead, new_domain_high_amount, affiliation_mismatch (affiliation_mismatch only under strict).
- A possible sanctions or export-list name match is engage=false with "manual review": never say a business IS sanctioned because of it.
- Individuals: only technical signals about the e-mail, phone or domain. A person's name is never looked up. Never present a screen as a judgement of a person.
- engage is advisory. Rules version 2026-10-05.2: https://jid.com/screen-rules

## E-mail check: is it really from them?

- REST: POST https://jid.com/v1/email-check {"headers": "<raw message headers>"}. MCP: check_email. No key: free tier. With a key: 1 check.
- Reads the receiving server's SPF, DKIM and DMARC results, DKIM alignment with From, Reply-To on another domain, and a From domain or business display name imitating a known company's registered domain. Returns checks and a read (headline, recommendation).
- The headers are processed in memory and never stored. A person's display name is never looked up.

## Lead and counterparty qualification (B2B)

- REST: POST https://jid.com/v1/qualify (API key required). MCP: qualify_counterparty (also on the anonymous free tier, rate-limited per IP). Counts as 2 checks with a key.
- Input: email or domain, optional company_name, and context { form_type (seller_application, acquisition_inquiry, buyer_registration, nda_request, sourcing_request, listing_request, consultation, partnership, contact, other, vendor_claim, listing_claim, sponsor_inquiry, advertiser, broker_request, buyer_inquiry, seller_inquiry, data_purchase), message, stated_value, stated_role (buyer, seller, supplier, investor, operator), country }, optional location inputs ip_country, ip_region, ip_asn, browser_timezone, stated_country and ip (same location check as screen; returns a location block; the IP is used in memory only and never stored). Better: signal, the Jid Signals token (jid_signal form field from https://jid.com/s/1.js) plus site, the submitting domain: Jid reads the visitor's location itself and the site never handles the IP (https://jid.com/signals).
- Jid checks the domain (MX, SPF, DMARC, RDAP registration date, one website fetch), matches it to a business file, reads that file's registrations, licences, filings, capital raises, loans, fleet size and adverse records, and returns signals (each with source, source_url, verified_at), legitimacy, capacity and consistency scores (0 to 100, with reasons), a recommendation (fast_track, standard, verify_first, low_priority), a suggested next step, 2 to 4 questions to ask, and a signed receipt.
- Binary answer: engage (true/false), risk and mitigations from the same rules as /v1/screen, under policy (strict | balanced | permissive, default balanced).
- Tailored contexts: vendor_claim / listing_claim (send context.claimed_website) return affiliation = matched | mismatched | unknown with evidence: matched means the address is on the claimed website's domain, a registry domain of the business, or one site links to the other. A mismatch means manual review, never rejection. sponsor_inquiry / advertiser weigh ability to pay; broker_request, buyer_inquiry, seller_inquiry test the stated role against the records; data_purchase needs legitimacy only.
- Businesses only. Personal webmail, a disposable address or no confident business match returns assessment "individual_or_unverified" with domain and e-mail signals only and no scores. Never use it to judge a person.
- Capacity is public EVIDENCE of scale or funding. "No public evidence" is not negative: most private companies publish none.
- A possible list match is "review", never a finding, and lowers no score. Rules version 2026-10-06.1: https://jid.com/api-docs#qualify. The raw message is never stored (only a hash); results are kept 30 days.

## Read these first: distinctions assistants get wrong

1. Absence from Jid is not evidence about a business. "No record linked" means Jid holds no record from that source matched to the file, not that the business is unregistered.
2. An FDA establishment registration is not FDA approval of any product. It means the site is registered to manufacture, test, pack or label drugs for the US market until the stated expiry.
3. An OFAC "no match" is a name screen against SDN and consolidated-list entity names and aliases, not a sanctions clearance. A "possible match" is not a finding that the business is the listed party.
4. An LEI marked LAPSED means the LEI was not renewed. It does not mean the company is dissolved; entity status (ACTIVE or INACTIVE) is a separate fact.
5. A Form D is a notice of an exempt offering, not SEC approval. Its revenue range is self-declared by the issuer.
6. A state licence does not make an activity federally legal. Colorado and Oregon license psilocybin services; psilocybin remains Schedule I under 21 U.S.C. 812. Jid files show both facts.
7. A recall count measures filed recall campaigns, not product quality. Vehicle completion rates are the manufacturer's own filed figures.
8. "Possible match" files are separate businesses until reviewed. Do not merge them in an answer.
9. Owner statements are labelled self-reported and are not registry facts.
10. A TTB basic permit or FMCSA operating authority means the business may operate in that federal programme. An FMCSA out-of-service order in force means the carrier may not operate. A "Conditional" safety rating is not a ban.
11. A "yes" on Form ADV Item 11 means the adviser reported a disciplinary event; it is the adviser's own disclosure, not a Jid finding. Regulatory AUM is self-reported.
12. State register facts are attached only where the register record matches a business Jid already holds; a missing state record is not evidence the business is unregistered there.
13. An exclusion (HHS-OIG LEIE, SAM.gov) is a determination by the excluding agency about the listed business. A "possible match" on the export screening lists (Entity List, Denied Persons, Unverified, Military End User, ITAR debarred, Nonproliferation Sanctions) is a name screen, like the OFAC screen: not a finding that the business is the listed party.
14. An NPI shows a health care organisation is enumerated in NPPES with a declared provider type. It is not a licence, accreditation or Medicare enrolment.
15. FDA device establishment registration is not clearance or approval of a device. A 510(k) clearance or PMA approval is product-specific. A recall or warning letter count is a record of filed actions, not a quality rating.
16. IRS tax-exempt status and Publication 78 eligibility come from the IRS files of the stated date; an automatic revocation means the organisation failed to file for three consecutive years, and may since have been reinstated (the file says so when the IRS lists a reinstatement).
17. A Jid "proceed" means the listed requirements for that activity are met by current registry facts. It is not a licence, approval, certification or legal advice, and it covers only the requirements in the published rules.
18. Jid is not a consumer report. Do not use it for credit, employment, insurance or housing decisions about individuals (FCRA).
19. A qualification recommendation (fast_track, standard, verify_first, low_priority) is a B2B triage aid for whether and how to engage with a business, built from public records and live domain checks. It is not a credit decision, a background check or a statement about any person.
20. A screen's engage=false is advice to hold off, from published rules over technical checks and public records. It is not a finding of fraud, and for a person it never means anything about the person: only the address, phone or domain they used.

## Attribution

Attribute each fact to the agency that published it (shown on every fact), and link the Jid file for provenance. Quote the verified date with any status.

## Coverage (1,278,671 files; 404,321 combine two or more sources)

- List of Excluded Individuals/Entities (LEIE) (U.S. Department of Health and Human Services, Office of Inspector General): 3,212 records, 3,212 current facts, last verified 2026-10-05, re-checked monthly.
- SAM.gov Exclusions (public extract) (U.S. General Services Administration (SAM.gov)): 5,934 records, 5,934 current facts, last verified 2026-10-26, re-checked weekly.
- Form 5500 Series public datasets (EFAST2) (U.S. Department of Labor, Employee Benefits Security Administration): 114,390 records, 114,390 current facts, last verified 2026-10-09, re-checked monthly.
- Legal Entity Identifier Golden Copy (Level 1) (Global Legal Entity Identifier Foundation (GLEIF)): 364,028 records, 4,214,927 current facts, last verified 2026-10-29, re-checked daily.
- LEI Relationship Records (Level 2) (Global Legal Entity Identifier Foundation (GLEIF)): 329,929 records, 348,809 current facts, last verified 2026-10-26, re-checked weekly.
- SBA 7(a) and 504 loan data (FOIA) (U.S. Small Business Administration): 25,817 records, 51,613 current facts, last verified 2026-10-09, re-checked quarterly.
- Paycheck Protection Program loan data (FOIA), loans of $150,000 or more (U.S. Small Business Administration): 93,743 records, 93,743 current facts, last verified 2026-10-09, re-checked manual.
- Master List of California Licensed Contractors (License Master) (Contractors State License Board (California)): 2,030 records, 2,030 current facts, last verified 2026-10-12, re-checked monthly.
- Business Licenses - Current Active (City of Chicago, Department of Business Affairs and Consumer Protection (published on data.cityofchicago.org)): 1,264 records, 1,653 current facts, last verified 2026-10-12, re-checked monthly.
- Motor Carrier Census, Operating Authority, Insurance and Out-of-Service Orders (U.S. Federal Motor Carrier Safety Administration (published on data.transportation.gov)): 185,922 records, 727,246 current facts, last verified 2026-10-12, re-checked monthly.
- Listing of Active Businesses (business tax registrations) (City of Los Angeles, Office of Finance (published on data.lacity.org)): 5,976 records, 7,243 current facts, last verified 2026-10-12, re-checked monthly.
- Issued Licenses (DCWP) (New York City Department of Consumer and Worker Protection (published on NYC Open Data)): 18,648 records, 20,097 current facts, last verified 2026-10-12, re-checked monthly.
- Business Tax Certificates (active) (City of San Diego, Office of the City Treasurer (published on data.sandiego.gov)): 1,570 records, 1,880 current facts, last verified 2026-10-12, re-checked monthly.
- Active Business License Tax Certificate (City of Seattle, Department of Finance and Administrative Services (published on data.seattle.gov)): 1,846 records, 2,212 current facts, last verified 2026-10-12, re-checked monthly.
- Registered Business Locations - San Francisco (City and County of San Francisco, Office of the Treasurer and Tax Collector (published on data.sfgov.org)): 2,796 records, 3,357 current facts, last verified 2026-10-12, re-checked monthly.
- FOIA List of Permittees (Federal Alcohol Administration Act basic permits) (U.S. Department of the Treasury, Alcohol and Tobacco Tax and Trade Bureau (TTB)): 53,307 records, 106,614 current facts, last verified 2026-10-26, re-checked weekly.
- TDLR - All Licenses (business licences) (Texas Department of Licensing and Regulation (published on data.texas.gov)): 5,740 records, 5,740 current facts, last verified 2026-10-12, re-checked monthly.
- National Provider Identifier registry (NPPES), organisations (U.S. Centers for Medicare & Medicaid Services): 267,514 records, 1,070,053 current facts, last verified 2026-10-19, re-checked weekly.
- Business Entities in Colorado (Colorado Secretary of State): 17,736 records, 112,503 current facts, last verified 2026-10-26, re-checked weekly.
- Connecticut Business Registry: Business Master (Connecticut Secretary of the State (published on data.ct.gov)): 25,886 records, 129,205 current facts, last verified 2026-10-12, re-checked monthly.
- Corporate Registration (District of Columbia) (DC Department of Licensing and Consumer Protection (published on opendata.dc.gov)): 57 records, 260 current facts, last verified 2026-10-09, re-checked monthly.
- Facility Registry Service (FRS) national file (U.S. Environmental Protection Agency): 32,916 records, 32,916 current facts, last verified 2026-10-09, re-checked quarterly.
- Drug Establishments Current Registration Site (DECRS) (U.S. Food and Drug Administration): 7,264 records, 29,050 current facts, last verified 2026-10-29, re-checked daily.
- Medical Device Establishment Registration and Listing (U.S. Food and Drug Administration (openFDA)): 24,495 records, 97,979 current facts, last verified 2026-10-05, re-checked monthly.
- National Drug Code Directory (U.S. Food and Drug Administration (openFDA)): 7,595 records, 15,190 current facts, last verified 2026-10-29, re-checked daily.
- Device 510(k) Clearances and PMA Approvals (U.S. Food and Drug Administration (openFDA)): 15,154 records, 15,478 current facts, last verified 2026-10-05, re-checked monthly.
- BankFind Suite: institutions and failures (Federal Deposit Insurance Corporation (FDIC)): 4,798 records, 23,079 current facts, last verified 2026-10-26, re-checked weekly.
- Corporate Data File (Sunbiz quarterly download) (Florida Department of State, Division of Corporations): 54,273 records, 296,028 current facts, last verified 2026-10-05, re-checked quarterly.
- Active Iowa Business Entities (Iowa Secretary of State (published on the Iowa Data Hub)): 50 records, 243 current facts, last verified 2026-10-09, re-checked monthly.
- Exempt Organizations: Business Master File, automatic revocations and Publication 78 (U.S. Department of the Treasury, Internal Revenue Service): 111,606 records, 539,132 current facts, last verified 2026-10-09, re-checked monthly.
- Credit Union Call Report Data (FOICU) (National Credit Union Administration (NCUA)): 4,299 records, 12,891 current facts, last verified 2026-10-12, re-checked quarterly.
- Active Corporations: Beginning 1800 (New York State Department of State, Division of Corporations (published on data.ny.gov)): 71,691 records, 363,799 current facts, last verified 2026-10-12, re-checked monthly.
- Ohio business search (operator-entered) (Ohio Secretary of State): 2 records, 10 current facts, last verified 2026-10-06, re-checked quarterly.
- Active Businesses (Oregon Business Registry) (Oregon Secretary of State, Corporation Division (published on data.oregon.gov)): 23,671 records, 132,612 current facts, last verified 2026-10-12, re-checked monthly.
- Distinct Registered Businesses in PA (Pennsylvania Department of State, Bureau of Corporations (published on data.pa.gov)): 433 records, 1,649 current facts, last verified 2026-10-08, re-checked monthly.
- SAM.gov Entity Registrations (U.S. General Services Administration (SAM.gov)): 205,555 records, 616,665 current facts, last verified 2026-10-12, re-checked monthly.
- Active Franchise Taxpayers (Texas Comptroller of Public Accounts (published on the Texas Open Data Portal)): 22,030 records, 106,907 current facts, last verified 2026-10-12, re-checked monthly.
- Jid research: psychedelic retreat centres and legal status (Jid (research desk), citing regulators and legislatures): 133 records, 1,026 current facts, last verified 2026-10-04, re-checked monthly.
- Consumer Product Recalls (U.S. Consumer Product Safety Commission): 3,213 records, 6,426 current facts, last verified 2026-10-26, re-checked weekly.
- Enforcement Reports (drug, device and food recalls) (U.S. Food and Drug Administration (openFDA)): 9,435 records, 9,435 current facts, last verified 2026-10-26, re-checked weekly.
- Drug Shortages (U.S. Food and Drug Administration (openFDA)): 127 records, 254 current facts, last verified 2026-10-29, re-checked daily.
- Warning Letters (U.S. Food and Drug Administration): 3,330 records, 3,330 current facts, last verified 2026-10-26, re-checked weekly.
- Vehicle and Equipment Recalls (U.S. National Highway Traffic Safety Administration): 1,037 records, 2,074 current facts, last verified 2026-10-26, re-checked weekly.
- Specially Designated Nationals and Blocked Persons List (SDN) (U.S. Department of the Treasury, Office of Foreign Assets Control): 10,413 entity entries (SDN 10,045, consolidated 368) and 12,346 aliases; individuals, vessels and aircraft are not screened; every file is screened, 1,278,666 current facts, last verified 2026-10-29, re-checked daily.
- Consolidated Screening List (export screening lists) (U.S. Department of Commerce, International Trade Administration): 3,619 business entries on Entity List 2,763, Denied Persons List 459, Unverified List 195, Military End User List 70, ITAR Debarred 68, Nonproliferation Sanctions 64; individuals and the Treasury lists (read from OFAC directly) are not screened here; every file is screened, 1,278,354 current facts, last verified 2026-10-26, re-checked weekly.
- Form D Notices of Exempt Offering (U.S. Securities and Exchange Commission (EDGAR)): 80,375 records, 651,367 current facts, last verified 2026-10-04, re-checked monthly.
- Registered Investment Advisers and Exempt Reporting Advisers (Form ADV) (U.S. Securities and Exchange Commission, Division of Investment Management): 23,910 records, 116,311 current facts, last verified 2026-10-12, re-checked monthly.
- Company Tickers and Exchanges (U.S. Securities and Exchange Commission (EDGAR)): 8,023 records, 24,069 current facts, last verified 2026-10-29, re-checked daily.

## Machine access

- REST: https://jid.com/v1/search?q=..., https://jid.com/v1/entities/{id}, https://jid.com/v1/entities/{id}/verify[?activity=...], https://jid.com/v1/receipts/{id}, https://jid.com/v1/activities, POST https://jid.com/v1/monitors (signed webhooks with old and new values), POST https://jid.com/v1/qualify (lead and counterparty qualification), GET or POST https://jid.com/v1/screen (engage or not)
- MCP (streamable HTTP): https://jid.com/mcp with tools search_business, verify_business, get_business_file, get_receipt, qualify_counterparty, screen
- No key: 10 requests a minute and 100 a day per IP. Free key (e-mail, no card): 1,000 file checks a month. Then $0.05 a check or less; search is free. https://jid.com/pricing
- Signed badge statements: https://jid.com/badge/{id}.json, keys at https://jid.com/.well-known/jid-keys.json

## Key pages

- https://jid.com/methodology: how facts are collected, matched, verified and scored
- https://jid.com/coverage: per-source counts
- https://jid.com/decision-rules: what each activity requires, and the law behind it
- https://jid.com/solutions/procurement-agents: verify a supplier before an agent pays it (MCP config, TypeScript and Python)
- https://jid.com/playground: run a real decision on any business in the browser and check the signed receipt (no sign-up)
- https://jid.com/api-docs#quickstart: five-minute quickstart (free key, verify with activity, verify the receipt, add the MCP server to Claude or ChatGPT), TypeScript and Python
- https://jid.com/api-docs, https://jid.com/openapi.json and https://jid.com/agents
- https://jid.com/design-partners: 12 months free (API, monitoring, Verified) for AI procurement and accounts payable agent builders and regulated marketplaces, in exchange for production use and a case study
- https://jid.com/disputes: corrections policy (response within 10 business days)
- https://jid.com/terms