# Summarize a solicitation

To summarize a SAM.gov solicitation with an AI agent, give it the notice ID and ask it to call get_opportunity. It returns the full notice description with the set-aside, NAICS and PSC codes, response deadline, place of performance and SAM.gov link, which the agent condenses into a bid or no-bid summary.

Anyone triaging more notices than they can read. A typical notice has a long description and attachments on SAM.gov; a structured first read (what is being bought, by whom, by when, under which set-aside) is enough to decide whether to download the package.

## The prompt

```
Summarize SAM.gov notice 5d8aa2693f7c4dd7adf3f6494c77eb5d for a bid or no-bid decision: what is being bought, the set-aside, NAICS, deadline in Eastern time, place of performance, and three questions I should answer before bidding.
```

## What the agent calls

1. get_opportunity: The full description text and every coded field of the notice in one lookup.

```json
{"name":"get_opportunity","arguments":{"notice_id":"5d8aa2693f7c4dd7adf3f6494c77eb5d","user_request":"summarize notice for bid decision"}}
```

## Sample output

Trimmed; field names and structure match the live response, values are shortened or illustrative.

```json
{
  "data": {
    "notice_id": "5d8aa2693f7c4dd7adf3f6494c77eb5d",
    "title": "JANITORIAL SERVICES, Channel Islands NP",
    "type": "Solicitation",
    "set_aside": "Small Business Set Aside - Total",
    "naics": "561720",
    "psc": "S201",
    "response_deadline": "2026-11-20T23:00:00.000Z",
    "description": "The National Park Service (NPS) at Channel Islands National Park (CHIS) has a requirement for janitorial services...",
    "link": "https://sam.gov/workspace/contract/opp/5d8aa2693f7c4dd7adf3f6494c77eb5d/view"
  }
}
```

## How to read the answer

- The description field holds the notice text as posted. Attachments (statements of work, pricing sheets) stay on SAM.gov; the agent should say when the real requirement lives in an attachment it has not read.
- type tells you the stage: a Sources Sought or Presolicitation is a chance to shape the requirement, a Solicitation or Combined Synopsis/Solicitation is a bid with a deadline.

## Make it yours

- Paste a list of notice IDs from a search and ask for a one-line summary and a fit score for each.
- Ask the agent to compare the notice's NAICS size standard with your receipts in the same chat.

## Pitfalls

- Do not bid from the summary. Read the full package and every amendment on SAM.gov.
- Contracting officer contact details are part of the notice data on Pro and Scale only; on other plans the agent links the notice instead.

## The same job over REST

```bash
curl "https://samgovapi.io/api/v1/opportunities/5d8aa2693f7c4dd7adf3f6494c77eb5d" -H "Authorization: Bearer $SAMGOVAPI_API_KEY"
```

Plan: every plan. Credits: 1 credit per lookup.

## Questions

### Can the agent read the attachments?

The API returns the notice text, not the attachment files. Open the SAM.gov link for the statement of work and pricing documents.

### Where do I find a notice ID?

It is the long identifier in the SAM.gov notice URL, and every search_opportunities result carries it as notice_id.

All recipes: https://samgovapi.io/agents/recipes.md

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.