---
title: "Search SAM entities by name and filters (every plan)"
method: GET
path: "/api/v1/entities/search"
tags: ["Entities"]
---

# Search SAM entities by name and filters (every plan)

`GET /api/v1/entities/search`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/entities/search`
- Auth: HTTP bearer

Filter-based entity search.

Every plan, including the free trial: combine `q` (name substring,
trigram-indexed) with `naics` / `state` / `business_type` / `active_only`
/ `naics_small` as needed.

At least one of `q` / `naics` / `state` / `business_type` / `active_only`
must be provided. NAICS values omit the Y/N small-business suffix (we
match either flag).

`business_type` accepts SAM 2-3 char codes like `8W` (WOSB), `QF`
(SDVOSB), `27` (Self-Cert SDB), `2X` (For Profit), etc. An unknown code
returns 400 listing every valid code. Note: SBA-certified codes
(A6, XX, JT, A4) are valid but appear ~zero times in the Public V2 SAM extract.

## Query parameters

- `q` string, nullable: Name substring
- `naics` string, nullable: NAICS code, no Y/N suffix
- `state` string, nullable: 2-letter US state
- `business_type` string, nullable: SAM business-type code, e.g. 8W (WOSB), QF (SDVOSB), 27 (self-cert SDB). An unknown code returns 400 with the full valid list.
- `active_only` boolean: Only Active registrations
- `naics_small` string, nullable: Firms SMALL for this NAICS per SBA DSBS. SBA's authoritative small-business determination, distinct from SAM's self-reported per-NAICS flag.
- `limit` integer
- `offset` integer
- `fields` string, nullable: Comma-separated response fields. `uei` always included. Example: `fields=uei,legal_business_name,primary_naics`.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)