> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exclusiones de SAM.gov

> Toda parte excluida de contratos, subvenciones y programas federales de Estados Unidos: personas, empresas, clínicas y farmacias inhabilitadas o suspendidas por HHS, OPM, DOJ, EPA y unas cincuenta agencias más. Busca por nombre, agencia, tipo de exclusión, estado, Unique Entity ID, código CAGE o NPI, y lee el registro completo de una exclusión.

SAM.gov es donde el gobierno de Estados Unidos registra a las entidades a las
que paga y a las que no puede pagar. Las agencias federales registran ahí cada
exclusión: el Departamento de Salud excluye proveedores de Medicare y Medicaid,
la Office of Personnel Management de los seguros de salud de los empleados
federales, y el Departamento de Justicia, la EPA, HUD, las fuerzas armadas y
unas cincuenta agencias más inhabilitan o suspenden contratistas y
beneficiarios. Una parte excluida no puede recibir contratos, subvenciones ni
pagos de programas federales.

Todas las exclusiones vigentes, unas 168.000: cerca de 133.000 personas, 8.300
empresas, 25.600 entidades más, como clínicas y farmacias, y 1.300 buques. Cada una trae el
nombre de la parte, su ciudad y estado, su Unique Entity ID, código CAGE o
National Provider Identifier cuando lo tiene, la agencia que excluyó, el tipo
de exclusión y sus fechas. Se actualiza cada día.

SAM.gov también trae la lista de sanciones de la OFAC del Tesoro, una fila por
nombre y alias, bajo la agencia `OFAC` (unas 42.000 filas); su copia va detrás
de la de la OFAC. Para las sanciones vigentes usa
[sanciones OFAC](/es/guides/united-states/ofac) o la
[Consolidated Screening List](/es/guides/united-states/csl).

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar exclusiones

`POST /us/sam/exclusions-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Busca en todas las exclusiones vigentes por cualquier combinación de nombre,
clasificación, agencia, tipo de exclusión, estado, identificador y fecha.

| Campo            | Tipo    | Notas                                                                                                                                                                |
| ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Opcional. Palabras del nombre de la parte: el nombre de una entidad, o el nombre, segundo nombre y apellido de una persona. Todas deben coincidir; sin lematización. |
| `classification` | enum    | Opcional. `individual`, `firm`, `special_entity_designation` (una entidad que no es una empresa, como una clínica o farmacia) o `vessel`.                            |
| `agency`         | string  | Opcional. La sigla de la agencia que excluyó, p. ej. `HHS`, `OPM`, `DOJ`, `EPA`, `HUD`, `DLA`.                                                                       |
| `exclusion_type` | enum    | Opcional. `prohibition_restriction`, `ineligible_proceedings_completed`, `ineligible_proceedings_pending` o `voluntary_exclusion`.                                   |
| `state`          | string  | Opcional. El estado o provincia, el código de dos letras para un estado de EE. UU., p. ej. `FL`.                                                                     |
| `uei`            | string  | Opcional. El Unique Entity ID de la parte, doce letras y dígitos.                                                                                                    |
| `cage`           | string  | Opcional. El código CAGE de la parte, cinco letras y dígitos.                                                                                                        |
| `npi`            | string  | Opcional. El National Provider Identifier de diez dígitos de un proveedor de salud.                                                                                  |
| `from_date`      | string  | Opcional. Fecha más temprana en que la exclusión entró en vigor, yyyy-mm-dd.                                                                                         |
| `to_date`        | string  | Opcional. Fecha más tardía en que la exclusión entró en vigor, yyyy-mm-dd.                                                                                           |
| `page`           | integer | Opcional. Página, empieza en 1. Por defecto `1`.                                                                                                                     |
| `per_page`       | integer | Opcional. Resultados por página, 1-50. Por defecto `20`.                                                                                                             |

```bash theme={"dark"}
curl https://api.croma.run/us/sam/exclusions-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pharmacy", "agency": "HHS" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `exclusions[]`, por nombre.

Cada exclusión incluye `id` (el número de SAM.gov para el registro, la clave), `classification` (`individual`, `firm`, `special_entity_designation` o `vessel`), `name`, el `prefix`, `first_name`, `middle_name`, `last_name` y `suffix` de una persona, `address_1`, `address_2`, `city`, `state`, `zip_code`, `country` (tres letras, p. ej. `USA`), `uei` (Unique Entity ID), `cage`, `npi` (National Provider Identifier), `exclusion_program` (`Reciprocal`, `Procurement` o `NonProcurement`), `excluding_agency`, `ct_code`, `exclusion_type`, `comments` (la nota de la agencia), `cross_reference` (otros nombres y partes relacionadas), `active_date`, `termination_date` (null cuando es `indefinite`), `indefinite`, `record_status` y `updated_date`.

Los campos vacíos son `null`. SAM.gov no publica la dirección de una persona.

<Note>
  La lista trae las exclusiones vigentes. Se actualiza a diario; una exclusión
  que termina deja de aparecer.
</Note>

<Warning>
  Una coincidencia de nombre es un punto de partida, no una determinación.
  Confirma el resultado contra el Unique Entity ID, el código CAGE, el NPI o la
  ubicación de la parte antes de actuar: muchas personas excluidas comparten
  nombres comunes.
</Warning>

## Una exclusión

`POST /us/sam/exclusion/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Resuelve una exclusión por su número SAM y devuelve el registro completo.

| Campo | Tipo   | Notas                                                                                  |
| ----- | ------ | -------------------------------------------------------------------------------------- |
| `id`  | string | **Obligatorio.** El número SAM de la exclusión, un UUID, como lo devuelve la búsqueda. |

```bash theme={"dark"}
curl https://api.croma.run/us/sam/exclusion/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "c11dcac9-e974-4e97-9350-077d697b8909" }'
```

Devuelve `found`, `id`, `as_of` y `exclusion` (null cuando no se encuentra).

Cada exclusión incluye `id` (el número de SAM.gov para el registro, la clave), `classification` (`individual`, `firm`, `special_entity_designation` o `vessel`), `name`, el `prefix`, `first_name`, `middle_name`, `last_name` y `suffix` de una persona, `address_1`, `address_2`, `city`, `state`, `zip_code`, `country` (tres letras, p. ej. `USA`), `uei` (Unique Entity ID), `cage`, `npi` (National Provider Identifier), `exclusion_program` (`Reciprocal`, `Procurement` o `NonProcurement`), `excluding_agency`, `ct_code`, `exclusion_type`, `comments` (la nota de la agencia), `cross_reference` (otros nombres y partes relacionadas), `active_date`, `termination_date` (null cuando es `indefinite`), `indefinite`, `record_status` y `updated_date`.

Los campos vacíos son `null`. SAM.gov no publica la dirección de una persona.

<Note>
  Un id que la lista no registra devuelve `found: false` con HTTP 200, no un
  error. Esa es también la respuesta para una exclusión que terminó.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>
