SAM.gov Exclusions

🔎 Screen Vendors Against SAM.gov Exclusions

For procurement teams, compliance staff, and developers, this Actor checks submitted vendors against current SAM.gov federal exclusion records. For each vendor that meets the input requirement, it returns one structured row with a clear, possible-match, excluded, or not-found outcome, matching evidence, an official source URL, and the UTC retrieval time. Use a vendor name, UEI, or CAGE code for a repeatable check.

• Screen one submitted vendor and review its federal record with OIG Exclusion List.
• Search submitted vendor identifiers with SAM Exclusion List.
• Look up a submitted vendor in the legacy system with EPLS Search.
• Review a submitted vendor's GSA record with GSA Exclusion List.
• Check a submitted CAGE code with Excluded Parties List System.
• Review a provider's submitted name with Provider Exclusion List.

📋 Review Vendor Outcomes and Evidence

Each saved row keeps the submitted vendor values, the screening outcome, any matching or possible-match SAM.gov exclusion records, the source URL, and the UTC retrieval time. An exclusion can include identity, UEI, CAGE code, status, program, type, agency, dates, classification, and address when SAM.gov provides them.

When the same source item appears more than once, the first eligible occurrence is saved and later repeats are ignored.

▶️ Run a Vendor Screening

1. Add one or more vendors. Each vendor must include at least one non-empty name, UEI, or CAGE code.
2. Choose Active exclusions or All exclusions. Active exclusions is the default.
3. Add optional agency, program, exclusion type, country, or U.S. state filters when you need a narrower check.
4. Start the run and open the default dataset when it finishes.

Leaving an optional filter empty keeps all values for that filter until the source is exhausted.

⚙️ Input

Input fields

Field	Type	What it does
vendors	Array of objects	Adds one or more vendors to check. Each item must include at least one non-empty name, UEI, or CAGE code. You can combine them.
vendors[].name	String	Gives the vendor's legal name.
vendors[].uei	String	Gives the vendor's 12-character Unique Entity ID.
vendors[].cageCode	String	Gives the vendor's 5-character CAGE code.
exclusionStatus	String: active or all	Chooses active exclusions or all SAM.gov exclusion records. active is the default.
excludingAgency	Array of strings	Keeps records from the listed excluding agencies. Leave empty to use all agencies.
program	Array of strings	Keeps records from the listed programs. Leave empty to use all programs.
exclusionType	Array of strings	Keeps records with the listed exclusion types. Leave empty to use all types.
country	Array of strings	Keeps records from the listed countries. Leave empty to use all countries.
state	Array of strings	Keeps records from the listed U.S. states. Leave empty to use all states.

This example uses the smallest successful vendor check:

{
  "vendors": [
    {
      "name": "DYNAMIC MINDS FAMILY SERVICES, LLC"
    }
  ],
  "exclusionStatus": "active"
}

🧾 Output

Output fields

Field	Type	What it does
vendor	Object	Shows the submitted vendor values checked in this row.
vendor.name	String	Shows the submitted vendor name.
vendor.uei	String	Shows the submitted UEI when provided.
vendor.cageCode	String	Shows the submitted CAGE code when provided.
outcome	String: clear, possibleMatch, excluded, or notFound	Gives the screening outcome. A possible match or exclusion needs human review.
exclusions	Array of objects	Lists SAM.gov exclusion records that matched or may match the vendor.
exclusions[].exclusionId	String	Gives the SAM.gov identifier for the exclusion record when available.
exclusions[].name	String	Shows the name on the exclusion record when available.
exclusions[].uei	String	Shows the UEI on the exclusion record when available.
exclusions[].cageCode	String	Shows the CAGE code on the exclusion record when available.
exclusions[].status	String: active or inactive	Shows whether the exclusion record is active or inactive.
exclusions[].program	String	Shows the program named on the exclusion record when available.
exclusions[].exclusionType	String	Shows the exclusion type when available.
exclusions[].excludingAgency	String	Shows the agency that issued the exclusion when available.
exclusions[].exclusionDate	Date string	Shows when the exclusion began when available.
exclusions[].terminationDate	Date string	Shows when the exclusion ended or is due to end when available.
exclusions[].classification	String	Shows the classification on the exclusion record when available.
exclusions[].address	Object	Shows the address on the exclusion record when available.
exclusions[].address.line1	String	Shows the first address line when available.
exclusions[].address.line2	String	Shows the second address line when available.
exclusions[].address.city	String	Shows the city when available.
exclusions[].address.state	String	Shows the state or region when available.
exclusions[].address.postalCode	String	Shows the postal code when available.
exclusions[].address.country	String	Shows the country when available.
sourceUrl	URI string	Links to the official SAM.gov page or data URL used for the screening.
retrievedAt	UTC date-time string	Shows when the official SAM.gov data for this row was retrieved.

Example row

This shortened row is a genuine result from the current beta run for the example input. The run returned 100 exclusion records, and only the first record is shown here.

{
  "vendor": {
    "name": "DYNAMIC MINDS FAMILY SERVICES, LLC"
  },
  "outcome": "excluded",
  "exclusions": [
    {
      "exclusionId": "268b6a87-711e-4198-9a9e-063c3eef8c04",
      "name": "DYNAMIC MINDS FAMILY SERVICES",
      "uei": "MGS1EPM43F23",
      "status": "active",
      "program": "Reciprocal",
      "exclusionType": "Prohibition/Restriction",
      "excludingAgency": "OPM",
      "exclusionDate": "2020-10-27",
      "classification": "Special Entity Designation",
      "address": {
        "line1": "5755 S SANDHILL ROAD, SUITE A",
        "city": "LAS VEGAS",
        "state": "NV",
        "postalCode": "89120",
        "country": "USA"
      }
    },
    "..."
  ],
  "sourceUrl": "https://sam.gov/api/prod/sgs/v1/search/?index=ex&page=0&size=100&sort=-relevance&date_filter_index=ex&is_active=true&q=DYNAMIC+MINDS+FAMILY+SERVICES",
  "retrievedAt": "2026-09-05T16:29:12.617Z"
}

💳 Pricing

How charges work

This Actor uses pay-per-event pricing. The primary event is Vendor screening: one completed vendor screening is charged when current SAM.gov exclusion records are checked. See the live Store price before you run.

🔌 Integrations

Dataset access

Open the default dataset from the run to use its structured rows in Apify tools or through the dataset API.

Walkthrough

See the run flow here:

❓ FAQ

Can I screen more than one vendor in one run?

Yes. Add multiple vendor objects to vendors. Each item must include at least one non-empty name, UEI, or CAGE code, and the Actor checks those vendors in one run.

Can I use only a UEI or CAGE code?

Yes. Each vendor item must include at least one non-empty name, UEI, or CAGE code. You can combine them. UEIs must have 12 letters or numbers, and CAGE codes must have 5 letters or numbers.

What does a possible match mean?

It means a SAM.gov record may match the submitted vendor. Review the name, identifiers, agency, type, dates, and address before you act. It is not a legal, award, responsibility, or teaming-eligibility decision.

What does notFound mean?

It means no exclusion match was found for the submitted vendor under the chosen status and filters. The row still keeps the submitted vendor, outcome, source URL, and retrieval time.

Can I include inactive exclusions?

Yes. Set exclusionStatus to all to include active and inactive records. The default is active.

Why might an exclusion field be missing?

SAM.gov records do not always include every identifier, date, or address. When a source value is unavailable, the matching output field is not included.

Do I need a SAM.gov API key?

No buyer-supplied SAM.gov API credential is needed for the core search. The Actor checks public SAM.gov data and includes the official source URL used for each row.

Can I use this as a final eligibility decision?

No. Possible matches and status flags need human verification against the official source before a legal, award, responsibility, or teaming decision.

How are repeated source matches handled?

The first eligible occurrence of a source item is saved. Later appearances of that same source item are ignored, so one row does not collect every later matching value.

📝 Changelog

v1.0 (05-09-2026)

• The exclusion status choices are now active and all.
• Invalid vendor items are skipped with a clear warning while valid vendors continue to produce screening results.

v0.0

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Sanctions & Watchlist Screening — Risk-Scored Decisions checks names against OFAC, EU, UK OFSI, and UN sanctions lists for broader sanctions coverage.
• SAM.gov Contractor Exclusions — Debarment Records API provides a broader SAM.gov contractor exclusion record pull.
• SAM.gov Entity Exclusions Scraper exports public SAM.gov exclusion records for vendor screening and debarment monitoring.
• SAM.gov Vendor Screening — Exclusions & Registration Check adds SAM registration status and expiry checks beside exclusion screening.
• OIG LEIE & SAM Exclusion Screening API: 49 Official Lists covers SAM, OIG, and state Medicaid exclusion lists in one check.

Made with ❤️ by Maxime Dupré