---
title: "SAM.gov Exclusion"
method: POST
path: "/us/sam/exclusion/v1"
tags: ["United States", "SAM.gov"]
---

# SAM.gov Exclusion

`POST /us/sam/exclusion/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/sam/exclusion/v1`
- Auth: HTTP bearer

Resolve one exclusion from US federal awards and programs by its SAM number and return the full record: the party, its identifiers, the excluding agency, the kind of exclusion, its dates and the agency's note. `found: false` when the list does not carry that id. Served by Croma (`as_of` says how current the data is), brought up to date daily.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `id` string, required: Número SAM de la exclusión, como lo devuelve la búsqueda.

## Response `200`

Successful response

- SamExclusionResponse
  - `data` SamExclusionData, required
    - `found` boolean, required
    - `id` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `exclusion` object, nullable, required
      - `id` string, required: SAM.gov's number for the exclusion record (a UUID), stable across the record's changes. The key.
      - `classification` 'individual' | 'firm' | 'special_entity_designation' | 'vessel', required: `individual`, `firm`, `special_entity_designation` (an entity other than a firm, e.g. a clinic or pharmacy excluded by name) or `vessel`.
      - `name` string, required: The excluded party's name: the entity's name, or a person's first, middle and last name and suffix.
      - `prefix` string, nullable, required: A person's prefix, e.g. `Dr.`
      - `first_name` string, nullable, required
      - `middle_name` string, nullable, required
      - `last_name` string, nullable, required
      - `suffix` string, nullable, required
      - `address_1` string, nullable, required: The street address. SAM.gov publishes none for a person.
      - `address_2` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required: The state or province: the two-letter code for a US state.
      - `zip_code` string, nullable, required
      - `country` string, nullable, required: A three-letter country code, e.g. `USA`, `CAN`, `MEX`.
      - `uei` string, nullable, required: The party's Unique Entity ID in SAM.gov, when it has one.
      - `cage` string, nullable, required: The party's CAGE code, when it has one.
      - `npi` string, nullable, required: A health care provider's National Provider Identifier, when recorded.
      - `exclusion_program` string, nullable, required: `Reciprocal` (excluded from both procurement and non-procurement awards), `Procurement` or `NonProcurement`.
      - `excluding_agency` string, nullable, required: The agency that excluded the party, by its code, e.g. `HHS`, `OPM`, `DOJ`, `EPA`, `DLA`; `OFAC` for SAM.gov's copy of the Treasury's sanctions list.
      - `ct_code` string, nullable, required: The cause and treatment code SAM.gov records for the exclusion, e.g. `Z1`, `R`.
      - `exclusion_type` string, nullable, required: `Prohibition/Restriction`, `Ineligible (Proceedings Completed)`, `Ineligible (Proceedings Pending)` or `Voluntary Exclusion`.
      - `comments` string, nullable, required: The excluding agency's note: the authority, the scope, sometimes the names the party also traded under.
      - `cross_reference` string, nullable, required: Other names and related parties the agency links to the exclusion.
      - `active_date` string, nullable, required: When the exclusion took effect (yyyy-mm-dd).
      - `termination_date` string, nullable, required: When the exclusion ends (yyyy-mm-dd); null when it is indefinite.
      - `indefinite` boolean, required: Whether the exclusion has no end date.
      - `record_status` string, nullable, required
      - `updated_date` string, nullable, required: When SAM.gov last created or changed the record (yyyy-mm-dd).

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)