> ## 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 contratación de SAM.gov

> Toda oportunidad de contratación que las agencias federales de Estados Unidos tienen activa en SAM.gov: solicitudes de ofertas, búsquedas de fuentes, presolicitudes, avisos especiales y adjudicaciones de todas las agencias, unas 75.000. Busca por palabras, tipo de aviso, agencia, código NAICS o PSC, set-aside, estado y plazo, y lee un aviso completo.

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](/es/guides/united-states/sam).

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

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

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

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

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

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

## Una oportunidad

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

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

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

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

<Note>
  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ó.
</Note>

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


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