# How do I screen a whole supplier list against SAM.gov exclusions? Loop over the list and check each UEI, CAGE or exact name against the exclusions data: one call per supplier. At 1 credit per check here, a 2,000-vendor file costs 2,000 credits, inside the Developer plan; the official Exclusions API would need two days at 1,000 calls a day with a SAM.gov role. Screen in the order of reliability: UEI first, then CAGE, then exact legal name.Checked on 2026-11-15.Official source: [open.gsa.gov Exclusions API](https://open.gsa.gov/api/exclusions-api/) | Cost per supplier here | 2 credits (exclusion + status) | | --- | --- | | Exclusion records | 169,191 | | Expired registrations | 78,094 | | Developer plan | 10,000 credits a month | ## The answer in detail Screen in the order of reliability: UEI first, then CAGE, then exact legal name. Write every result with the field that matched and the exclusion's dates, so a reviewer can confirm name-only hits and so the file serves as evidence of the check.Repeat the screen on a schedule. Exclusions are added and lifted every day; quarterly is common for supplier files, monthly for active subcontractors. Re-screening only active vendors keeps the cost down.The same loop can pull each supplier's registration status and expiry with /registration-status, which catches the other common blocker: an expired SAM.gov registration (78,094 in the current extract). ## How the options compare | Option | Price | Access and limits | Coverage and history | Best for | Checked | | --- | --- | --- | --- | --- | --- | | [SAM.gov APIs (official)](https://open.gsa.gov/api/entity-api/) | Free | 10 requests a day with no SAM.gov role, 1,000 with a role or a non-federal system account; keys expire every 90 days | The live, authoritative record: entities, opportunities, exclusions, contract awards, hierarchy, subawards | Anyone who needs the official record itself, at low volume | 2026-11-12 | | [GovCon API (govconapi.com)](https://govconapi.com/pricing) | Developer $19/mo, Pro $39/mo; 14-day trial | 1,000 requests an hour (50 a minute burst); trial 50 a day | 12,265,150 contracts and 758,552 opportunities from FY2025; 904,090 entities, monthly | Developers who want the lowest entry price and FY2025+ history | 2026-11-15 | | [samgovapi.io](https://samgovapi.io/pricing) | Free (100 credits a month, no card); Developer $49/mo, Pro $149/mo, Scale $499/mo | 20 to 180 requests a minute by plan, no daily cap; REST, MCP and keyless MCP search | 881,370 entities (1 Nov 2026 extract), 74,420 notices, 169,191 exclusions, 114,954 awards since 1 Oct 2026 | Developers and AI agents who want entities, bids and exclusions joined in one API | 2026-11-15 | ## Where samgovapi.io is the weaker choice - One call per vendor: there is no batch upload endpoint yet. - Exclusions refresh daily, so a same-day exclusion is missed until the next load. ## Try it Reads suppliers.csv (a uei column) and writes screened.csv with the result of each check. ``` import csv, os, time, requests key = os.environ["SAMGOVAPI_API_KEY"] h = {"Authorization": f"Bearer {key}"} with open("suppliers.csv") as src, open("screened.csv", "w", newline="") as out: w = csv.writer(out); w.writerow(["uei", "excluded", "status", "expires"]) for row in csv.DictReader(src): ex = requests.get("https://samgovapi.io/api/v1/exclusions/check", params={"q": row["uei"]}, headers=h, timeout=30).json()["data"] st = requests.get(f"https://samgovapi.io/api/v1/registration-status/{row['uei']}", headers=h, timeout=30).json()["data"] w.writerow([row["uei"], ex.get("excluded"), st.get("status"), st.get("expiration_date")]) time.sleep(1.1) ``` ## Questions How often should I re-screen suppliers?Quarterly for a supplier master file and monthly for active subcontractors is common; your contract or compliance policy may set it.Is a name match enough?No. Treat a name-only match as a lead and confirm with the address, UEI or CAGE in the exclusion record. ## Related - [SAM exclusion check](https://samgovapi.io/sam-exclusion-check) - [Recipe: screen a supplier list](https://samgovapi.io/agents/recipes/screen-a-supplier-list-for-exclusions) - [API docs](https://samgovapi.io/docs) - [Pricing](https://samgovapi.io/pricing) - [Answers](https://samgovapi.io/answers)Updated 2026-11-15. Sources checked 2026-11-15.Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

---

HTML version: https://samgovapi.io/answers/screen-supplier-list-for-exclusions . Markdown: https://samgovapi.io/answers/screen-supplier-list-for-exclusions.md

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

Get a free API key: https://samgovapi.io/sign-up?ref=ai-claudebot