/sam-gov-exclusions

name: sam-gov-exclusions
description: "Screen a person or company against the official US federal debarment and exclusions list for free - SAM.gov Exclusions (the System for Award Management, formerly EPLS). Use for US government debarment and suspension screening, the exclusions leg of a KYC/AML/KYB workflow, federal contractor eligibility checks, and confirming a counterparty is not barred from US federal awards. Trigger on: 'SAM.gov', 'SAM exclusions', 'debarment check', 'is this company debarred', 'federal suspension', 'excluded parties', 'EPLS', 'US government screening', 'excluded from federal contracts'. The exclusions data is free with an ordinary personal API key; the sensitive/FOUO entity registration data is federal-gated and out of scope here."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - free-api
    - debarment
    - exclusions
    - sam-gov
    - aml
    - kyc
    - screening
    - usa
  triggers:
    - "SAM.gov exclusions check"
    - "is this company or person debarred"
    - "US federal debarment screening"
    - "federal suspension check"
    - "excluded parties list check"
    - "EPLS lookup"
    - "excluded from US federal contracts"
    - "debarment leg of an AML screen"
    - "screen a beneficial owner against SAM.gov"

sam-gov-exclusions

Screen a name against the official US federal exclusions list - SAM.gov Exclusions, the authoritative record of parties suspended, debarred, or otherwise excluded from receiving federal contracts, grants, and other assistance. This is the debarment leg of a KYC/AML/KYB check: take the entity and the beneficial owners / directors you extracted from a registry, and confirm none of them is barred from US federal awards. The exclusions data is free; you register your own free API key.

Persona

You are an AML / due-diligence analyst running the debarment lane of a screen. You check customers, counterparties, and their beneficial owners against the US government's exclusions list, you understand that a name match is a *candidate* that must be adjudicated (not an automatic block), and you keep debarment separate from sanctions and from PEP status - three different data problems that together make one screen.

What this gives you (for free)

• **Exclusion records** - every active US federal exclusion: the excluded party's name, the exclusion type and program, the excluding agency, and the effective dates.
• **Classification** - whether the excluded party is an `Individual`, a `Firm`, a `Vessel`, or a `Special Entity Designation`.
• **Excluding agency** - the federal agency that imposed the exclusion, by name and code.
• **Dates** - activation / creation and termination dates, so you can tell an active exclusion from a lapsed one.
• **Identifiers** - the SAM `UEI` (Unique Entity Identifier - DUNS has been retired), `CAGE` code, and `NPI` where present.
• **Addresses** - primary plus secondary address for the excluded party.

This is US federal public-domain data. Read-only. Responses are paginated, JSON, 10 records per page by default.

Authentication (free, but read the rate-limit trap)

1. Register a free account and get a **Public API Key** from https://sam.gov/workspace/profile/account-details (sign up, confirm the email OTP). The public **Exclusions** data works with this ordinary personal key - no system-account approval needed. 2. **Get a free SAM.gov role assigned to your account.** This is the real trap, not an afterthought:

• A non-federal key **without a role = 10 requests/day** - effectively unusable for screening.
• A non-federal key **with a free self-service role assigned = 1,000 requests/day.**
• The role is free self-service, not a paid approval. Do not skip it, or you will burn your daily quota on the third or fourth name.

3. Pass the key as the `api_key` query parameter on every call.

export SAM_KEY=your_sam_gov_public_api_key
curl -s "https://api.sam.gov/entity-information/v4/exclusions?api_key=$SAM_KEY&exclusionName=ACME&classification=Firm"

There is no per-call fee. For a full-dataset screen, the **bulk extract download bypasses the per-record limit** entirely - one ZIP is the whole exclusions dataset (see below).

**Scope note:** free-with-public-key covers exclusions search and the public exclusions extract - the screening-useful part. The sensitive / FOUO **entity registration** data is federal-gated (federal system accounts only); it is out of scope for this skill, so do not try to pull it here.

Before starting

Ask the user for whichever is missing:

• **The name(s) to screen** - the entity plus every beneficial owner / director you want checked.
• **What they need** - a one-off name check, or a full-dataset screen (in which case pull the extract once and match locally).

API reference

Exclusions REST API base: `https://api.sam.gov/entity-information/v4/exclusions` Bulk extract base: `https://api.sam.gov/data-services/v1/extracts`

| # | Purpose | Method + path | |---|---|---| | 1 | Search exclusions by name | `GET /entity-information/v4/exclusions?api_key=KEY&exclusionName={name}&classification={Firm\|Individual}` | | 2 | Daily public extract (full ZIP, no per-record cost) | `GET /data-services/v1/extracts?api_key=KEY&fileName=SAM_Exclusions_Public_Extract_V2_<YYDDD>.ZIP` |

# 1. Search by name (one candidate at a time)
curl -s "https://api.sam.gov/entity-information/v4/exclusions?api_key=$SAM_KEY&exclusionName=ACME&classification=Firm"

# 2. Pull the whole public exclusions extract as one ZIP (bypasses the per-record limit)
#    <YYDDD> = 2-digit year + day-of-year, e.g. 26199 for the 199th day of 2026
curl -sL -o exclusions.zip \
  "https://api.sam.gov/data-services/v1/extracts?api_key=$SAM_KEY&fileName=SAM_Exclusions_Public_Extract_V2_26199.ZIP"

For more than a handful of names, prefer endpoint 2: download the extract once, then match every subject locally. That keeps you well clear of the 1,000/day cap and gives you the whole datas