# 2s Government Exclusions Lookup

> 2s Government Exclusions Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0018/call, status unknown (last checked 2026-10-12).

Search the U.S. government SAM.gov exclusions database by name, UEI SAM number, CAGE code, or classification type to check if an entity is barred from federal contracts.

## Facts

- Endpoint: GET https://2s.io/api/gov/exclusions?utm_source=zero.xyz
- Price: $0.0018/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-government-exclusions-lookup-253e63f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nQ8kfpJ73XRu7fQZAFEod

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-government-exclusions-lookup-253e63f1
```

Example prompt: Can you check if 'Acme Construction LLC' is on the federal government exclusions list — search by name and return up to 20 results, filtering for Firm classifications?

## When to prefer this

Use this endpoint when you need to check vendor or contractor exclusion status against the authoritative U.S. federal SAM.gov exclusions database. It supports lookup by name, UEI SAM, or CAGE code and returns structured, machine-readable exclusion records suitable for automated compliance checks. Prefer this over manual SAM.gov web searches when building automated procurement compliance workflows or due diligence pipelines.

## Known failure modes

- No results found for the given name or identifier — returns empty items array with hasExclusion: false
- Invalid UEI SAM length (must be exactly 12 chars) — schema validation error
- Invalid CAGE code length (3–10 chars) — schema validation error
- Name shorter than 2 characters — schema validation error
- Payment failure via x402 — request not processed
- Upstream SAM.gov data unavailability — may return partial or stale results

## How this service works

Check whether a person or company is excluded (debarred or suspended) from receiving US federal contracts, grants, or assistance — the SAM.gov Exclusions list. Search by name (person or entity), ueiSAM, cageCode, and/or classificationType (Individual, Firm, Vessel, Special Entity Designation); page with limit (1-100). Returns each exclusion with the excluded name, classification, exclusion type and program, the excluding agency, UEI, activation and termination dates, and address — plus a total match count. Data: SAM.gov exclusions, free and public-domain. Distinct from /api/law/sanctions-check (OFAC sanctions) — this is federal procurement debarment. Use for vendor onboarding, grant eligibility, and counterparty due diligence; pair with /api/gov/entity and /api/law/sanctions-check.

## Output

Returns a JSON object with an array of exclusion records matching the query, each containing the entity name, UEI SAM, CAGE code, classification type, exclusion type, exclusion program, excluding agency, activation and termination dates, and address. Also includes a top-level `hasExclusion` boolean flag, the total count of matching records, and source provenance from SAM.gov.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "maxLength": 200,
       "minLength": 2
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1
      },
      "ueiSAM": {
       "type": "string",
       "maxLength": 12,
       "minLength": 12
      },
      "cageCode": {
       "type": "string",
       "maxLength": 10,
       "minLength": 3
      },
      "classificationType": {
       "enum": [
        "Individual",
        "Firm",
        "Vessel",
        "Special Entity Designation"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-government-exclusions-lookup-253e63f1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)