SAM.gov Federal Contract Opportunities & Attachments

What it does

Every U.S. federal contract opportunity as clean JSON — 62 fields per notice, including the full solicitation text and the solicitation documents themselves. It talks to the same public endpoint the SAM.gov search page uses, so there is no API key to register for and nothing to renew.

{
  "notice_id": "a1b2c3d4e5f6",
  "solicitation_number": "W912DY-26-R-0042",
  "title": "Custom Software Development Services",
  "notice_type_code": "o",
  "notice_type": "Solicitation",
  "is_active": true,
  "published_at": "2026-08-14T13:02:00.000Z",
  "archive_at": "2026-09-30T00:00:00.000Z",
  "response_due_local": "2026-09-12 14:00 CDT",
  "response_due_utc": "2026-09-12T19:00:00.000Z",
  "response_due_precision": "instant",
  "response_timezone": "America/Chicago",
  "naics_code": "541511",
  "naics_title": "Custom Computer Programming Services",
  "psc_code": "D302",
  "set_aside_code": "SBA",
  "set_aside": "Total Small Business Set-Aside",
  "agency_name": "Department of the Army",
  "agency_id": "100000000",
  "contact_name": "Jane Contracting Officer",
  "contact_email": "jane.officer@example.mil",
  "contact_phone": null,
  "pop_state": "TX",
  "award_amount": null,
  "awardee_name": null,
  "description_text": "The Government intends to award a firm-fixed-price contract…",
  "attachments": [
    {
      "kind": "file",
      "name": "Statement_of_Work.pdf",
      "size_bytes": 1583201,
      "mime_type": "application/pdf",
      "url": "https://sam.gov/api/prod/opps/v3/opportunities/resources/files/..."
    }
  ],
  "file_count": 1,
  "link_count": 0,
  "from_cache": false,
  "data_age_hours": 0
}

Why this one

Use cases

• Monitor new federal opportunities in your NAICS or PSC codes, with the solicitation text in the row.
• Download the solicitation documents themselves — statements of work, price matrices, amendments — through stable URLs.
• Filter for set-aside opportunities: SBA, 8(a), WOSB, SDVOSB or HUBZone.
• Track award history by agency, awardee UEI and amount.
• Build a pipeline keyed on real deadlines, using `response_due_precision` so date-only notices are not treated as timed.
• Analyse which agencies actually publish documents on SAM.gov versus on their own portals.

Input

Every field has a default, and the defaults are deliberately small so a first run is cheap enough to inspect before you commit to a sweep. This table mirrors the Actor's own input schema field for field.

Output and fill rates

A field being in the schema is not the same as it having a value. The percentages below were counted on real runs; the sample sizes are in Measurements. Anything not listed here is not promised.

Every key is always present. A field that exists but is empty comes back as explicit null, so a parser never has to guess.

Datasets

Different record types go to different datasets, so the main table never carries columns that are blank on most rows.

Pricing

Pay per delivered result. Charges are applied as each row is produced rather than in a lump at the end, so an aborted run bills only for what it actually gave you.

Measurements

Each figure is shown with the method that produced it. A benchmark without a method is a marketing claim wearing a number's clothes.

What it will not do

Stated plainly so you can judge fit before spending anything.

• Attachments that SAM.gov marks restricted, export-controlled, deleted or non-public are not returned at all — not even their URL, because publishing the URL to a controlled document is publishing the document. Checked against six flags with an allowlist, not a blocklist.
• There is no debarment lookup, deliberately: name-only matching against the exclusion list manufactures false positives about real people.
• `response_due_utc` is null on the 38.8% of deadlines that are date-only, and on the 0.2% that carry no zone.
• Award fields sit at ~23% of all notices because most notices are not awards. Within award notices they are effectively always present.
• Attachment download URLs are 303 redirects to short-lived signed links, so a client has to follow redirects and finish the download promptly.
• 50,000 notices per run is the hard cap.

Privacy

• The data is public by law: U.S. Government works are not subject to copyright under 17 U.S.C. § 105, and FAR Part 5 requires agencies to publish these notices so that businesses can find them.
• Contact details in a notice are the contracting officer's published business contacts, returned as the agency published them.
• Restricted, export-controlled, deleted and non-public attachments are excluded entirely, URL included, via an allowlist over six separate flags.
• No debarment lookup is offered, because 63% of the exclusion list is individuals and name-only matching would assert that a real person is debarred when they are not.
• Data policy and removal requests: samgov.actorstack.dev, or privacy@actorstack.dev

See also the data removal process.

Guides for this Actor

• Scrape SAM.govA walkthrough of extracting U.S. federal contract notices: which filters actually narrow the index, how to get the solicitation documents, and why there are three deadline fields.
• The API key questionSeveral SAM.gov scrapers require you to register for an api.sam.gov key. That moves the quota problem, the approval wait and the renewal onto you — for data that is public either way.
• Solicitation documentsMeasured on a stratified sample covering 96.7% of the active index: Veterans Affairs posts documents on nearly every solicitation, the Department of Defense on about a quarter — and DoD is 63% of the index.
• Deadline precisionSAM.gov stamps midnight UTC on deadlines that are date-only. Passing that through as an instant would present a precision that does not exist, so it is null instead.
• SAM.gov data fields62 fields, snake_case, null where a value is genuinely absent and never a missing key — with coverage measured across five days spread over ten months.
• Set-aside codesSBA, 8(a), WOSB, SDVOSB, HUBZone — the codes that reserve a contract for a category of small business, present on 46.1% of notices.
• NAICS vs PSCTwo classification systems on the same notice, describing different things. One is better filled, and the difference decides which one your pipeline should key on.
• Exclusions and debarment63% of the federal exclusion list is individuals and only about a fifth of those carry a UEI. A name-matching lookup would manufacture false positives about real people.
• Opportunity monitoringA working monitoring pipeline: what to filter, how often to run, which deadline field to schedule against, and where the attachment rate changes your plan.
• Is it legal?Federal notices are published because the law requires agencies to publicise them, and U.S. Government works carry no copyright. That settles more than usual — and not everything.