---
title: "Search Excluded Entities"
method: GET
path: "/api/v1/exclusions/search"
tags: ["Exclusions"]
---

# Search Excluded Entities

`GET /api/v1/exclusions/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/exclusions/search`
- Auth: HTTP bearer

Search SAM.gov exclusions database for debarred entities. Search by name, UEI, CAGE code, agency, or location.

## Query parameters

- `entity_name` string, nullable: Entity or person name (partial match)
- `name` string, nullable: Alias for entity_name (accepted for backwards compatibility)
- `q` string, nullable: Alias for entity_name. Same name-search param as /entities/search and /companies/search, so a screening script can reuse it across endpoints.
- `uei_sam` string, nullable: UEI SAM identifier
- `uei` string, nullable: Alias for uei_sam (the canonical name on every other endpoint)
- `cage_code` string, nullable: CAGE code. Note: only ~0.3% of exclusion records carry one, so an empty result here means the field is absent, not that the entity is clear.
- `excluding_agency` string, nullable: Excluding agency code or name substring (e.g., 'DOD', or 'DEFENSE LOGISTICS')
- `classification_type` string, nullable: Classification: Individual, Firm, Vessel, Special Entity Designation. Case-insensitive; an unknown value returns 400 with the valid list.
- `exclusion_type` string, nullable: Type: Prohibition/Restriction, Ineligible (Proceedings Completed), Ineligible (Proceedings Pending), Voluntary Exclusion. Case-insensitive; an unknown value returns 400 with the valid list. SAM stores both 'Proceedings Complete' and 'Proceedings Completed'; either input matches both.
- `state` string, nullable: State/province code
- `country` string, nullable: Country code. Unreliable for the sanctioned (OFAC) slice, where SAM codes many foreign entities as US or as the non-ISO bucket XUN, so a country filter can return a false-negative subset. Do not rely on it for sanctions screening.
- `active_only` boolean: Only show currently active exclusions
- `limit` integer: Results per page. Default 100; maximum 100 on the free trial and 1,000 on paid plans.
- `offset` integer: Pagination offset
- `fields` string, nullable: Comma-separated response fields to return. `uei_sam` always included. Example: `fields=entity_name,uei_sam,excluding_agency_code,activate_date`. Omit to return all fields (default).

## 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)