# SAM.gov Entity Management API The SAM.gov Entity Management API returns registrations 10 records per page, with page times size capped at 10,000, and accepts up to 100 UEIs or CAGE codes per call. Public data includes names, UEI, CAGE, addresses, business types, NAICS, PSC and POC names; POC email and phone are FOUO and federal-only. includeSections=All leaves out integrityInformation and repsAndCerts; ask for them by name.Checked on 2026-11-12.Official source: [open.gsa.gov Entity Management API](https://open.gsa.gov/api/entity-api/) | Page size | 10 | | --- | --- | | Reachable records | First 10,000 | | IDs per call | Up to 100 UEIs or CAGE codes | | Async extract | Up to 1,000,000 records | | POC email and phone | FOUO, federal system accounts only | ## Public, FOUO and sensitive data | Tier | Contents | Who | | --- | --- | --- | | Public | Name, UEI, registration details, addresses, business types, NAICS, PSC, POC name and address | Anyone with a key | | FOUO (CUI) | Adds hierarchy, security levels, POC email, phone, fax | Federal system accounts | | Sensitive | Banking, TIN, EIN, SSN | Federal system accounts, POST only | ## Gotchas - includeSections=All leaves out integrityInformation and repsAndCerts; ask for them by name. - samRegistered=No returns UEI-only entities. - The characters & | { } ^ \ are not allowed in parameter values. - Responses mix v1 to v4 field names. ## The same record in one call SAM Gov API returns one entity by UEI or CAGE with registration status, expiry, NAICS with small flags, SBA certifications, exclusion status and award totals. POC email and phone are never included. ``` curl "https://samgovapi.io/api/v1/entities/ABCDEFGH1234" \ -H "Authorization: Bearer sg_YOUR_KEY" ``` ## Get this as JSON ``` curl "https://samgovapi.io/api/v1/entities/ABCDEFGH1234" \ -H "Authorization: Bearer sg_YOUR_KEY" ``` MCP tool: `get_entity`Keys start free, with no card. [Get a free API key](https://samgovapi.io/sign-up) or read the [docs](https://samgovapi.io/docs). ## Questions Can I get contractor emails from the Entity API?Not with a non-federal account. POC email and phone are FOUO. Contacts printed in public opportunity notices are public. ## Related - [SAM.gov API](https://samgovapi.io/sam-gov-api) - [Entity extracts API](https://samgovapi.io/sam-gov-entity-extracts-api) - [UEI lookup API](https://samgovapi.io/uei-lookup-api) - [CAGE code API](https://samgovapi.io/cage-code-api)Updated 2026-11-12. Sources checked 2026-11-12.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/sam-gov-entity-api . Markdown: https://samgovapi.io/sam-gov-entity-api.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