Oportunidades de contratación de SAM.gov

SAM.gov es donde las agencias federales de Estados Unidos publican sus oportunidades de contratación: toda acción contractual prevista por más de 25.000 dólares, desde el aviso de búsqueda de fuentes hasta la solicitud de ofertas y la adjudicación. Todas las agencias publican ahí: el Departamento de Defensa y sus fuerzas, la General Services Administration, Asuntos de Veteranos, Agricultura, Interior, Seguridad Nacional, Justicia, Estado, Salud, la NASA, Energía y las demás. Todos los avisos que SAM.gov tiene activos, unos 75.000: cerca de 23.000 sinopsis y solicitudes combinadas, 19.000 solicitudes de ofertas, 14.000 avisos de adjudicación, 7.000 presolicitudes, 5.000 avisos especiales y 5.000 búsquedas de fuentes. Cada uno trae su título y su texto, el número de solicitud, el departamento, la agencia y la oficina que lo publicó, los códigos NAICS y PSC, el set-aside, el plazo de respuesta, el lugar de ejecución, los contactos y, para una adjudicación, el contratista, el monto y la fecha. Se actualiza cada día; un aviso que SAM.gov archiva sale de la lista. Busca primero y luego lee un aviso completo. Para las partes inhabilitadas para contratar con el gobierno federal ve a Exclusiones de SAM.gov.

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.

Buscar oportunidades

POST /us/sam/opportunities-search/v1 Dataset Busca en todos los avisos activos por cualquier combinación de palabras, tipo de aviso, número de solicitud, agencia, códigos, set-aside, estado y fecha.

Campo	Tipo	Notas
`query`	string	Opcional. Palabras del título, el texto, el adjudicatario o el número de solicitud del aviso. Todas deben coincidir; con lematización en inglés (`services` encuentra `service`).
`type`	enum	Opcional. `solicitation`, `combined_synopsis_solicitation`, `presolicitation`, `sources_sought`, `special_notice`, `award_notice`, `justification`, `justification_and_approval`, `modification`, `sale_of_surplus_property` o `consolidate_bundle`.
`solicitation_number`	string	Opcional. El número de solicitud, tal como lo escribió la agencia, p. ej. `W912HN25B0012`. No distingue mayúsculas.
`department`	string	Opcional. El departamento o agencia independiente, tal como lo escribe SAM.gov, p. ej. `DEPT OF DEFENSE`, `VETERANS AFFAIRS, DEPARTMENT OF`, `GENERAL SERVICES ADMINISTRATION`. No distingue mayúsculas.
`sub_tier`	string	Opcional. La agencia dentro del departamento, tal como la escribe SAM.gov, p. ej. `DEPT OF THE ARMY`, `DEFENSE LOGISTICS AGENCY`, `FOREST SERVICE`. No distingue mayúsculas.
`naics_code`	string	Opcional. Un código NAICS, de dos a seis dígitos. Un código corto abarca todos los que empiezan por él: `23` es toda la construcción, `541512` el diseño de sistemas informáticos.
`classification_code`	string	Opcional. Un código PSC, de uno a cuatro caracteres. Un código corto abarca todos los que empiezan por él: `D` son los servicios de TI, `D302` el desarrollo de sistemas.
`set_aside`	string	Opcional. El código de set-aside, p. ej. `SBA` (reservado a pequeñas empresas), `SBP` (parcial), `SDVOSBC` (veteranos con discapacidad), `WOSB` (empresas de mujeres), `8A`, `HZC` (HUBZone), o `NONE` para los avisos que declaran no tener set-aside.
`performance_state`	string	Opcional. El código de dos letras del estado del lugar de ejecución, p. ej. `VA`. Lo declara cerca de una cuarta parte de los avisos.
`office_state`	string	Opcional. El código de dos letras del estado de la oficina contratante, p. ej. `PA`.
`from_date`	string	Opcional. Fecha de publicación más temprana, yyyy-mm-dd.
`to_date`	string	Opcional. Fecha de publicación más tardía, yyyy-mm-dd.
`deadline_from`	string	Opcional. Plazo de respuesta más temprano, yyyy-mm-dd. La fecha de hoy para los avisos aún abiertos.
`deadline_to`	string	Opcional. Plazo de respuesta más tardío, yyyy-mm-dd.
`sort`	enum	Opcional. `recent` (publicación más reciente primero, por defecto), `deadline` (plazo de respuesta más próximo primero, sin plazo al final) o `amount_desc` (mayor adjudicación primero). Por defecto `recent`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-50. Por defecto `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" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, sort, total y total_is_exact, page, per_page, total_pages, count y opportunities[]. Cada aviso incluye id (el id del aviso en SAM.gov, la clave), title, solicitation_number, type (el tipo de aviso actual: Solicitation, Combined Synopsis/Solicitation, Presolicitation, Sources Sought, Special Notice, Award Notice, Justification, Justification and Approval (J&A), Modification/Amendment/Cancel, Sale of Surplus Property o Consolidate/(Substantially) Bundle), base_type (el tipo con el que se publicó), department, department_code (CGAC), sub_tier, agency_code (FPDS), office, office_code (AAC), organization_type, posted_date y posted_at, response_deadline (como lo escribe SAM.gov, normalmente con el desfase UTC de la oficina) y response_deadline_date, archive_type y archive_date, set_aside_code y set_aside, naics_code, classification_code (PSC), el lugar de ejecución (performance_street, performance_city, performance_state, performance_zip, performance_country), para una adjudicación award_number, award_date, award_amount (dólares) y awardee, primary_contact y secondary_contact (cada uno con title, name, email, phone, fax), la dirección de la oficina contratante (office_city, office_state, office_zip, office_country), active, description (el texto del aviso, que SAM.gov corta a unos 32.000 caracteres), additional_info_url y source_url (el aviso en SAM.gov). Los campos vacíos son null.

La lista trae los avisos que SAM.gov muestra como activos. Se actualiza a diario; un aviso que SAM.gov archiva deja de aparecer.

Una oportunidad

POST /us/sam/opportunity/v1 Dataset Resuelve un aviso por su id en SAM.gov y devuelve el registro completo.

Campo	Tipo	Notas
`id`	string	Obligatorio. El id del aviso en SAM.gov, 32 caracteres hexadecimales, como lo devuelve la búsqueda o como aparece en la URL del aviso en 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" }'

Devuelve found, id, as_of y opportunity (null cuando no se encuentra). Cada aviso incluye id (el id del aviso en SAM.gov, la clave), title, solicitation_number, type (el tipo de aviso actual: Solicitation, Combined Synopsis/Solicitation, Presolicitation, Sources Sought, Special Notice, Award Notice, Justification, Justification and Approval (J&A), Modification/Amendment/Cancel, Sale of Surplus Property o Consolidate/(Substantially) Bundle), base_type (el tipo con el que se publicó), department, department_code (CGAC), sub_tier, agency_code (FPDS), office, office_code (AAC), organization_type, posted_date y posted_at, response_deadline (como lo escribe SAM.gov, normalmente con el desfase UTC de la oficina) y response_deadline_date, archive_type y archive_date, set_aside_code y set_aside, naics_code, classification_code (PSC), el lugar de ejecución (performance_street, performance_city, performance_state, performance_zip, performance_country), para una adjudicación award_number, award_date, award_amount (dólares) y awardee, primary_contact y secondary_contact (cada uno con title, name, email, phone, fax), la dirección de la oficina contratante (office_city, office_state, office_zip, office_country), active, description (el texto del aviso, que SAM.gov corta a unos 32.000 caracteres), additional_info_url y source_url (el aviso en SAM.gov). Los campos vacíos son null.

Un id que la lista activa no registra devuelve found: false con HTTP 200, no un error. Esa es también la respuesta para un aviso que SAM.gov archivó.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Monitores

Países

Oportunidades de contratación de SAM.gov

Buscar oportunidades

Una oportunidad

Referencia completa

​Buscar oportunidades

​Una oportunidad

Referencia completa

Buscar oportunidades

Una oportunidad