# Entities The entities endpoints return SAM.gov registrations by UEI or CAGE code, or search them by name, NAICS, PSC, state, business type and days to expiry. Every row carries source and as_of fields with the extract date, and POC email, phone and legacy D&B fields are never returned.Checked on 2026-11-12.Official source: [open.gsa.gov Entity Management API](https://open.gsa.gov/api/entity-api/) | Get | /entities/{uei} | | --- | --- | | By CAGE | /cage/{cage} | | Search | /entities?q=%7Bname%7D | | Never returned | POC email, phone, fax; legacy D&B fields | ## Filters - q: name, UEI or CAGE - naics, psc, state - business_type (SAM.gov business type code) - status: active or expired - expiring_within_days ## Example ``` curl "https://samgovapi.io/api/v1/entities/ABCDEFGH1234" \ -H "Authorization: Bearer sg_YOUR_KEY" ``` ## Search parameters | Parameter | Meaning | | --- | --- | | q | Legal or DBA name, UEI or CAGE | | naics | 6-digit NAICS code the entity lists, for example 541512 | | psc | PSC code the entity lists | | state | 2-letter state of the physical address | | set_aside | Business type or SBA program code, such as 8A or A2 | | business_type | SAM.gov business type code | | status | active or expired | | expiring_within_days | Registrations that expire within this many days | | limit, cursor | Page size up to 100, and the next_cursor of the previous page | ## Related endpoints | Endpoint | Returns | Credits | | --- | --- | --- | | /api/v1/entities/{uei} | One entity by UEI | lookup | | /api/v1/cage/{cage} | One entity by CAGE code | lookup | | /api/v1/registration-status/{id} | Status, expiry and exclusion flag for a UEI or CAGE | lookup | | /api/v1/entities/{uei}/awards | Award history for one entity | history (3x) | ## 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). ## Related - [Fields](https://samgovapi.io/docs/fields) - [Entity API](https://samgovapi.io/sam-gov-entity-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/docs/entities . Markdown: https://samgovapi.io/docs/entities.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