Oportunidades de contratação do SAM.gov

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.

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.

Buscar oportunidades

POST /us/sam/opportunities-search/v1 Dataset 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`.

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.

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

Uma oportunidade

POST /us/sam/opportunity/v1 Dataset 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.

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.

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.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Países

Oportunidades de contratação do SAM.gov

Buscar oportunidades

Uma oportunidade

Referência completa

​Buscar oportunidades

​Uma oportunidade

Referência completa

Buscar oportunidades

Uma oportunidade