# Monitor your SAM registration expiry

To monitor your SAM.gov registration expiry with an AI agent, ask it to call registration_status with your UEI. It returns your expiration date, days to expiry and a renewal window (current, renew_soon, renew_now or expired) from the latest public extract. Renewal itself is free and done by you at sam.gov.

Every registered contractor. A SAM.gov registration has to be renewed every year, and an expired registration blocks new awards and can delay payment on existing ones. The renewal often takes weeks when a notarized letter or a validation step is needed, so the useful question is not whether it expired but how many days are left.

## The prompt

```
When does the SAM.gov registration for my UEI ZXBCU6K5KL99 expire, how many days are left, and should I start renewing now? Quote the data date.
```

## What the agent calls

1. registration_status: One lookup returns the expiration date and the renewal window, so the agent can say whether to act now.

```json
{"name":"registration_status","arguments":{"id":"ZXBCU6K5KL99","user_request":"check my own registration expiry"}}
```

## Sample output

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

```json
{
  "data": {
    "uei": "ZXBCU6K5KL99",
    "status": "active",
    "expiration_date": "2027-10-20",
    "days_to_expiry": 341,
    "renewal_window": "current",
    "answer": "The SAM.gov registration is active and expires 2027-10-20.",
    "as_of": "2026-11-01"
  }
}
```

## How to read the answer

- Start the renewal when the window turns renew_soon (120 days). SAM.gov allows renewal up to 60 days before expiration, and the extra margin covers validation delays.
- days_to_expiry is counted from today, but the record is as of the extract date in as_of. If you renewed after that date, the new expiry appears after the next load.

## Make it yours

- Ask the agent to check every UEI your company owns, such as subsidiaries and joint ventures, in one table.
- For a free email reminder without an agent, use the watch page; for alerts on many registrations, use API alerts on a paid plan.
- In Claude Code or Codex, ask it to write a small script that calls the REST endpoint weekly and prints a warning under 120 days.

## Pitfalls

- Never pay a third party to renew. Renewal is free at sam.gov, and only the entity can do it.
- An active status with a past expiration date can appear briefly between extracts. Trust the expiration_date and confirm on sam.gov.

## The same job over REST

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

Plan: every plan. Credits: 1 credit per lookup.

## Questions

### Can the agent renew my registration for me?

No. Renewal is done by the entity's own administrator at sam.gov, for free. The agent tells you when to start and links the record.

### How early can I renew?

SAM.gov lets you renew within 60 days of expiration. Planning from 120 days out leaves time to gather documents.

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.