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

# Oportunidades de contratação do SAM.gov

> Toda oportunidade de contratação que as agências federais dos Estados Unidos mantêm ativa no SAM.gov: solicitações de propostas, pesquisas de fontes, pré-solicitações, avisos especiais e adjudicações de todas as agências, cerca de 75.000. Busque por palavras, tipo de aviso, agência, código NAICS ou PSC, set-aside, estado e prazo, e leia um aviso completo.

O SAM.gov é onde as agências federais dos Estados Unidos publicam suas
oportunidades de contratação: toda ação contratual prevista acima de 25.000
dólares, do aviso de pesquisa de fontes à solicitação de propostas e à
adjudicação. Todas as agências publicam ali: o Departamento de Defesa e suas
forças, a General Services Administration, Assuntos de Veteranos, Agricultura,
Interior, Segurança Interna, Justiça, Estado, Saúde, a NASA, Energia e as
demais.

Todos os avisos que o SAM.gov mantém ativos, cerca de 75.000: perto de 23.000
sinopses e solicitações combinadas, 19.000 solicitações de propostas, 14.000
avisos de adjudicação, 7.000 pré-solicitações, 5.000 avisos especiais e 5.000
pesquisas de fontes. Cada um traz seu título e seu texto, o número de
solicitação, o departamento, a agência e o escritório que o publicou, os
códigos NAICS e PSC, o set-aside, o prazo de resposta, o local de execução, os
contatos e, para uma adjudicação, o contratado, o valor e a data. Atualizado
todos os dias; um aviso que o SAM.gov arquiva sai da lista.

Busque primeiro e depois leia um aviso completo. Para as partes impedidas de
contratar com o governo federal veja
[Exclusões do SAM.gov](/pt/guides/united-states/sam).

<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 oportunidades

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

Busca em todos os avisos ativos por qualquer combinação de palavras, tipo de
aviso, número de solicitação, agência, códigos, set-aside, estado e data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Opcional. Palavras do título, do texto, do adjudicatário ou do número de solicitação do aviso. Todas devem coincidir; com stemming em inglês (`services` encontra `service`). |
| `type` | enum | Opcional. `solicitation`, `combined_synopsis_solicitation`, `presolicitation`, `sources_sought`, `special_notice`, `award_notice`, `justification`, `justification_and_approval`, `modification`, `sale_of_surplus_property` ou `consolidate_bundle`. |
| `solicitation_number` | string | Opcional. O número de solicitação, como a agência escreveu, p. ex. `W912HN25B0012`. Não distingue maiúsculas. |
| `department` | string | Opcional. O departamento ou agência independente, como o SAM.gov escreve, p. ex. `DEPT OF DEFENSE`, `VETERANS AFFAIRS, DEPARTMENT OF`, `GENERAL SERVICES ADMINISTRATION`. Não distingue maiúsculas. |
| `sub_tier` | string | Opcional. A agência dentro do departamento, como o SAM.gov escreve, p. ex. `DEPT OF THE ARMY`, `DEFENSE LOGISTICS AGENCY`, `FOREST SERVICE`. Não distingue maiúsculas. |
| `naics_code` | string | Opcional. Um código NAICS, de dois a seis dígitos. Um código curto abrange todos os que começam por ele: `23` é toda a construção, `541512` o projeto de sistemas de computação. |
| `classification_code` | string | Opcional. Um código PSC, de um a quatro caracteres. Um código curto abrange todos os que começam por ele: `D` são os serviços de TI, `D302` o desenvolvimento de sistemas. |
| `set_aside` | string | Opcional. O código de set-aside, p. ex. `SBA` (reservado a pequenas empresas), `SBP` (parcial), `SDVOSBC` (veteranos com deficiência), `WOSB` (empresas de mulheres), `8A`, `HZC` (HUBZone), ou `NONE` para avisos que declaram não ter set-aside. |
| `performance_state` | string | Opcional. O código de duas letras do estado do local de execução, p. ex. `VA`. Declarado em cerca de um quarto dos avisos. |
| `office_state` | string | Opcional. O código de duas letras do estado do escritório contratante, p. ex. `PA`. |
| `from_date` | string | Opcional. Data de publicação mais antiga, yyyy-mm-dd. |
| `to_date` | string | Opcional. Data de publicação mais recente, yyyy-mm-dd. |
| `deadline_from` | string | Opcional. Prazo de resposta mais cedo, yyyy-mm-dd. A data de hoje para os avisos ainda abertos. |
| `deadline_to` | string | Opcional. Prazo de resposta mais tarde, yyyy-mm-dd. |
| `sort` | enum | Opcional. `recent` (publicação mais recente primeiro, o padrão), `deadline` (prazo de resposta mais próximo primeiro, sem prazo por último) ou `amount_desc` (maior adjudicação primeiro). Por padrão `recent`. |
| `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/opportunities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "cybersecurity", "type": "sources_sought" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `sort`, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `opportunities[]`.

Cada aviso traz `id` (o id do aviso no SAM.gov, a chave), `title`, `solicitation_number`, `type` (o tipo de aviso atual: `Solicitation`, `Combined Synopsis/Solicitation`, `Presolicitation`, `Sources Sought`, `Special Notice`, `Award Notice`, `Justification`, `Justification and Approval (J&A)`, `Modification/Amendment/Cancel`, `Sale of Surplus Property` ou `Consolidate/(Substantially) Bundle`), `base_type` (o tipo com que foi publicado), `department`, `department_code` (CGAC), `sub_tier`, `agency_code` (FPDS), `office`, `office_code` (AAC), `organization_type`, `posted_date` e `posted_at`, `response_deadline` (como o SAM.gov escreve, normalmente com o fuso UTC do escritório) e `response_deadline_date`, `archive_type` e `archive_date`, `set_aside_code` e `set_aside`, `naics_code`, `classification_code` (PSC), o local de execução (`performance_street`, `performance_city`, `performance_state`, `performance_zip`, `performance_country`), para uma adjudicação `award_number`, `award_date`, `award_amount` (dólares) e `awardee`, `primary_contact` e `secondary_contact` (cada um com `title`, `name`, `email`, `phone`, `fax`), o endereço do escritório contratante (`office_city`, `office_state`, `office_zip`, `office_country`), `active`, `description` (o texto do aviso, que o SAM.gov corta em cerca de 32.000 caracteres), `additional_info_url` e `source_url` (o aviso no SAM.gov).

Os campos vazios são `null`.

<Note>
  A lista traz os avisos que o SAM.gov mostra como ativos. Atualizado
  diariamente; um aviso que o SAM.gov arquiva deixa de aparecer.
</Note>

## Uma oportunidade

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

Resolve um aviso pelo seu id no SAM.gov e retorna o registro completo.

| Campo | Tipo | Notas |
| - | - | - |
| `id` | string | **Obrigatório.** O id do aviso no SAM.gov, 32 caracteres hexadecimais, como retornado pela busca ou como aparece na URL do aviso no SAM.gov. |

```bash theme={"dark"}
curl https://api.croma.run/us/sam/opportunity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "c3ade85bb7aa4603aee667173d4eb588" }'
```

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

Cada aviso traz `id` (o id do aviso no SAM.gov, a chave), `title`, `solicitation_number`, `type` (o tipo de aviso atual: `Solicitation`, `Combined Synopsis/Solicitation`, `Presolicitation`, `Sources Sought`, `Special Notice`, `Award Notice`, `Justification`, `Justification and Approval (J&A)`, `Modification/Amendment/Cancel`, `Sale of Surplus Property` ou `Consolidate/(Substantially) Bundle`), `base_type` (o tipo com que foi publicado), `department`, `department_code` (CGAC), `sub_tier`, `agency_code` (FPDS), `office`, `office_code` (AAC), `organization_type`, `posted_date` e `posted_at`, `response_deadline` (como o SAM.gov escreve, normalmente com o fuso UTC do escritório) e `response_deadline_date`, `archive_type` e `archive_date`, `set_aside_code` e `set_aside`, `naics_code`, `classification_code` (PSC), o local de execução (`performance_street`, `performance_city`, `performance_state`, `performance_zip`, `performance_country`), para uma adjudicação `award_number`, `award_date`, `award_amount` (dólares) e `awardee`, `primary_contact` e `secondary_contact` (cada um com `title`, `name`, `email`, `phone`, `fax`), o endereço do escritório contratante (`office_city`, `office_state`, `office_zip`, `office_country`), `active`, `description` (o texto do aviso, que o SAM.gov corta em cerca de 32.000 caracteres), `additional_info_url` e `source_url` (o aviso no SAM.gov).

Os campos vazios são `null`.

<Note>
  Um id que a lista ativa não registra retorna `found: false` com HTTP 200,
  não um erro. Essa é também a resposta para um aviso que o SAM.gov arquivou.
</Note>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.