# How do I check SAM.gov registration status programmatically? Call an entity endpoint with the UEI or CAGE and read the registration status and expiration date. The official SAM.gov Entity API returns them within its daily limit; here /registration-status/{id} returns status, expiration date, days left and the exclusion flag in one 1-credit call. Only an Active registration can receive a new federal award (FAR 52.204-7), and registrations must be renewed every 365 days.Checked on 2026-11-15.Official source: [FAR 52.204-7](https://www.acquisition.gov/far/52.204-7) | Active registrations | 803,276 | | --- | --- | | Expired | 78,094 | | Expire within 30 days | 42,506 | | Renewal cycle | Every 365 days | ## The answer in detail Only an Active registration can receive a new federal award (FAR 52.204-7), and registrations must be renewed every 365 days. That makes status and expiry the two fields vendor-onboarding, invoicing and subcontract systems check most often.In the 1 Nov 2026 extract, 803,276 registrations are active and 78,094 expired; 42,506 active ones expire within 30 days and 171,147 within 90.Because this data comes from the monthly extract, treat an expired result as a prompt to check SAM.gov, not a final answer: the firm may have renewed since 1 Nov 2026. ## How the options compare | Option | Price | Access and limits | Coverage and history | Best for | Checked | | --- | --- | --- | --- | --- | --- | | [SAM.gov APIs (official)](https://open.gsa.gov/api/entity-api/) | Free | 10 requests a day with no SAM.gov role, 1,000 with a role or a non-federal system account; keys expire every 90 days | The live, authoritative record: entities, opportunities, exclusions, contract awards, hierarchy, subawards | Anyone who needs the official record itself, at low volume | 2026-11-12 | | [GovCon API (govconapi.com)](https://govconapi.com/pricing) | Developer $19/mo, Pro $39/mo; 14-day trial | 1,000 requests an hour (50 a minute burst); trial 50 a day | 12,265,150 contracts and 758,552 opportunities from FY2025; 904,090 entities, monthly | Developers who want the lowest entry price and FY2025+ history | 2026-11-15 | | [samgovapi.io](https://samgovapi.io/pricing) | Free (100 credits a month, no card); Developer $49/mo, Pro $149/mo, Scale $499/mo | 20 to 180 requests a minute by plan, no daily cap; REST, MCP and keyless MCP search | 881,370 entities (1 Nov 2026 extract), 74,420 notices, 169,191 exclusions, 114,954 awards since 1 Oct 2026 | Developers and AI agents who want entities, bids and exclusions joined in one API | 2026-11-15 | ## Where samgovapi.io is the weaker choice - Entity data comes from the SAM.gov monthly public extract (this one dated 1 Nov 2026; the next is due about 17 Dec 2026), so a registration renewed since then still shows its old expiry date until the next load. The live SAM.gov API shows it the same day. - samgovapi.io is independent and launched in November 2026. For a legal determination (award eligibility, a debarment), check the official record on SAM.gov. ## Try it Works with a UEI or a CAGE code. ``` curl "https://samgovapi.io/api/v1/registration-status/UAVDK5WWYDZ5" \ -H "Authorization: Bearer $SAMGOVAPI_API_KEY" const url = new URL("https://samgovapi.io/api/v1/registration-status/53U20"); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.SAMGOVAPI_API_KEY}` } }); const { data, meta } = await res.json(); console.log(meta.as_of, meta.credits_charged, data); ``` ## Questions What does Active mean in SAM.gov?The registration is complete and current, so the entity is eligible to receive federal awards.Is a status check free here?It costs 1 credit; the free plan includes 100 a month. ## Related - [SAM registration status](https://samgovapi.io/sam-registration-status) - [Check registration status guide](https://samgovapi.io/guides/check-sam-registration-status) - [API docs](https://samgovapi.io/docs) - [Pricing](https://samgovapi.io/pricing) - [Answers](https://samgovapi.io/answers)Updated 2026-11-15. Sources checked 2026-11-15.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.

---

HTML version: https://samgovapi.io/answers/check-sam-registration-status-programmatically . Markdown: https://samgovapi.io/answers/check-sam-registration-status-programmatically.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.

Get a free API key: https://samgovapi.io/sign-up?ref=ai-claudebot