# Check SAM.gov registrations and exclusions by API

> Get an entity's registration status and expiration date, a partner's exclusion records or new contract opportunities from SAM.gov with one API call each. Or have a workflow check your UEIs every Monday and email you before a registration lapses.

Page: https://fous.com/automate/sam-gov
Updated: 2026-11-12

Works with your own SAM.gov account. Fous is an independent product.

## What you can build on SAM.gov

### Get registration status by UEI

Searches Entities in Entity Information for each UEI you give and reads the registration: status, expiration date, CAGE code and entity name.

- Takes: UEIs
- Returns: Legal business name, UEI, CAGE code, registration status, registration expiration date, NAICS codes

### Check a partner for exclusions

Searches Entity Information for a company by UEI or name and reads any exclusion records, active or not, with the excluding agency and dates.

- Takes: UEI or company name, active only (optional)
- Returns: Name, UEI, CAGE code, classification, exclusion type, exclusion program, excluding agency, activation date, termination date

### Find new contract opportunities

Searches Contract Opportunities by NAICS code, set-aside and posted date and reads each notice in the results.

- Takes: NAICS codes, set-aside (optional), posted since
- Returns: Notice ID, title, solicitation number, notice type, posted date, response deadline, NAICS code, set-aside, link

## Automate SAM.gov with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Registrations close to expiring, every Monday

Starts: Every Monday at 8:00

1. Get the registration status for each UEI your company holds.
2. Keep the entities that are not Active or expire within 60 days.
3. Email you the list with UEI, status and expiration date.

### Exclusion check across your subcontractors

Starts: Every weekday at 7:00

1. For each subcontractor UEI on your list, check for exclusion records.
2. Keep the active records that were not there on the last run.
3. Post each one to your compliance system's webhook.

### New opportunities in your NAICS codes

Starts: Every weekday at 6:30

1. Find contract opportunities posted since yesterday in your NAICS codes.
2. Keep the notices that were not there on the last run.
3. Group them by notice type and email you the list.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get registration status by UEI” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "sam.gov/get_registration_status",
    "input": {
      "ueis": [
        "K7QJ3LMN8PX4",
        "R2HD9TWB5CE1"
      ]
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "entities": [
      {
        "legal_business_name": "Acme Fabrication LLC",
        "uei": "K7QJ3LMN8PX4",
        "cage_code": "8XK41",
        "registration_status": "Active",
        "registration_expiration_date": "2027-01-06",
        "naics_codes": [
          "332312"
        ]
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## SAM.gov’s own options

GSA publishes Entity Management, Exclusions and Opportunities APIs that search public SAM.gov data with a personal API key from your Account Details page. On the Entity Management and Exclusions APIs, a non-federal user without a SAM.gov role gets 10 requests a day, with a role 1,000. Contact and banking details need a federal system account.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Entity Management API | Registration details: UEI, CAGE code, registration status and expiration date, NAICS. Extracts of up to 1,000,000 records as JSON or CSV. | A personal API key: 10 requests a day without a SAM.gov role, 1,000 with one. A system account must be requested and approved. |
| Exclusions API | Exclusion records: classification, exclusion type and program, excluding agency, activation and termination dates. | A personal API key, with the same daily limits as the Entity Management API. |
| Get Opportunities Public API | Contract notices posted in a date range of at most 1 year, up to 1,000 per call, with NAICS, set-aside and response deadline. | A public API key from your SAM.gov Account Details page. |
| SAM.gov by hand | Entity Information and Contract Opportunities searches, Subcontract Reports, entity registration, and Entity and Exclusions data files. | A SAM.gov account, signed in through Login.gov. |

Read on November 12, 2026: [SAM.gov Entity Management API](https://open.gsa.gov/api/entity-api/), [SAM.gov Exclusions API](https://open.gsa.gov/api/exclusions-api/), [Get Opportunities Public API](https://open.gsa.gov/api/get-opportunities-public-api/).

## Signing in to SAM.gov

SAM.gov signs you in through Login.gov: your email address and password, then at least one multi-factor method: your device's face or fingerprint check, an authentication app, a security key, a phone, backup codes or a PIV/CAC card. With Fous you sign in once through SAM.gov's own sign-in with your own account: the login is sealed with AES-256 and never returned by the API.

## Worth knowing

- **Registration lasts 365 days**: You must renew your entity registration every 365 days to keep it active. You can update it at any time, or during the renewal.
- **A personal API key is rate limited**: A non-federal user with no SAM.gov role gets 10 API requests a day; one with a role gets 1,000. A standard Entity API search returns 10 records a page and only the first 10,000.
- **Contacts and banking are not public data**: Point-of-contact email and phone are FOUO, and banking details and TIN are Sensitive. Both need a federal system account with Read FOUO or Read Sensitive.
- **More ISR contracts since June 2026**: After a change to ISR eligibility on June 9, 2026, more contracts may show in your Eligible Workspace in Subcontracting Plan Reporting. Evaluate each contract's subcontracting plan.

## More in Government: US federal

- [BSA E-Filing System](https://fous.com/automate/bsa-e-filing-system.md)
- [FINRA Gateway](https://fous.com/automate/finra-gateway.md)
- [PostalOne](https://fous.com/automate/postalone.md)
- [USPS Business Customer Gateway](https://fous.com/automate/usps-business-customer-gateway.md)
- [Invoice Processing Platform](https://fous.com/automate/invoice-processing-platform.md)
- [FMCSA Drug & Alcohol Clearinghouse](https://fous.com/automate/fmcsa-drug-and-alcohol-clearinghouse.md)
- [Wide Area Workflow](https://fous.com/automate/wide-area-workflow.md)
- [E-Verify](https://fous.com/automate/e-verify.md)
- [EPA Central Data Exchange](https://fous.com/automate/epa-central-data-exchange.md)
- [CM/ECF](https://fous.com/automate/cm-ecf.md)
- [EFTPS](https://fous.com/automate/eftps.md)
- [FBI NICS E-Check](https://fous.com/automate/fbi-nics-e-check.md)
- [FLAG](https://fous.com/automate/flag.md)
- [HUD Secure Systems](https://fous.com/automate/hud-secure-systems.md)
- [USCIS online account](https://fous.com/automate/uscis-online-account.md)
- [IRIS Taxpayer Portal](https://fous.com/automate/iris-taxpayer-portal.md)
- [Motus](https://fous.com/automate/motus.md)
- [TRACS / iMAX](https://fous.com/automate/tracs-imax.md)
- [USPTO Patent Center](https://fous.com/automate/uspto-patent-center.md)
- [EDGAR Filer Management](https://fous.com/automate/edgar-filer-management.md)
- [COD](https://fous.com/automate/cod.md)
- [IRS e-Services](https://fous.com/automate/irs-e-services.md)
- [IRS Tax Pro Account](https://fous.com/automate/irs-tax-pro-account.md)
- [EIV](https://fous.com/automate/eiv.md)
- [USPTO Trademark Center](https://fous.com/automate/uspto-trademark-center.md)
- [SSA Business Services Online](https://fous.com/automate/ssa-business-services-online.md)
- [NetDMR](https://fous.com/automate/netdmr.md)

Other industries: [MyFloridaMarketPlace Vendor Information Portal](/automate/myfloridamarketplace-vendor-information-portal), [MassTaxConnect](/automate/masstaxconnect), [MiUI Employer Portal](/automate/miui-employer-portal), [McMaster-Carr](/automate/mcmaster-carr), [Upwork](/automate/upwork), [Alliance Healthcare portal (UK)](/automate/alliance-healthcare-portal-uk).

## Frequently asked questions

### Does SAM.gov have an API?

Yes, for public data. GSA's Entity Management, Exclusions and Opportunities APIs search registrations, exclusion records and contract notices with a personal API key. On the first two, a non-federal user without a SAM.gov role gets 10 requests a day, with one 1,000. Contact and banking details need a federal system account.

### How often do I have to renew my SAM.gov registration?

Every 365 days. SAM.gov says you must renew your registration every 365 days to keep it active, and you can update it at any time in between. A workflow can check your UEIs' registration expiration dates every week and email you before one lapses.

### How do I check whether a subcontractor is excluded?

Search Entity Information on SAM.gov by the company's name or UEI, or call the Exclusions API. An exclusion record shows the classification, exclusion type and program, excluding agency, and its activation and termination dates.

### Can I get a registration's points of contact through the API?

Not with a non-federal key. Point-of-contact email, phone and fax are FOUO data, which the Entity Management API returns only to a federal system account with Read FOUO. Public calls return name, UEI, addresses, business types and NAICS.

### Is Fous affiliated with the General Services Administration?

No. Fous is an independent product. You use it with your own SAM.gov account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of SAM.gov (General Services Administration). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.