Federal Exclusions Check (SAM.gov)

GET/v1/legal/exclusions/check$0.01 per call

Checks a party against the SAM.gov public federal exclusions list (about 169,000 active debarments and exclusions, refreshed daily). A UEI, CAGE or NPI match is exact. A name match is exact after normalization (punctuation and legal suffixes ignored for businesses; one optional middle name for individuals) and is only a weak signal: the list has no date of birth, so people who share a name cannot be told apart. Business names must have two or more words.

Parameters

Name	In	Type	Description
ueioptional	query	string	SAM.gov Unique Entity ID
cageoptional	query	string	CAGE code
npioptional	query	string	National Provider Identifier
nameoptional	query	string
typeoptional	query	string	one of "business", "individual" · default "business"

Response fields

Field	Type	Description
success	boolean
totalMatches	integer
matches	array of object
matches[].matchType	string
matches[].entityName	string
matches[].agency	string
matches[].reason	string
matches[].description	string
matches[].activeDate	string
matches[].terminationDate	string
matches[].ueiSAM	string

Fields are read from a real response captured 2026-11-04. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
503 temporarily unavailable
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl "https://api.compliancegrid.ai/v1/legal/exclusions/check?uei=SZR6J91CCZT9" \
  -H "Authorization: Bearer $CG_API_KEY"

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

uei (query)

cage (query)

npi (query)

name (query)

type (query)

Example response · captured from production 2026-11-04

{
  "success": true,
  "matches": [
    {
      "matchType": "UEI",
      "entityName": "4 J Source and Solutions LLC",
      "agency": "DLA",
      "reason": "SUSPENSION",
      "description": "Ineligible (Proceedings Pending) by DLA (Reciprocal program). DLA SDO HAS PROPOSED DEBARMENT OF THIS ENTITY AND ALL AFFILIATED PARTIES.",
      "activeDate": "2026-07-10",
      "terminationDate": "Indefinite",
      "ueiSAM": "SZR6J91CCZT9"
    }
  ],
  "totalMatches": 1,
  "dataSource": {
    "name": "SAM.gov public exclusions extract (database)",
    "note": "UEI, CAGE and NPI matches are exact; name matches are weaker and need confirming."
  },
  "meta": {
    "dataSource": {
      "name": "SAM.gov public exclusions extract (database)",
      "provenance": "database",
      "note": "UEI, CAGE and NPI matches are exact; name matches are weaker and need confirming."
    }
  }
}