Skip to main content
POST
Search SAM.gov entity registrations

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string

A company name or keyword phrase. Supports spelling variations and known public aliases.

Required string length: 1 - 200
uei
string

Match an exact SAM Unique Entity Identifier.

Pattern: ^[A-Z0-9]{12}$
cageCodes
string[]

Match the CAGE code on the registration.

Required array length: 1 - 100 elements
Pattern: ^[A-Z0-9]{5}$
states
string[]

Two-letter U.S. state codes for the physical address, such as CA for California.

Required array length: 1 - 100 elements
Pattern: ^[A-Z]{2}$
naics
string[]

Match codes anywhere on the registration, including its primary NAICS.

Required array length: 1 - 100 elements
Pattern: ^[0-9]{6}$
psc
string[]

Match listed Product Service Codes.

Required array length: 1 - 100 elements
Pattern: ^[A-Z0-9]{4}$
websiteDomain
string

Match an exact website host from SAM or SBA, such as example.com. Case, a leading www. and a trailing dot are ignored.

includeHistorical
boolean
default:false

Include expired registrations and registrations missing from the latest extract. Current matches are favored.

sbaCertification
enum<string>

Use any for at least one reported SBA certification. For a specific program, use A0 for EDWOSB, A4 for SBA-certified Small Disadvantaged Business, A6 for 8(a), A9 for WOSB, JT for an 8(a) joint venture, or XX for HUBZone. Certifications with a known past expiration are excluded. Only entries with a valid expiry or an omitted expiry qualify.

Available options:
any,
A0,
A4,
A6,
A9,
JT,
XX
perPage
integer
default:25
Required range: 1 <= x <= 100
cursor
string

Copy meta.nextCursor with the same filters to fetch the next page. Restart without a cursor when the API returns a cursor error.

Minimum string length: 1

Response

Matching SAM registrations ordered by relevance with query, registration ID with websiteDomain alone, or otherwise by UEI and EFT indicator. Historical searches favor current matches.

data
object[]
required
meta
object
required