Exclusions

Search Excluded Entities

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

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

Query parameters

entity_namestring nullable

Entity or person name (partial match)

namestring nullable

Alias for entity_name (accepted for backwards compatibility)

qstring 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_samstring nullable

UEI SAM identifier

ueistring nullable

Alias for uei_sam (the canonical name on every other endpoint)

cage_codestring 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_agencystring nullable

Excluding agency code or name substring (e.g., 'DOD', or 'DEFENSE LOGISTICS')

classification_typestring nullable

Classification: Individual, Firm, Vessel, Special Entity Designation. Case-insensitive; an unknown value returns 400 with the valid list.

exclusion_typestring 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.

statestring nullable

State/province code

countrystring 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_onlyboolean

Only show currently active exclusions

limitinteger

Results per page. Default 100; maximum 100 on the free trial and 1,000 on paid plans.

offsetinteger

Pagination offset

fieldsstring 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

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.