SAM.gov · Detail
sam-gov/opportunities/detailSearch public records with SAM.gov · Detail from Alexandria through one Spiral API key. Fetch one SAM.gov contract opportunity by its 32-character notice id (the id in https://sam.gov/opp/{id}/view): full description, deadlines, NAICS, set-aside, place of performance, points of contact, award data, attachments (titles and download URLs only) and optionally the amendment history. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
opportunity_id required | text | — | SAM.gov notice id. Each published version (original or amendment) has its own id; is_latest/latest_opportunity_id in the record point at the current version. Pattern: ^[0-9a-fA-F]{32}$. |
fresh | true or false | — | Always true in practice: every call goes to SAM.gov live with a cache-busting parameter; the workflow keeps no cache. |
include_history | true or false | — | Include the version history (original notice and every amendment) as record.history. |
include_attachments | true or false | — | List attachments (title, download URL, size, type). Contents are never fetched. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "sam-gov/opportunities/detail",
"input": {
"opportunity_id": "<opportunity_id>"
}
}'Frequently asked questions
How much does SAM.gov · Detail cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use SAM.gov · Detail through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "sam-gov/opportunities/detail"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use SAM.gov · Detail?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use SAM.gov · Detail?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.