# Audit suppliers for expiring SAM registrations

To audit a supplier list for expiring SAM.gov registrations with an AI agent, give it the UEIs and ask it to call registration_status for each one, then sort by days_to_expiry. Anything expired or inside the renew_now and renew_soon windows goes to the top with its expiration date and the date of the extract checked.

Prime contractors and grant recipients whose subcontractors must keep active registrations, and contracts teams onboarding new suppliers. An expired subcontractor registration rarely stops work on day one, but it surfaces at the worst time: a modification, an option exercise or a new award.

## The prompt

```
Here are the UEIs of our 25 subcontractors. Check each SAM.gov registration and give me a table sorted by days to expiry, with anything expired or expiring in the next 90 days at the top. Note the data date.
```

## What the agent calls

1. registration_status: Repeated once per UEI. The renewal window field does the triage.

```json
{"name":"registration_status","arguments":{"id":"ABCDEFGH1234","user_request":"supplier registration audit"}}
```

## Sample output

Trimmed; field names and structure match the live response, values are shortened or illustrative.

```json
{
  "data": {
    "uei": "ABCDEFGH1234",
    "legal_name": "EXAMPLE SUPPLY CO",
    "status": "active",
    "expiration_date": "2026-12-30",
    "days_to_expiry": 47,
    "renewal_window": "renew_now",
    "exclusion_flag": false,
    "as_of": "2026-11-01"
  }
}
```

## How to read the answer

- renew_now means 60 days or fewer. Send those suppliers a reminder that renewal is free at sam.gov and must be done by them.
- A supplier that returns NOT_FOUND has no active or recent registration under that UEI; check the UEI with them.

## Make it yours

- Combine with exclusion_check per supplier for a full screening table.
- For a market-wide view, expiring_registrations lists firms in a NAICS and state whose registrations expire within N days.

## Pitfalls

- Do not offer to renew registrations for suppliers or charge for it. Point them to sam.gov.
- Re-run the audit after each monthly extract; a single check goes stale.

## The same job over REST

```bash
curl "https://samgovapi.io/api/v1/registration-status/ABCDEFGH1234" -H "Authorization: Bearer $SAMGOVAPI_API_KEY"
```

Plan: every plan. Credits: 1 credit per lookup; one per supplier.

## Questions

### Can I get alerts instead of re-running this?

Yes. Paid plans include API alerts on registration expiry, and the free watch page emails one registration's owner before it lapses.

### Does an expired registration void an existing contract?

Not by itself, but an active registration is required at award and for many payment and modification actions. Check FAR 4.1102 and your contract terms.

All recipes: https://samgovapi.io/agents/recipes.md

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.