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

# Exclusões do SAM.gov

> Toda parte excluída de contratos, subvenções e programas federais dos Estados Unidos: pessoas, empresas, clínicas e farmácias inabilitadas ou suspensas pelo HHS, OPM, DOJ, EPA e cerca de cinquenta outras agências. Busque por nome, agência, tipo de exclusão, estado, Unique Entity ID, código CAGE ou NPI, e leia o registro completo de uma exclusão.

O SAM.gov é onde o governo dos Estados Unidos registra as entidades que paga
e as que não pode pagar. As agências federais registram ali cada exclusão: o
Departamento de Saúde exclui prestadores do Medicare e do Medicaid, o Office of
Personnel Management dos planos de saúde dos servidores federais, e o
Departamento de Justiça, a EPA, o HUD, as forças armadas e cerca de cinquenta
outras agências inabilitam ou suspendem contratados e beneficiários. Uma parte
excluída não pode receber contratos, subvenções nem pagamentos de programas
federais.

Todas as exclusões vigentes, cerca de 168.000: perto de 133.000 pessoas, 8.300
empresas, 25.600 outras entidades, como clínicas e farmácias, e 1.300
embarcações. Cada uma traz o
nome da parte, sua cidade e estado, seu Unique Entity ID, código CAGE ou
National Provider Identifier quando o tem, a agência que excluiu, o tipo de
exclusão e suas datas. Atualizado todos os dias.

O SAM.gov também traz a lista de sanções da OFAC do Tesouro, uma linha por nome
e alias, sob a agência `OFAC` (cerca de 42.000 linhas); sua cópia fica atrás da
da OFAC. Para as sanções vigentes use
[sanções OFAC](/pt/guides/united-states/ofac) ou a
[Consolidated Screening List](/pt/guides/united-states/csl).

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar exclusões

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

Busca em todas as exclusões vigentes por qualquer combinação de nome,
classificação, agência, tipo de exclusão, estado, identificador e data.

| Campo            | Tipo    | Notas                                                                                                                                                |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Opcional. Palavras do nome da parte: o nome de uma entidade, ou o nome, nome do meio e sobrenome de uma pessoa. Todas devem coincidir; sem stemming. |
| `classification` | enum    | Opcional. `individual`, `firm`, `special_entity_designation` (uma entidade que não é uma empresa, como uma clínica ou farmácia) ou `vessel`.         |
| `agency`         | string  | Opcional. A sigla da agência que excluiu, p. ex. `HHS`, `OPM`, `DOJ`, `EPA`, `HUD`, `DLA`.                                                           |
| `exclusion_type` | enum    | Opcional. `prohibition_restriction`, `ineligible_proceedings_completed`, `ineligible_proceedings_pending` ou `voluntary_exclusion`.                  |
| `state`          | string  | Opcional. O estado ou província, o código de duas letras para um estado dos EUA, p. ex. `FL`.                                                        |
| `uei`            | string  | Opcional. O Unique Entity ID da parte, doze letras e dígitos.                                                                                        |
| `cage`           | string  | Opcional. O código CAGE da parte, cinco letras e dígitos.                                                                                            |
| `npi`            | string  | Opcional. O National Provider Identifier de dez dígitos de um prestador de saúde.                                                                    |
| `from_date`      | string  | Opcional. Data mais antiga em que a exclusão entrou em vigor, yyyy-mm-dd.                                                                            |
| `to_date`        | string  | Opcional. Data mais recente em que a exclusão entrou em vigor, yyyy-mm-dd.                                                                           |
| `page`           | integer | Opcional. Página, começa em 1. Por padrão `1`.                                                                                                       |
| `per_page`       | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `exclusions[]`, por nome.

Cada exclusão traz `id` (o número do SAM.gov para o registro, a chave), `classification` (`individual`, `firm`, `special_entity_designation` ou `vessel`), `name`, o `prefix`, `first_name`, `middle_name`, `last_name` e `suffix` de uma pessoa, `address_1`, `address_2`, `city`, `state`, `zip_code`, `country` (três letras, p. ex. `USA`), `uei` (Unique Entity ID), `cage`, `npi` (National Provider Identifier), `exclusion_program` (`Reciprocal`, `Procurement` ou `NonProcurement`), `excluding_agency`, `ct_code`, `exclusion_type`, `comments` (a nota da agência), `cross_reference` (outros nomes e partes relacionadas), `active_date`, `termination_date` (null quando é `indefinite`), `indefinite`, `record_status` e `updated_date`.

Os campos vazios são `null`. O SAM.gov não publica o endereço de uma pessoa.

<Note>
  A lista traz as exclusões vigentes. Atualizado diariamente; uma exclusão que
  termina deixa de aparecer.
</Note>

<Warning>
  Uma coincidência de nome é um ponto de partida, não uma determinação.
  Confirme o resultado com o Unique Entity ID, o código CAGE, o NPI ou a
  localização da parte antes de agir: muitas pessoas excluídas compartilham
  nomes comuns.
</Warning>

## Uma exclusão

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

Resolve uma exclusão pelo seu número SAM e retorna o registro completo.

| Campo | Tipo   | Notas                                                                          |
| ----- | ------ | ------------------------------------------------------------------------------ |
| `id`  | string | **Obrigatório.** O número SAM da exclusão, um UUID, como retornado pela busca. |

```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" }'
```

Retorna `found`, `id`, `as_of` e `exclusion` (null quando não encontrado).

Cada exclusão traz `id` (o número do SAM.gov para o registro, a chave), `classification` (`individual`, `firm`, `special_entity_designation` ou `vessel`), `name`, o `prefix`, `first_name`, `middle_name`, `last_name` e `suffix` de uma pessoa, `address_1`, `address_2`, `city`, `state`, `zip_code`, `country` (três letras, p. ex. `USA`), `uei` (Unique Entity ID), `cage`, `npi` (National Provider Identifier), `exclusion_program` (`Reciprocal`, `Procurement` ou `NonProcurement`), `excluding_agency`, `ct_code`, `exclusion_type`, `comments` (a nota da agência), `cross_reference` (outros nomes e partes relacionadas), `active_date`, `termination_date` (null quando é `indefinite`), `indefinite`, `record_status` e `updated_date`.

Os campos vazios são `null`. O SAM.gov não publica o endereço de uma pessoa.

<Note>
  Um id que a lista não registra retorna `found: false` com HTTP 200, não um
  erro. Essa é também a resposta para uma exclusão que terminou.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>
