--- type: "firecrawl-provider" description: "US federal procurement notices (search and detail), entity registrations (search, get, changes, monthly extract status) and exclusions (daily extract list, get, status) from SAM.gov's public APIs and data-services extracts." use_when: "US federal procurement notices (search and detail), entity registrations (search, get, changes, monthly extract status) and exclusions (daily extract list, get, status) from SAM.gov's public APIs and data-services extracts." categories: "Public records" capabilities: 9 credits_per_call: 5 --- # SAM.gov on Firecrawl Alexandria US federal procurement notices (search and detail), entity registrations (search, get, changes, monthly extract status) and exclusions (daily extract list, get, status) from SAM.gov's public APIs and data-services extracts. - Categories: Public records - Category index: [Public records category](https://alexandria.firecrawl.dev/agents/categories/public-records) - Provider key: `sam-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/sam-gov) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/sam-gov/openapi.json) ## Capabilities - [Detail](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/detail): 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. - [Entities changes](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_changes): Entity registrations whose SAM.gov record changed in a date window (the Entity Management API's updateDate filter, the publisher's own modified-since feed), same record shape as entities_search, pages of at most 10. A one-day window holds about 9,700 updates against the 10,000-record query window; split larger windows by registration_status or state. - [Entities get](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_get): One to ten SAM.gov entity registrations by UEI or by CAGE code (the public Entity Management API, sections entityRegistration, coreData, assertions and pointsOfContact). Identifiers with no public registration are listed in not_found; when none is found the call fails with not_found. - [Entities search](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_search): Search SAM.gov entity registrations (the public Entity Management API served keyless from sam.gov) by legal business name, primary or any NAICS code, physical-address state or city, CAGE or UEI, for active (default) or expired registrations. Each record carries UEI, CAGE, legal and DBA name, registration status and dates, exclusion flag, physical and mailing address, entity structure, state of incorporation, business types, primary NAICS and NAICS list, and the government and electronic business points of contact (name, title, address; the public tier has no email or phone). Pages of at most 10; SAM.gov serves at most 10,000 records per query. - [Entities status](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_status): Version check and hand-off for the public monthly entity registration extract (SAM_PUBLIC_MONTHLY_V2_YYYYMMDD.ZIP in SAM.gov Data Services, about 149 MB): file name as publication_id, S3 Last-Modified, size and ETag from a 64 KB range read through the download route's 303 (the presigned URL is resolved per call and never stored), and the record count from the pipe file's BOF line decoded from the nested zip heads. hand_off is true because the file exceeds the runner's 32 MiB cap; file_url is the sam.gov download route. No daily public entity file exists. - [Exclusions get](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_get): One exclusion by SAM Number (the UUID in the extract's `SAM Number` column, served by SAM.gov's view-exclusion-details service), or every exclusion of a UEI or CAGE code (the v4 exclusions API, with the SAM Number resolved through the UI exclusion index). Same record shape as exclusions_list; the `source` field says which service answered. - [Exclusions list](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_list): The full current list of SAM.gov exclusions from the daily public extract (SAM_Exclusions_Public_Extract_V2_YYDDD.ZIP: about 169,000 rows, individuals, firms, special entity designations and vessels), paged with a cursor pinned to the file name and its S3 ETag. Every page re-resolves the newest file through listfiles, downloads the 12 MB zip through the download route's 303, inflates and parses the quoted multi-line CSV in one pass and returns the rows of the requested window; when the publication moved on since the cursor was issued the call fails with invalid_input at /continuation (issue code publication_changed). source_record_id is the extract's SAM Number. Optional classification filter. Each daily file is a full snapshot: there is no exclusions changes feed, diff consecutive snapshots. - [Exclusions status](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_status): Version check of the daily public exclusions extract (SAM_Exclusions_Public_Extract_V2_YYDDD.ZIP, Julian-dated, about 12 MB zip holding a 79 MB CSV): file name as publication_id, S3 Last-Modified, size and ETag from a 1 KB range read through the download route's 303, and the inner CSV's name and sizes from the zip local header. The zip fits the runner cap, so hand_off is false; exclusions_list reads it. record_count is null until a full read. - [Search](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/search): Search SAM.gov contract opportunities by keyword, agency, notice status, publication date, NAICS, set-aside, notice type and response deadline. Returns one page (default 20, max 100) with an opaque cursor for the next page. By default each hit is enriched with its full notice detail (NAICS, set-aside, place of performance, full description). ## 1. Choose this provider when US federal procurement notices (search and detail), entity registrations (search, get, changes, monthly extract status) and exclusions (daily extract list, get, status) from SAM.gov's public APIs and data-services extracts. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "sam-gov", "capability": "opportunities/detail", "options": { "include_attachments": false, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3" } } ``` ## 3. Add provider options Use only the options needed for the task: - `fresh` (boolean): Always true in practice: every call goes to SAM.gov live with a cache-busting parameter; the workflow keeps no cache. Example: `false` - `include_attachments` (boolean): List attachments (title, download URL, size, type). Contents are never fetched. Example: `false` - `include_history` (boolean): Include the version history (original notice and every amendment) as record.history. Example: `false` - `opportunity_id` (string, required): 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}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "sam-gov", capability: "opportunities/detail", options: { include_attachments: false, opportunity_id: "a9da8c51e84a4b72a9897a6f483845e3", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "sam-gov", "capability": "opportunities/detail", "options": { "include_attachments": False, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "sam-gov", "capability": "opportunities/detail", "options": { "include_attachments": false, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3" } } }' ``` ### CLI ```sh firecrawl scrape 'sam-gov/opportunities/detail' \ --options '{"include_attachments":false,"opportunity_id":"a9da8c51e84a4b72a9897a6f483845e3"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "sam-gov", "capability": "opportunities/detail", "options": { "include_attachments": false, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "sam-gov", "capability": "opportunities/detail", "options": { "include_attachments": false, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "complete": true, "fresh": true, "next_cursor": null, "records": [ { "agency": { "id": "500020367", "name": "500020367" }, "archive": { "date": "2026-09-30", "type": "auto15" }, "attachments": [], "attachments_retrieved": false, "award": null, "classification_code": "J041", "description": "Combined Synopsis/Solicitation\n\nAFLCMC/PZI Installation Contracting Support\n\nWright Patterson AFB, OH 45433\n\nDate: 2 SEP 2026\n\nTitle: AFIT HVAC CLEANING\n\nRequest for Quote (RFQ) / Solicitation Number: FA8601-26-Q-0141\n\nQuotes Due: 15 SEP 2026 at 12:00 PM EST\n\nContact Point(s): TSgt Adam Holden, Contract Specialist; contact@example.gov\n\nContact Point(s): Jessica Stamper, Contracting Officer; contact@example.gov\n\nDescription: This is a combined synopsis/solicitation for commercial products or commercial services prepared in accordance with RFO Part 12. This announcement constitutes the only solicitation. Offers are being requested and a separate written solicitation will not be issued.\n\nSolicitation number FA8601-26-Q-0141 is issued as a Request for Quotation (RFQ) for AFIT HVAC CLEANING at Wright Patterson Air Force Base as described under the requirements section of this combined synopsis/solicitation and accompanying requirements attachment.\n\nThis acquisition is set-aside for small business concerns under NAICS code 561790 – Other Services to Buildings and Dwellings with a small business size of $9.0M. This solicitation incorporates provisions and clauses by reference. The full text of provisions and clauses may be accessed electronically at www.acquisition.gov.\n\nThe Government reserves the right to conduct interchanges with some, none, or all offerors, or make no award at all depending upon: An award, if any, will be made LPTA. Ie, to the lowest priced Offeror who submits a proposal that:\n\nConforms to the requirements of the combined synopsis/solicitation.\n\nReceives a rating of “Acceptable” on the Technical Capability evaluation factor.\n\nContains the lowest evaluated price (TEP), provided that the TEP is not unbalanced and is fair and reasonable.\n\n***NOTE: The Government is recommending that all bidding vendors attend a site visit for Wednesday September 9, 2026 10:00EST at the following address:\n\n4185 Logistics Ave,\n\nBldg 286 Area A,\n\nWright Patterson Air Force Base\n\nTo obtain access to the installation vendors will need to acquire a visitor’s pass. Attendees must register in advance by emailing Joel Wilson at contact@example.gov and Mark Rauch at contact@example.gov, no later than 10:00AM. EST on Tuesday Sep 8, 2026, with the following information:\n\n​​​​\n\nVisitor’s full name and cell phone number\n\nPreferred email address\n\nDriver’s license number and state of issuance\n\nThe vendor will be required to pick-up their visitor’s pass at Pass and Registration located in Area A, Bldg 286, 4185 Logistics Ave, Dayton, OH 45433. Once base access has been granted, please wait in the lobby for Joel Wilson to escort you to the site visit location.\n\nThe Government also reserves the right to cancel this solicitation, either before or after the closing date.\n\n1. Requirement:\n\nThis requirement is for AFIT HVAC CLEANING at Wright Patterson Air Force Base in accordance with the Performance Work Statement (PWS).\n\n2. Period of Performance:\n\nNo later than 90 Days after contract award. This is inclusive of in person post award site visit, material finish selection, furniture lead time and installation.\n\n3. Provisions and Clauses:\n\nSee solicitation attachment for applicable provisions and clauses that apply to this acquisition. Offerors shall complete and include in quotations all representations and certifications, as well as all fill-in provisions and clauses, contained within this solicitation. Additionally, quotations that contain pricing only with no description/detail of the equipment that will be provided will not be accepted or considered for award. NOTE: In accordance with deviation R-DFARS 252.204-7998(g), the offeror's quote submission legally binds and certifies that its SAM registration is current, complete, accurate, and has been updated within the preceding 12 months as of the offer's date.\n\nMandatory Cybersecurity Maturity Model Certification (CMMC) Level 1 Assessment:\n\nIn accordance with DFARS 252.204-7021 and DFARS 252.204-7025, a CMMC Level 1 assessment is a mandatory requirement for all offerors. To be eligible for contract award, offerors must demonstrate full compliance with the 15 basic safeguarding requirements outlined in FAR 52.240.93.\n\n4. Request for Information (RFIs):\n\nThe Government will accept questions concerning this solicitation until 14 Sep 2026 at 12:00 PM EST. Email your questions on a .pdf, .doc, .docx, .xls or .xlsx document to contact@example.gov and contact@example.gov. Any questions received after this date and time may not be considered.\n\n5. Quotes Due Date:\n\nQuotes must be submitted electronically to the Contract Specialist via e-mail at contact@example.gov and Contracting Officer at contact@example.gov. Quotes must include all applicable shipping costs to include insurance. Quotes must conform to the requirements of this solicitation and be received no later than 15 SEP 2026 at 12:00 PM EST. It is the responsibility of the offeror to ensure that the quote and its attachments are received. Any correspondence sent via e-mail must contain the subject line “FA8601-26-Q-0141 – AFIT HVAC CLEANING” The entire quotation must be contained in a single e-mail that does not exceed 5 megabytes including attachments, if any. E-mails with compressed files are not permitted. Note that e-mail filters at Wright-Patterson Air Force Base are designed to filter e-mails without subject lines or with suspicious subject lines or contents (i.e., .exe or .zip files). Therefore, if the specified subject line is not included, the e-mail may not get through the e-mail filters. Also be advised that .zip or .exe files are not allowable attachments and may be deleted by the email filters at Wright-Patterson. If sending attachments with email, ensure only .pdf, .doc, .docx, .xls or .xlsx documents are sent. The email filter may delete any other form of attachments. If a DoDSafe drop off is needed, please notify the contract specialist or contracting officer at least 48 hours before quotes are due. Any quotes received after designated closing date and time need not be considered. Quotes must include aggregate total of base plus all option year CLINS, if requested (IAW RFO 52.217-5 Evaluation of Options). All quotes shall be in whole dollars and conform to the Contract Line-Item Number (CLIN) structure of attached solicitation.\n\n6. Notice to Vendor(s):\n\nAll vendors must fully complete and return the 'Required Information Sheet' (attached to the solicitation) and return with their quotation. Additionally, quotations that contain pricing only with no description/detail of the supply/service that will be provided will not be accepted or considered for award.\n\n7. Period of Acceptance of Quotes:\n\nOfferor agrees to hold prices in its quote firm for 60 calendar days from the date specified for receipt of offers.\n\n8. SAM Registration:\n\nFirms submitting a quote for the solicitation described herein, MUST be registered in the System for Award Management (SAM) database, or risk the quote as being non-responsive, regardless of the package being considered complete, timely or any other salient consideration. Information to register on SAM can be found at the web site, SAM.gov.\n\nThe contractor is responsible for entering the assessment results into the Procurement Integrated Enterprise Environment (PIEE), specifically within the Supplier Performance Risk System (SPRS) module. Contract award cannot be made to any offeror that is not fully compliant and whose assessment results are not properly recorded in the system of record.\n\nList of Attachments:\n\nPerformance Work Statement\n\nSolicitation\n\nRequired Information Sheet\n\nWage Determination", "description_is_excerpt": false, "detail_level": "full", "history": null, "is_active": true, "is_amendment": false, "is_archived": false, "is_cancelled": false, "is_latest": false, "latest_opportunity_id": "e4b01867044a4f0b9b56d506297ba84b", "modification_count": null, "naics_codes": [ "561790" ], "notice_type": "combined_synopsis_solicitation", "notice_type_code": "k", "notice_type_label": "Combined Synopsis/Solicitation", "office": null, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3", "organization_hierarchy": [], "parent_opportunity_id": null, "place_of_performance": { "city": { "code": "OH-05", "name": "Wright Patterson AFB" }, "country": { "code": "USA", "name": "UNITED STATES" }, "state": { "code": "OH", "name": "Ohio" }, "street_address": null, "zip": "45433" }, "points_of_contact": [ { "email": "contact@example.gov", "name": "Adam Holden", "phone": null, "title": null, "type": "primary" }, { "email": "contact@example.gov", "name": "Jessica Stamper", "phone": null, "title": null, "type": "secondary" } ], "previous_opportunity_id": null, "published_at": "2026-09-02T16:47:56Z", "response_deadline": "2026-09-15T16:00:00Z", "response_deadline_date": "2026-09-15", "response_deadline_local": "2026-09-15T12:00:00-04:00", "response_timezone": "America/New_York", "set_aside": "SBA", "set_aside_label": "Total Small Business Set-Aside (FAR 19.5)", "solicitation_number": "FA860126Q0141", "source_status": "published", "source_url": "https://sam.gov/opp/a9da8c51e84a4b72a9897a6f483845e3/view", "status": "open", "title": "HVAC CLEANING", "updated_at": "2026-09-03T14:54:09Z", "version": "2" } ], "retrieved_at": "2026-09-09T00:00:00Z", "schema_version": "1.0.0", "source_updated_at": "2026-09-03T14:54:09Z", "upstream_requests": 1, "warnings": [ "notice a9da8c51e84a4b72a9897a6f483845e3: organization lookup unavailable; agency name falls back to the organization id" ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Detail - Capability: `opportunities/detail` - Description: 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. - Instructions: 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. - Cost: 5 credits per call - Capability file: [Detail](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/detail) Accepted options: - `fresh` (boolean): Always true in practice: every call goes to SAM.gov live with a cache-busting parameter; the workflow keeps no cache. Example: `false` - `include_attachments` (boolean): List attachments (title, download URL, size, type). Contents are never fetched. Example: `false` - `include_history` (boolean): Include the version history (original notice and every amendment) as record.history. Example: `false` - `opportunity_id` (string, required): 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}$. Example: `` Response schema example: ```json { "complete": true, "fresh": true, "next_cursor": null, "records": [ { "agency": { "id": "500020367", "name": "500020367" }, "archive": { "date": "2026-09-30", "type": "auto15" }, "attachments": [], "attachments_retrieved": false, "award": null, "classification_code": "J041", "description": "Combined Synopsis/Solicitation\n\nAFLCMC/PZI Installation Contracting Support\n\nWright Patterson AFB, OH 45433\n\nDate: 2 SEP 2026\n\nTitle: AFIT HVAC CLEANING\n\nRequest for Quote (RFQ) / Solicitation Number: FA8601-26-Q-0141\n\nQuotes Due: 15 SEP 2026 at 12:00 PM EST\n\nContact Point(s): TSgt Adam Holden, Contract Specialist; contact@example.gov\n\nContact Point(s): Jessica Stamper, Contracting Officer; contact@example.gov\n\nDescription: This is a combined synopsis/solicitation for commercial products or commercial services prepared in accordance with RFO Part 12. This announcement constitutes the only solicitation. Offers are being requested and a separate written solicitation will not be issued.\n\nSolicitation number FA8601-26-Q-0141 is issued as a Request for Quotation (RFQ) for AFIT HVAC CLEANING at Wright Patterson Air Force Base as described under the requirements section of this combined synopsis/solicitation and accompanying requirements attachment.\n\nThis acquisition is set-aside for small business concerns under NAICS code 561790 – Other Services to Buildings and Dwellings with a small business size of $9.0M. This solicitation incorporates provisions and clauses by reference. The full text of provisions and clauses may be accessed electronically at www.acquisition.gov.\n\nThe Government reserves the right to conduct interchanges with some, none, or all offerors, or make no award at all depending upon: An award, if any, will be made LPTA. Ie, to the lowest priced Offeror who submits a proposal that:\n\nConforms to the requirements of the combined synopsis/solicitation.\n\nReceives a rating of “Acceptable” on the Technical Capability evaluation factor.\n\nContains the lowest evaluated price (TEP), provided that the TEP is not unbalanced and is fair and reasonable.\n\n***NOTE: The Government is recommending that all bidding vendors attend a site visit for Wednesday September 9, 2026 10:00EST at the following address:\n\n4185 Logistics Ave,\n\nBldg 286 Area A,\n\nWright Patterson Air Force Base\n\nTo obtain access to the installation vendors will need to acquire a visitor’s pass. Attendees must register in advance by emailing Joel Wilson at contact@example.gov and Mark Rauch at contact@example.gov, no later than 10:00AM. EST on Tuesday Sep 8, 2026, with the following information:\n\n​​​​\n\nVisitor’s full name and cell phone number\n\nPreferred email address\n\nDriver’s license number and state of issuance\n\nThe vendor will be required to pick-up their visitor’s pass at Pass and Registration located in Area A, Bldg 286, 4185 Logistics Ave, Dayton, OH 45433. Once base access has been granted, please wait in the lobby for Joel Wilson to escort you to the site visit location.\n\nThe Government also reserves the right to cancel this solicitation, either before or after the closing date.\n\n1. Requirement:\n\nThis requirement is for AFIT HVAC CLEANING at Wright Patterson Air Force Base in accordance with the Performance Work Statement (PWS).\n\n2. Period of Performance:\n\nNo later than 90 Days after contract award. This is inclusive of in person post award site visit, material finish selection, furniture lead time and installation.\n\n3. Provisions and Clauses:\n\nSee solicitation attachment for applicable provisions and clauses that apply to this acquisition. Offerors shall complete and include in quotations all representations and certifications, as well as all fill-in provisions and clauses, contained within this solicitation. Additionally, quotations that contain pricing only with no description/detail of the equipment that will be provided will not be accepted or considered for award. NOTE: In accordance with deviation R-DFARS 252.204-7998(g), the offeror's quote submission legally binds and certifies that its SAM registration is current, complete, accurate, and has been updated within the preceding 12 months as of the offer's date.\n\nMandatory Cybersecurity Maturity Model Certification (CMMC) Level 1 Assessment:\n\nIn accordance with DFARS 252.204-7021 and DFARS 252.204-7025, a CMMC Level 1 assessment is a mandatory requirement for all offerors. To be eligible for contract award, offerors must demonstrate full compliance with the 15 basic safeguarding requirements outlined in FAR 52.240.93.\n\n4. Request for Information (RFIs):\n\nThe Government will accept questions concerning this solicitation until 14 Sep 2026 at 12:00 PM EST. Email your questions on a .pdf, .doc, .docx, .xls or .xlsx document to contact@example.gov and contact@example.gov. Any questions received after this date and time may not be considered.\n\n5. Quotes Due Date:\n\nQuotes must be submitted electronically to the Contract Specialist via e-mail at contact@example.gov and Contracting Officer at contact@example.gov. Quotes must include all applicable shipping costs to include insurance. Quotes must conform to the requirements of this solicitation and be received no later than 15 SEP 2026 at 12:00 PM EST. It is the responsibility of the offeror to ensure that the quote and its attachments are received. Any correspondence sent via e-mail must contain the subject line “FA8601-26-Q-0141 – AFIT HVAC CLEANING” The entire quotation must be contained in a single e-mail that does not exceed 5 megabytes including attachments, if any. E-mails with compressed files are not permitted. Note that e-mail filters at Wright-Patterson Air Force Base are designed to filter e-mails without subject lines or with suspicious subject lines or contents (i.e., .exe or .zip files). Therefore, if the specified subject line is not included, the e-mail may not get through the e-mail filters. Also be advised that .zip or .exe files are not allowable attachments and may be deleted by the email filters at Wright-Patterson. If sending attachments with email, ensure only .pdf, .doc, .docx, .xls or .xlsx documents are sent. The email filter may delete any other form of attachments. If a DoDSafe drop off is needed, please notify the contract specialist or contracting officer at least 48 hours before quotes are due. Any quotes received after designated closing date and time need not be considered. Quotes must include aggregate total of base plus all option year CLINS, if requested (IAW RFO 52.217-5 Evaluation of Options). All quotes shall be in whole dollars and conform to the Contract Line-Item Number (CLIN) structure of attached solicitation.\n\n6. Notice to Vendor(s):\n\nAll vendors must fully complete and return the 'Required Information Sheet' (attached to the solicitation) and return with their quotation. Additionally, quotations that contain pricing only with no description/detail of the supply/service that will be provided will not be accepted or considered for award.\n\n7. Period of Acceptance of Quotes:\n\nOfferor agrees to hold prices in its quote firm for 60 calendar days from the date specified for receipt of offers.\n\n8. SAM Registration:\n\nFirms submitting a quote for the solicitation described herein, MUST be registered in the System for Award Management (SAM) database, or risk the quote as being non-responsive, regardless of the package being considered complete, timely or any other salient consideration. Information to register on SAM can be found at the web site, SAM.gov.\n\nThe contractor is responsible for entering the assessment results into the Procurement Integrated Enterprise Environment (PIEE), specifically within the Supplier Performance Risk System (SPRS) module. Contract award cannot be made to any offeror that is not fully compliant and whose assessment results are not properly recorded in the system of record.\n\nList of Attachments:\n\nPerformance Work Statement\n\nSolicitation\n\nRequired Information Sheet\n\nWage Determination", "description_is_excerpt": false, "detail_level": "full", "history": null, "is_active": true, "is_amendment": false, "is_archived": false, "is_cancelled": false, "is_latest": false, "latest_opportunity_id": "e4b01867044a4f0b9b56d506297ba84b", "modification_count": null, "naics_codes": [ "561790" ], "notice_type": "combined_synopsis_solicitation", "notice_type_code": "k", "notice_type_label": "Combined Synopsis/Solicitation", "office": null, "opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3", "organization_hierarchy": [], "parent_opportunity_id": null, "place_of_performance": { "city": { "code": "OH-05", "name": "Wright Patterson AFB" }, "country": { "code": "USA", "name": "UNITED STATES" }, "state": { "code": "OH", "name": "Ohio" }, "street_address": null, "zip": "45433" }, "points_of_contact": [ { "email": "contact@example.gov", "name": "Adam Holden", "phone": null, "title": null, "type": "primary" }, { "email": "contact@example.gov", "name": "Jessica Stamper", "phone": null, "title": null, "type": "secondary" } ], "previous_opportunity_id": null, "published_at": "2026-09-02T16:47:56Z", "response_deadline": "2026-09-15T16:00:00Z", "response_deadline_date": "2026-09-15", "response_deadline_local": "2026-09-15T12:00:00-04:00", "response_timezone": "America/New_York", "set_aside": "SBA", "set_aside_label": "Total Small Business Set-Aside (FAR 19.5)", "solicitation_number": "FA860126Q0141", "source_status": "published", "source_url": "https://sam.gov/opp/a9da8c51e84a4b72a9897a6f483845e3/view", "status": "open", "title": "HVAC CLEANING", "updated_at": "2026-09-03T14:54:09Z", "version": "2" } ], "retrieved_at": "2026-09-09T00:00:00Z", "schema_version": "1.0.0", "source_updated_at": "2026-09-03T14:54:09Z", "upstream_requests": 1, "warnings": [ "notice a9da8c51e84a4b72a9897a6f483845e3: organization lookup unavailable; agency name falls back to the organization id" ] } ``` ### Entities changes - Capability: `opportunities/entities_changes` - Description: Entity registrations whose SAM.gov record changed in a date window (the Entity Management API's updateDate filter, the publisher's own modified-since feed), same record shape as entities_search, pages of at most 10. A one-day window holds about 9,700 updates against the 10,000-record query window; split larger windows by registration_status or state. - Instructions: Collect registrations updated since the last run. - Cost: 5 credits per call - Capability file: [Entities changes](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_changes) Accepted options: - `page` (number): 0-based page (default 0); page * size may not exceed 10,000. Example: `10` - `registration_status` (string): A (active) or E (expired); default both. Example: `A` - `size` (number): Records per page, 1 to 10 (SAM.gov's hard limit; default 10). Example: `10` - `state` (string): Physical-address state code, to split a window above 10,000 records. Pattern: ^[A-Za-z]{2}$. Example: `` - `updated_from` (string, required): First day of the window, YYYY-MM-DD (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `updated_to` (string, required): Last day of the window, YYYY-MM-DD (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "count": 2, "has_more": true, "next_page": 1, "page": 0, "publication_id": "entity-information/v4:2026-10-18", "query": { "registration_status": null, "state": null, "updated_from": "2026-10-15", "updated_to": "2026-10-16" }, "records": [ { "activation_date": "2024-08-29", "business_types": [ { "code": "F", "description": "Business or Organization" }, { "code": "2X", "description": "For Profit Organization" }, { "code": "LJ", "description": "Limited Liability Company" }, { "code": "27", "description": "Self Certified Small Disadvantaged Business" }, { "code": "OY", "description": "Black American Owned" }, { "code": "23", "description": "Minority-Owned Business" }, { "code": "A2", "description": "Women-Owned Business" }, { "code": "8E", "description": "Economically Disadvantaged Women Owned Small Business" }, { "code": "8W", "description": "Women-Owned Small Business" } ], "cage_code": "9JFF6", "congressional_district": "03", "country_of_incorporation_code": "USA", "dba_name": null, "electronic_business_poc": { "address_line1": "3417 Keston Rd", "address_line2": null, "city": "Gwynn Oak", "country_code": "USA", "first_name": "Yolanda", "last_name": "Crenshaw", "middle_initial": "D", "state_or_province_code": "MD", "title": "Member", "zip_code": "21207", "zip_code_plus4": null }, "entity_division_name": null, "entity_start_date": "2020-08-10", "entity_structure_code": "2L", "entity_structure_desc": "Corporate Entity (Not Tax Exempt)", "entity_type_desc": "Business or Organization", "entity_url": null, "exclusion_status_flag": "N", "exclusion_url": null, "fiscal_year_end_close_date": "12/31", "government_business_poc": { "address_line1": "3417 Keston Rd", "address_line2": null, "city": "Gwynn Oak", "country_code": "USA", "first_name": "Yolanda", "last_name": "Crenshaw", "middle_initial": "D", "state_or_province_code": "MD", "title": "Member", "zip_code": "21207", "zip_code_plus4": null }, "last_update_date": "2026-10-16", "legal_business_name": "LEGACY PREMIER PROPERTIES LLC", "mailing_address": { "address_line1": "200 HIGH ST STE 500", "address_line2": null, "city": "PORTSMOUTH", "country_code": "USA", "state_or_province_code": "VA", "zip_code": "23704", "zip_code_plus4": "3703" }, "naics_list": [ { "code": "445132", "description": "Vending Machine Operators ", "naics_exception": null, "sba_small_business": "Y" }, { "code": "325620", "description": "Toilet Preparation Manufacturing", "naics_exception": null, "sba_small_business": "Y" } ], "organization_structure_desc": "Limited Liability Company", "physical_address": { "address_line1": "200 HIGH ST STE 500", "address_line2": null, "city": "PORTSMOUTH", "country_code": "USA", "state_or_province_code": "VA", "zip_code": "23704", "zip_code_plus4": "3703" }, "primary_naics": "325620", "profit_structure_desc": "For Profit Organization", "psc_list": [ { "code": "3550", "description": "VENDING AND COIN OPERATED MACHINES" }, { "code": "8510", "description": "PERFUMES, TOILET PREPARATIONS, AND POWDERS" } ], "publication_id": "entity-information/v4:2026-10-18", "purpose_of_registration_code": "Z2", "purpose_of_registration_desc": "All Awards", "registration_date": "2023-02-17", "registration_expiration_date": "2025-08-26", "registration_status": "Inactive", "retrieved_at": "2026-10-18T22:35:24Z", "sba_business_types": [], "sections_present": { "assertions": true, "core_data": true, "points_of_contact": true }, "source_record_id": "S875K1JE3FJ5", "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?ueiSAM=S875K1JE3FJ5", "state_of_incorporation_code": "VA", "submission_date": "2024-08-27", "uei_sam": "S875K1JE3FJ5", "uei_status": "Active" }, { "activation_date": "2024-12-03", "business_types": [ { "code": "F", "description": "Business or Organization" }, { "code": "2X", "description": "For Profit Organization" }, { "code": "XS", "description": "Subchapter S Corporation" }, { "code": "27", "description": "Self Certified Small Disadvantaged Business" } ], "cage_code": "8SLK5", "congressional_district": "11", "country_of_incorporation_code": "USA", "dba_name": null, "electronic_business_poc": { "address_line1": "14101 parke long ct", "address_line2": "STE A", "city": "Chantilly", "country_code": "USA", "first_name": "moe", "last_name": "attyah", "middle_initial": null, "state_or_province_code": "VA", "title": "CO", "zip_code": "20151", "zip_code_plus4": null }, "entity_division_name": null, "entity_start_date": "2019-12-19", "entity_structure_code": "2L", "entity_structure_desc": "Corporate Entity (Not Tax Exempt)", "entity_type_desc": "Business or Organization", "entity_url": "Attyahrecycling.com", "exclusion_status_flag": "N", "exclusion_url": null, "fiscal_year_end_close_date": "12/31", "government_business_poc": { "address_line1": "14101 parke long ct", "address_line2": "STE A", "city": "Chantilly", "country_code": "USA", "first_name": "Feras", "last_name": "attyah", "middle_initial": null, "state_or_province_code": "VA", "title": "Contracts manager", "zip_code": "20151", "zip_code_plus4": null }, "last_update_date": "2026-10-15", "legal_business_name": "ATTYAH TECH INC", "mailing_address": { "address_line1": "14101 Parke long ct", "address_line2": "Ste A", "city": "Chantilly", "country_code": "USA", "state_or_province_code": "VA", "zip_code": "20151", "zip_code_plus4": null }, "naics_list": [ { "code": "423430", "description": "Computer and Computer Peripheral Equipment and Software Merchant Wholesalers ", "naics_exception": null, "sba_small_business": "Y" }, { "code": "423930", "description": "Recyclable Material Merchant Wholesalers ", "naics_exception": null, "sba_small_business": "Y" } ], "organization_structure_desc": "Subchapter S Corporation", "physical_address": { "address_line1": "14101 Parke Long Ct Ste A", "address_line2": null, "city": "Chantilly", "country_code": "USA", "state_or_province_code": "VA", "zip_code": "20151", "zip_code_plus4": "1645" }, "primary_naics": "423430", "profit_structure_desc": "For Profit Organization", "psc_list": [], "publication_id": "entity-information/v4:2026-10-18", "purpose_of_registration_code": "Z2", "purpose_of_registration_desc": "All Awards", "registration_date": "2020-11-12", "registration_expiration_date": "2025-11-29", "registration_status": "Inactive", "retrieved_at": "2026-10-18T22:35:24Z", "sba_business_types": [], "sections_present": { "assertions": true, "core_data": true, "points_of_contact": true }, "source_record_id": "NH8YKMBDVYA1", "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?ueiSAM=NH8YKMBDVYA1", "state_of_incorporation_code": "VA", "submission_date": "2024-11-29", "uei_sam": "NH8YKMBDVYA1", "uei_status": "Active" } ], "result_cap": 10000, "retrieved_at": "2026-10-18T22:35:24Z", "size": 2, "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?updateDate=%5B10/15/2026,10/16/2026%5D&includeSections=entityRegistration,coreData,assertions,pointsOfContact&page=0&size=2", "total_records": 9743 } ``` ### Entities get - Capability: `opportunities/entities_get` - Description: One to ten SAM.gov entity registrations by UEI or by CAGE code (the public Entity Management API, sections entityRegistration, coreData, assertions and pointsOfContact). Identifiers with no public registration are listed in not_found; when none is found the call fails with not_found. - Instructions: You have UEIs or CAGE codes and want the registration records. - Cost: 5 credits per call - Capability file: [Entities get](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_get) Accepted options: - `cage_code` (string[]): One to ten CAGE codes. Example: `[]` - `uei_sam` (string[]): One to ten UEIs. Example: `[]` Response schema example: ```json { "by": "uei_sam", "count": 1, "not_found": [], "publication_id": "entity-information/v4:2026-10-18", "records": [ { "activation_date": "2026-01-09", "business_types": [ { "code": "27", "description": "Self Certified Small Disadvantaged Business" }, { "code": "2X", "description": "For Profit Organization" }, { "code": "8W", "description": "Women-Owned Small Business" }, { "code": "A2", "description": "Women-Owned Business" }, { "code": "F", "description": "Business or Organization" } ], "cage_code": "115S3", "congressional_district": "07", "country_of_incorporation_code": "USA", "dba_name": null, "electronic_business_poc": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "first_name": "Mary", "last_name": "Moser", "middle_initial": null, "state_or_province_code": "WA", "title": null, "zip_code": "98125", "zip_code_plus4": null }, "entity_division_name": null, "entity_start_date": "2021-04-01", "entity_structure_code": "2J", "entity_structure_desc": "Sole Proprietorship", "entity_type_desc": "Business or Organization", "entity_url": null, "exclusion_status_flag": "N", "exclusion_url": null, "fiscal_year_end_close_date": "12/31", "government_business_poc": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "first_name": "Mary", "last_name": "Moser", "middle_initial": null, "state_or_province_code": "WA", "title": null, "zip_code": "98125", "zip_code_plus4": null }, "last_update_date": "2026-01-09", "legal_business_name": "MOSERWORKS LLC", "mailing_address": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "state_or_province_code": "WA", "zip_code": "98125", "zip_code_plus4": "7905" }, "naics_list": [ { "code": "541990", "description": "All Other Professional, Scientific, and Technical Services", "naics_exception": null, "sba_small_business": "Y" } ], "organization_structure_desc": null, "physical_address": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "state_or_province_code": "WA", "zip_code": "98125", "zip_code_plus4": "7905" }, "primary_naics": "541990", "profit_structure_desc": "For Profit Organization", "psc_list": [], "publication_id": "entity-information/v4:2026-10-18", "purpose_of_registration_code": "Z2", "purpose_of_registration_desc": "All Awards", "registration_date": "2025-01-20", "registration_expiration_date": "2027-01-07", "registration_status": "Active", "retrieved_at": "2026-10-18T22:34:45Z", "sba_business_types": [], "sections_present": { "assertions": true, "core_data": true, "points_of_contact": true }, "source_record_id": "WM1KQNQGV7M9", "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?ueiSAM=WM1KQNQGV7M9", "state_of_incorporation_code": "WA", "submission_date": "2026-01-07", "uei_sam": "WM1KQNQGV7M9", "uei_status": "Active" } ], "requested": [ "WM1KQNQGV7M9" ], "retrieved_at": "2026-10-18T22:34:45Z", "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?ueiSAM=WM1KQNQGV7M9&includeSections=entityRegistration,coreData,assertions,pointsOfContact&page=0&size=10", "total_records": 1 } ``` ### Entities search - Capability: `opportunities/entities_search` - Description: Search SAM.gov entity registrations (the public Entity Management API served keyless from sam.gov) by legal business name, primary or any NAICS code, physical-address state or city, CAGE or UEI, for active (default) or expired registrations. Each record carries UEI, CAGE, legal and DBA name, registration status and dates, exclusion flag, physical and mailing address, entity structure, state of incorporation, business types, primary NAICS and NAICS list, and the government and electronic business points of contact (name, title, address; the public tier has no email or phone). Pages of at most 10; SAM.gov serves at most 10,000 records per query. - Instructions: Find registrants by name, NAICS or state; use entities_get when you already have a UEI or CAGE. - Cost: 5 credits per call - Capability file: [Entities search](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_search) Accepted options: - `cage_code` (string): Five-character CAGE code. Pattern: ^[A-Za-z0-9]{5}$. Example: `` - `city` (string): Physical-address city. Example: `` - `legal_business_name` (string): Legal business name (SAM.gov matches on the name text). Example: `` - `naics_code` (string): Any NAICS code on the registration. Pattern: ^[0-9]{6}$. Example: `` - `page` (number): 0-based page (default 0); page * size may not exceed 10,000. Example: `10` - `primary_naics` (string): Six-digit primary NAICS code. Pattern: ^[0-9]{6}$. Example: `` - `registration_status` (string): A (active, default) or E (expired). Example: `A` - `size` (number): Records per page, 1 to 10 (SAM.gov's hard limit; default 10). Example: `10` - `state` (string): Physical-address state or province code (VA, CA ...). Pattern: ^[A-Za-z]{2}$. Example: `` - `uei_sam` (string): Twelve-character Unique Entity ID. Pattern: ^[A-Za-z0-9]{12}$. Example: `` Response schema example: ```json { "count": 1, "has_more": false, "next_page": null, "page": 0, "publication_id": "entity-information/v4:2026-10-18", "query": { "cage_code": null, "city": null, "legal_business_name": "moserworks", "naics_code": null, "primary_naics": null, "registration_status": "A", "state": null, "uei_sam": null }, "records": [ { "activation_date": "2026-01-09", "business_types": [ { "code": "27", "description": "Self Certified Small Disadvantaged Business" }, { "code": "2X", "description": "For Profit Organization" }, { "code": "8W", "description": "Women-Owned Small Business" }, { "code": "A2", "description": "Women-Owned Business" }, { "code": "F", "description": "Business or Organization" } ], "cage_code": "115S3", "congressional_district": "07", "country_of_incorporation_code": "USA", "dba_name": null, "electronic_business_poc": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "first_name": "Mary", "last_name": "Moser", "middle_initial": null, "state_or_province_code": "WA", "title": null, "zip_code": "98125", "zip_code_plus4": null }, "entity_division_name": null, "entity_start_date": "2021-04-01", "entity_structure_code": "2J", "entity_structure_desc": "Sole Proprietorship", "entity_type_desc": "Business or Organization", "entity_url": null, "exclusion_status_flag": "N", "exclusion_url": null, "fiscal_year_end_close_date": "12/31", "government_business_poc": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "first_name": "Mary", "last_name": "Moser", "middle_initial": null, "state_or_province_code": "WA", "title": null, "zip_code": "98125", "zip_code_plus4": null }, "last_update_date": "2026-01-09", "legal_business_name": "MOSERWORKS LLC", "mailing_address": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "state_or_province_code": "WA", "zip_code": "98125", "zip_code_plus4": "7905" }, "naics_list": [ { "code": "541990", "description": "All Other Professional, Scientific, and Technical Services", "naics_exception": null, "sba_small_business": "Y" } ], "organization_structure_desc": null, "physical_address": { "address_line1": "10921 36TH AVE NE", "address_line2": null, "city": "SEATTLE", "country_code": "USA", "state_or_province_code": "WA", "zip_code": "98125", "zip_code_plus4": "7905" }, "primary_naics": "541990", "profit_structure_desc": "For Profit Organization", "psc_list": [], "publication_id": "entity-information/v4:2026-10-18", "purpose_of_registration_code": "Z2", "purpose_of_registration_desc": "All Awards", "registration_date": "2025-01-20", "registration_expiration_date": "2027-01-07", "registration_status": "Active", "retrieved_at": "2026-10-18T22:34:54Z", "sba_business_types": [], "sections_present": { "assertions": true, "core_data": true, "points_of_contact": true }, "source_record_id": "WM1KQNQGV7M9", "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?ueiSAM=WM1KQNQGV7M9", "state_of_incorporation_code": "WA", "submission_date": "2026-01-07", "uei_sam": "WM1KQNQGV7M9", "uei_status": "Active" } ], "result_cap": 10000, "retrieved_at": "2026-10-18T22:34:54Z", "size": 10, "source_url": "https://sam.gov/api/prod/entity-information/v4/entities?legalBusinessName=moserworks®istrationStatus=A&includeSections=entityRegistration,coreData,assertions,pointsOfContact&page=0&size=10", "total_records": 1 } ``` ### Entities status - Capability: `opportunities/entities_status` - Description: Version check and hand-off for the public monthly entity registration extract (SAM_PUBLIC_MONTHLY_V2_YYYYMMDD.ZIP in SAM.gov Data Services, about 149 MB): file name as publication_id, S3 Last-Modified, size and ETag from a 64 KB range read through the download route's 303 (the presigned URL is resolved per call and never stored), and the record count from the pipe file's BOF line decoded from the nested zip heads. hand_off is true because the file exceeds the runner's 32 MiB cap; file_url is the sam.gov download route. No daily public entity file exists. - Instructions: Learn whether a new monthly entity extract was published and get its URL, size, hash and record count before downloading it elsewhere. - Cost: 5 credits per call - Capability file: [Entities status](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/entities_status) Accepted options: - `file_name` (string): Pin one listed file name (default: the newest SAM_PUBLIC_MONTHLY_V2 file). Example: `` Response schema example: ```json { "bof_file_date": "2026-10-05", "bof_line": "BOF PUBLIC V2 00000000 20261005 0905712 0008359", "cadence": "monthly (public daily entity files do not exist; the folder holds the monthly V2 file and its UTF-8 twin only)", "content_hash": "7e4d95ff69b33afc8d04556c55b3f1ca-18", "date_modified_label": "Oct 04,2026", "description": "This data package contains the entity registration data publicly available under the Freedom of Information Act (FOIA) for those registered in SAM to do business with the Federal government. The monthly file is a refresh file for all active registration records and those which expired in the past six months with the Unique Entity Identifier (UEI) fields added.", "etag": "7e4d95ff69b33afc8d04556c55b3f1ca-18", "file_date": "2026-10-05", "file_format": "ZIP, Pipe-Delimited", "file_name": "SAM_PUBLIC_MONTHLY_V2_20261005.ZIP", "file_url": "https://sam.gov/api/prod/fileextractservices/v1/api/download/Entity%20Registration/Public%20V2/SAM_PUBLIC_MONTHLY_V2_20261005.ZIP?privacy=Public", "files_listed": [ { "date_modified": "Oct 04,2026", "display_key": "SAM_PUBLIC_MONTHLY_V2_20261005.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_MONTHLY_V2_20261005.ZIP" }, { "date_modified": "Oct 04,2026", "display_key": "SAM_PUBLIC_UTF-8_MONTHLY_V2_20261005.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_UTF-8_MONTHLY_V2_20261005.ZIP" }, { "date_modified": "Sep 07,2026", "display_key": "SAM_PUBLIC_MONTHLY_V2_20260907.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_MONTHLY_V2_20260907.ZIP" }, { "date_modified": "Sep 07,2026", "display_key": "SAM_PUBLIC_UTF-8_MONTHLY_V2_20260907.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_UTF-8_MONTHLY_V2_20260907.ZIP" }, { "date_modified": "Sep 06,2026", "display_key": "SAM_PUBLIC_MONTHLY_V2_20260906.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_MONTHLY_V2_20260906.ZIP" }, { "date_modified": "Sep 06,2026", "display_key": "SAM_PUBLIC_UTF-8_MONTHLY_V2_20260906.ZIP", "file_format": "ZIP, Pipe-Delimited", "key": "Entity Registration/Public V2/SAM_PUBLIC_UTF-8_MONTHLY_V2_20260906.ZIP" } ], "hand_off": true, "hand_off_reason": "the monthly extract (149228825 bytes) exceeds the runner's 33554432-byte response cap; download file_url (it answers 303 to a presigned S3 URL valid for 2700 s; Range requests are honoured) and parse the pipe-delimited .dat (layout v6.0: 1 UNIQUE ENTITY ID, 4 CAGE CODE, 12 LEGAL BUSINESS NAME, 13 DBA NAME, 16-22 physical address, 32 BUS TYPE STRING, 33 PRIMARY NAICS, 35 NAICS CODE STRING, 47-57 GOVT BUS POC, 116 EXCLUSION STATUS FLAG)", "hash_source": "s3_etag", "inner_entry": { "compressed_size": 149210042, "method": 8, "name": "SAM_PUBLIC_MONTHLY_V2_20261005_c7d262ab2b63483dbe2bf892f1d18432.dat", "uncompressed_size": 553044161 }, "last_modified_header": "Mon, 05 Oct 2026 02:35:59 GMT", "listing_url": "https://sam.gov/api/prod/fileextractservices/v1/api/listfiles?domain=Entity%20Registration/Public%20V2&privacy=Public", "outer_entry": { "compressed_size": 149228659, "method": 8, "name": "SAM_PUBLIC_MONTHLY_V2_20261005.ZIP", "uncompressed_size": 149210274 }, "publication_id": "SAM_PUBLIC_MONTHLY_V2_20261005.ZIP", "published_at": "2026-10-05T02:35:59Z", "record_count": 905712, "retrieved_at": "2026-10-18T22:35:33Z", "size_bytes": 149228825 } ``` ### Exclusions get - Capability: `opportunities/exclusions_get` - Description: One exclusion by SAM Number (the UUID in the extract's `SAM Number` column, served by SAM.gov's view-exclusion-details service), or every exclusion of a UEI or CAGE code (the v4 exclusions API, with the SAM Number resolved through the UI exclusion index). Same record shape as exclusions_list; the `source` field says which service answered. - Instructions: Look up one exclusion record, or check whether a registrant is excluded. - Cost: 5 credits per call - Capability file: [Exclusions get](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_get) Accepted options: - `cage_code` (string): Pattern: ^[A-Za-z0-9]{5}$. Example: `` - `sam_number` (string): Exclusion SAM Number (UUID). Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$. Example: `` - `uei_sam` (string): Pattern: ^[A-Za-z0-9]{12}$. Example: `` Response schema example: ```json { "by": "sam_number", "count": 1, "records": [ { "active_date": "1991-04-09", "additional_comments": null, "address": { "address_line1": "712 Camelot Dr.", "address_line2": null, "address_line3": null, "address_line4": null, "city": "College Park", "country_code": "USA", "state_or_province_code": "GA", "zip_code": "30349" }, "cage_code": null, "classification": "Firm", "creation_date": "2012-07-27", "cross_reference": null, "ct_code": "R", "excluding_agency_code": null, "excluding_agency_name": "Department of Housing and Urban Development", "excluding_agency_org_id": "100000391", "exclusion_program": "Reciprocal", "exclusion_type": "Ineligible (Proceedings Complete)", "first_name": null, "is_fascsa_order": false, "last_name": null, "middle_name": null, "name": "Martin and Martin", "npi": "NA", "open_data_flag": null, "prefix": null, "publication_id": "view-exclusion-details/v3:2026-10-18", "record_status": "Active", "retrieved_at": "2026-10-18T22:35:02Z", "row_number": null, "sam_number": "bf32fd84-e837-4758-a315-4457e3ff5a15", "source": "view_exclusion_details_v3", "source_record_id": "bf32fd84-e837-4758-a315-4457e3ff5a15", "source_url": "https://sam.gov/api/prod/view-exclusion-details/v3/api/exclusion/bf32fd84-e837-4758-a315-4457e3ff5a15", "suffix": null, "termination_date": "Indefinite", "uei_sam": "S9AGLMTJ5LN1", "update_date": "2012-07-27" } ], "requested": "bf32fd84-e837-4758-a315-4457e3ff5a15", "retrieved_at": "2026-10-18T22:35:02Z", "source_url": "https://sam.gov/api/prod/view-exclusion-details/v3/api/exclusion/bf32fd84-e837-4758-a315-4457e3ff5a15" } ``` ### Exclusions list - Capability: `opportunities/exclusions_list` - Description: The full current list of SAM.gov exclusions from the daily public extract (SAM_Exclusions_Public_Extract_V2_YYDDD.ZIP: about 169,000 rows, individuals, firms, special entity designations and vessels), paged with a cursor pinned to the file name and its S3 ETag. Every page re-resolves the newest file through listfiles, downloads the 12 MB zip through the download route's 303, inflates and parses the quoted multi-line CSV in one pass and returns the rows of the requested window; when the publication moved on since the cursor was issued the call fails with invalid_input at /continuation (issue code publication_changed). source_record_id is the extract's SAM Number. Optional classification filter. Each daily file is a full snapshot: there is no exclusions changes feed, diff consecutive snapshots. - Instructions: Collect every active exclusion, or one classification, in pages. - Cost: 5 credits per call - Capability file: [Exclusions list](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_list) Accepted options: - `classification` (string): Individual, Firm, Special Entity Designation or Vessel; default all. Example: `Individual` - `continuation` (string): Opaque cursor from the previous page's meta.page.next_cursor (file|etag|offset). Example: `` - `page_size` (number): Rows per page, 1 to 500 (default 100). Each page downloads the whole 12 MB extract. Example: `10` Response schema example: ```json { "columns": [ "Classification", "Name", "Prefix", "First", "Middle", "Last", "Suffix", "Address 1", "Address 2", "Address 3", "Address 4", "City", "State / Province", "Country", "Zip Code", "Open Data Flag", "Blank (Deprecated)", "Unique Entity ID", "Exclusion Program", "Excluding Agency", "CT Code", "Exclusion Type", "Additional Comments", "Active Date", "Termination Date", "Record Status", "Cross-Reference", "SAM Number", "CAGE", "NPI", "Creation_Date" ], "content_hash": "a3236cae8121651415a56828f72dc690-2", "count": 2, "etag": "a3236cae8121651415a56828f72dc690-2", "file_date": "2026-10-18", "file_name": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "has_more": true, "hash_source": "s3_etag", "inner_file_name": "SAM_Exclusions_Public_Extract_V2_26291.CSV", "next_offset": 2, "offset": 0, "publication_id": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "published_at": "2026-10-18T09:39:26Z", "query": { "classification": "Firm", "page_size": 2 }, "records": [ { "active_date": "2024-12-04", "additional_comments": null, "address": { "address_line1": "3231 W Thunderbird Rd", "address_line2": null, "address_line3": null, "address_line4": null, "city": "Phoenix", "country_code": "USA", "state_or_province_code": "AZ", "zip_code": "85053-5605" }, "cage_code": null, "classification": "Firm", "creation_date": "2024-12-04", "cross_reference": "(also Jason Junior Coleman, Kimberly Djai Coleman)", "ct_code": null, "excluding_agency_code": "ICE", "excluding_agency_name": null, "excluding_agency_org_id": null, "exclusion_program": "Reciprocal", "exclusion_type": "Ineligible (Proceedings Completed)", "first_name": null, "is_fascsa_order": null, "last_name": null, "middle_name": null, "name": "106 Coronado, LLC", "npi": null, "open_data_flag": null, "prefix": null, "publication_id": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "record_status": "Active", "retrieved_at": "2026-10-18T22:35:51Z", "row_number": 133797, "sam_number": "39e5ebc7-5766-41a9-9d6b-6956376b34ca", "source": "public_extract_csv", "source_record_id": "39e5ebc7-5766-41a9-9d6b-6956376b34ca", "source_url": "https://sam.gov/api/prod/fileextractservices/v1/api/download/Exclusions/Public%20V2/SAM_Exclusions_Public_Extract_V2_26291.ZIP?privacy=Public", "suffix": null, "termination_date": "2029-12-03", "uei_sam": "Y8CHG5Y7Z488", "update_date": null }, { "active_date": "2024-12-04", "additional_comments": null, "address": { "address_line1": "3231 W Thunderbird Rd", "address_line2": null, "address_line3": null, "address_line4": null, "city": "Phoenix", "country_code": "USA", "state_or_province_code": "AZ", "zip_code": "85053-5605" }, "cage_code": null, "classification": "Firm", "creation_date": "2024-12-04", "cross_reference": "(also Jason Junior Coleman, Kimberly Djai Coleman)", "ct_code": null, "excluding_agency_code": "ICE", "excluding_agency_name": null, "excluding_agency_org_id": null, "exclusion_program": "Reciprocal", "exclusion_type": "Ineligible (Proceedings Completed)", "first_name": null, "is_fascsa_order": null, "last_name": null, "middle_name": null, "name": "11:11 Lifestyle, LLC", "npi": null, "open_data_flag": null, "prefix": null, "publication_id": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "record_status": "Active", "retrieved_at": "2026-10-18T22:35:51Z", "row_number": 133800, "sam_number": "141d03f0-a1ba-4ab3-88cc-8c9e9f8db2b7", "source": "public_extract_csv", "source_record_id": "141d03f0-a1ba-4ab3-88cc-8c9e9f8db2b7", "source_url": "https://sam.gov/api/prod/fileextractservices/v1/api/download/Exclusions/Public%20V2/SAM_Exclusions_Public_Extract_V2_26291.ZIP?privacy=Public", "suffix": null, "termination_date": "2029-12-03", "uei_sam": "Y8S2A7C9KA24", "update_date": null } ], "retrieved_at": "2026-10-18T22:35:51Z", "size_bytes": 11878470, "source_url": "https://sam.gov/api/prod/fileextractservices/v1/api/download/Exclusions/Public%20V2/SAM_Exclusions_Public_Extract_V2_26291.ZIP?privacy=Public", "total_matching": 8365, "total_rows": 169040, "uncompressed_size_bytes": 78631673 } ``` ### Exclusions status - Capability: `opportunities/exclusions_status` - Description: Version check of the daily public exclusions extract (SAM_Exclusions_Public_Extract_V2_YYDDD.ZIP, Julian-dated, about 12 MB zip holding a 79 MB CSV): file name as publication_id, S3 Last-Modified, size and ETag from a 1 KB range read through the download route's 303, and the inner CSV's name and sizes from the zip local header. The zip fits the runner cap, so hand_off is false; exclusions_list reads it. record_count is null until a full read. - Instructions: Check for a new daily exclusions snapshot before exclusions_list, or to pin a publication. - Cost: 5 credits per call - Capability file: [Exclusions status](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/exclusions_status) Accepted options: - `file_name` (string): Pin one listed file name (default: the newest daily file). Example: `` Response schema example: ```json { "cadence": "daily full snapshot (Julian YYDDD stamp); no delta feed, diff consecutive snapshots", "content_hash": "a3236cae8121651415a56828f72dc690-2", "date_modified_label": "Oct 18,2026", "description": "This data package is refreshed daily and contains the publicly available data for all active exclusion records entered by the Federal government identifying those parties excluded from receiving Federal contracts, certain subcontracts, and certain types of Federal financial and non-financial assistance and benefits. This version of the file has the Unique Entity Identifier fields added. Users must read the exclusion record completely to understand how it impacts the excluded party. The links include the three-digit Julian date for easier identification of the most recent file.", "etag": "a3236cae8121651415a56828f72dc690-2", "file_date": "2026-10-18", "file_format": "ZIP, CSV", "file_name": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "file_url": "https://sam.gov/api/prod/fileextractservices/v1/api/download/Exclusions/Public%20V2/SAM_Exclusions_Public_Extract_V2_26291.ZIP?privacy=Public", "files_listed": [ { "date_modified": "Oct 18,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26291.ZIP" }, { "date_modified": "Oct 17,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26290.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26290.ZIP" }, { "date_modified": "Oct 16,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26289.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26289.ZIP" }, { "date_modified": "Oct 15,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26288.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26288.ZIP" }, { "date_modified": "Oct 14,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26287.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26287.ZIP" }, { "date_modified": "Oct 13,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26286.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26286.ZIP" }, { "date_modified": "Oct 12,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26285.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26285.ZIP" }, { "date_modified": "Oct 11,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26284.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26284.ZIP" }, { "date_modified": "Oct 10,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26283.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26283.ZIP" }, { "date_modified": "Oct 09,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26282.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26282.ZIP" }, { "date_modified": "Oct 08,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26281.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26281.ZIP" }, { "date_modified": "Oct 07,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26280.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26280.ZIP" }, { "date_modified": "Oct 06,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26279.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26279.ZIP" }, { "date_modified": "Oct 05,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26278.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26278.ZIP" }, { "date_modified": "Oct 04,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26277.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26277.ZIP" }, { "date_modified": "Oct 03,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26276.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26276.ZIP" }, { "date_modified": "Oct 02,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26275.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26275.ZIP" }, { "date_modified": "Oct 01,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26274.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26274.ZIP" }, { "date_modified": "Sep 30,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26273.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26273.ZIP" }, { "date_modified": "Sep 29,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26272.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26272.ZIP" }, { "date_modified": "Sep 28,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26271.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26271.ZIP" }, { "date_modified": "Sep 27,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26270.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26270.ZIP" }, { "date_modified": "Sep 26,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26269.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26269.ZIP" }, { "date_modified": "Sep 25,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26268.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26268.ZIP" }, { "date_modified": "Sep 24,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26267.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26267.ZIP" }, { "date_modified": "Sep 23,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26266.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26266.ZIP" }, { "date_modified": "Sep 22,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26265.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26265.ZIP" }, { "date_modified": "Sep 21,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26264.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26264.ZIP" }, { "date_modified": "Sep 20,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26263.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26263.ZIP" }, { "date_modified": "Sep 19,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26262.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26262.ZIP" }, { "date_modified": "Sep 18,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26261.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26261.ZIP" }, { "date_modified": "Sep 17,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26260.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26260.ZIP" }, { "date_modified": "Sep 16,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26259.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26259.ZIP" }, { "date_modified": "Sep 15,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26258.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26258.ZIP" }, { "date_modified": "Sep 14,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26257.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26257.ZIP" }, { "date_modified": "Sep 13,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26256.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26256.ZIP" }, { "date_modified": "Sep 12,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26255.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26255.ZIP" }, { "date_modified": "Sep 11,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26254.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26254.ZIP" }, { "date_modified": "Sep 09,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26252.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26252.ZIP" }, { "date_modified": "Sep 08,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26251.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26251.ZIP" }, { "date_modified": "Sep 07,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26250.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26250.ZIP" }, { "date_modified": "Sep 06,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26249.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26249.ZIP" }, { "date_modified": "Sep 05,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26248.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26248.ZIP" }, { "date_modified": "Sep 04,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26247.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26247.ZIP" }, { "date_modified": "Sep 03,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26246.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26246.ZIP" }, { "date_modified": "Sep 02,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26245.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26245.ZIP" }, { "date_modified": "Sep 01,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26244.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26244.ZIP" }, { "date_modified": "Aug 31,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26243.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26243.ZIP" }, { "date_modified": "Aug 30,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26242.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26242.ZIP" }, { "date_modified": "Aug 29,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26241.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26241.ZIP" }, { "date_modified": "Aug 28,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26240.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26240.ZIP" }, { "date_modified": "Aug 27,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26239.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26239.ZIP" }, { "date_modified": "Aug 26,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26238.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26238.ZIP" }, { "date_modified": "Aug 25,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26237.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26237.ZIP" }, { "date_modified": "Aug 24,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26236.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26236.ZIP" }, { "date_modified": "Aug 23,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26235.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26235.ZIP" }, { "date_modified": "Aug 22,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26234.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26234.ZIP" }, { "date_modified": "Aug 21,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26233.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26233.ZIP" }, { "date_modified": "Aug 20,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26232.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26232.ZIP" }, { "date_modified": "Aug 19,2026", "display_key": "SAM_Exclusions_Public_Extract_V2_26231.ZIP", "file_format": "ZIP, CSV", "key": "Exclusions/Public V2/SAM_Exclusions_Public_Extract_V2_26231.ZIP" } ], "hand_off": false, "hand_off_reason": null, "hash_source": "s3_etag", "inner_entry": { "compressed_size": 11878288, "method": 8, "name": "SAM_Exclusions_Public_Extract_V2_26291.CSV", "uncompressed_size": 78631673 }, "julian_stamp": "26291", "last_modified_header": "Sun, 18 Oct 2026 09:39:26 GMT", "listing_url": "https://sam.gov/api/prod/fileextractservices/v1/api/listfiles?domain=Exclusions/Public%20V2&privacy=Public", "publication_id": "SAM_Exclusions_Public_Extract_V2_26291.ZIP", "published_at": "2026-10-18T09:39:26Z", "record_count": null, "record_count_note": "known only after a full read; exclusions_list reports total_rows", "retrieved_at": "2026-10-18T22:35:42Z", "size_bytes": 11878470 } ``` ### Search - Capability: `opportunities/search` - Description: Search SAM.gov contract opportunities by keyword, agency, notice status, publication date, NAICS, set-aside, notice type and response deadline. Returns one page (default 20, max 100) with an opaque cursor for the next page. By default each hit is enriched with its full notice detail (NAICS, set-aside, place of performance, full description). - Instructions: Search SAM.gov contract opportunities by keyword, agency, notice status, publication date, NAICS, set-aside, notice type and response deadline. Returns one page (default 20, max 100) with an opaque cursor for the next page. By default each hit is enriched with its full notice detail (NAICS, set-aside, place of performance, full description). - Cost: 5 credits per call - Capability file: [Search](https://alexandria.firecrawl.dev/agents/providers/sam-gov/opportunities/search) Accepted options: - `agency_ids` (string[]): SAM.gov federal organization ids at any hierarchy level (100000000 = Dept of Defense, 300000188 = Dept of the Navy, 100006688 = Dept of Veterans Affairs). Matched as OR. Example: `[]` - `cursor` (string): Opaque cursor from a previous response's next_cursor. Bound to the same filters and page_size; valid for 24 hours; then cursor_expired. Example: `` - `include_attachments` (boolean): Also list each notice's attachments (one more upstream request per record). Requires include_details and page_size <= 50. Example: `false` - `include_details` (boolean): Fetch each hit's notice detail (one extra upstream request per record) so naics_codes, set_aside, place_of_performance and the full description are populated. false returns summary records with detail_level=summary. Example: `false` - `naics_codes` (string[]): NAICS codes or prefixes (2 to 6 digits). Matched as OR. Example: `[]` - `notice_types` (string[]): Notice types (SAM.gov codes p,o,k,a,r,s,i,g,u,f,l). Empty = all. Example: `[]` - `page_size` (number): Records per page. At most 50 when include_attachments is true. Example: `20` - `published_from` (string): Inclusive lower bound (YYYY-MM-DD, US Eastern calendar day) on the notice's latest publication/modification date. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `published_to` (string): Inclusive upper bound (YYYY-MM-DD). Must not be before published_from. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `query` (string): Keyword query matched against title, solicitation number and description. Multi-word queries combine per query_mode (default: every word must match). Empty matches everything. Example: `` - `query_mode` (string): How the words of query must match, as SAM.gov's own keyword search offers them (upstream qMode): all = every word (SAM.gov's default), any = at least one word, exact = the phrase as written. Example: `all` - `response_deadline_from` (string): Inclusive lower bound (YYYY-MM-DD) on the response deadline. Example: `` - `response_deadline_to` (string): Inclusive upper bound (YYYY-MM-DD) on the response deadline. Example: `` - `set_asides` (string[]): SAM.gov set-aside codes (SBA = total small business, 8A, HZC = HUBZone, SDVOSBC, WOSB, EDWOSB, ...). Matched as OR. Example: `[]` - `sort` (string): sort Example: `updated_desc` - `statuses` (string[]): Notice status as SAM.gov indexes it. active = accepting responses / not yet archived; inactive = archived. Both = no status filter. Example: `[]` Response schema example: ```json { "complete": true, "next_cursor": "s1:1:2:c88f395baad286d7:1788986400", "page": { "max_records": 10000, "number": 0, "size": 2, "total_pages": 458 }, "records": [ { "agency": { "id": "100000000", "name": "DEPT OF DEFENSE" }, "archive": null, "attachments": [], "attachments_retrieved": false, "award": null, "classification_code": null, "description": "The Naval Air Warfare Center Aircraft Division (NAWC-AD) is officially releasing a Request for Quote (RFQ) for a Firm Fixed Price (FFP) contract on a competitive basis for the procurement of one (1) Cart Adapter, P/N 70700-77200-041, in supp", "description_is_excerpt": true, "detail_level": "summary", "history": null, "is_active": true, "is_amendment": false, "is_archived": null, "is_cancelled": false, "is_latest": null, "latest_opportunity_id": null, "modification_count": 0, "naics_codes": [], "notice_type": "solicitation", "notice_type_code": "o", "notice_type_label": "Solicitation", "office": { "id": "100255266", "name": "NAVAIR WARFARE CTR AIRCRAFT DIV" }, "opportunity_id": "d4b105e622e348b8ad8af095acaa7648", "organization_hierarchy": [ { "code": "9700", "id": "100000000", "level": 1, "name": "DEPT OF DEFENSE", "type": "DEPARTMENT" }, { "code": "1700", "id": "300000188", "level": 2, "name": "DEPT OF THE NAVY", "type": "AGENCY" }, { "code": "NAVAIR", "id": "100005067", "level": 3, "name": "NAVAIR", "type": "MAJOR COMMAND" }, { "code": "NAVAIR NAWC AD", "id": "100005150", "level": 4, "name": "NAVAIR NAWC AD", "type": "SUB COMMAND" }, { "code": "N68335", "id": "100255266", "level": 5, "name": "NAVAIR WARFARE CTR AIRCRAFT DIV", "type": "OFFICE" } ], "parent_opportunity_id": null, "place_of_performance": null, "points_of_contact": [], "previous_opportunity_id": null, "published_at": "2026-09-09T19:14:30Z", "response_deadline": "2026-10-01T19:00:00Z", "response_deadline_date": "2026-10-01", "response_deadline_local": "2026-10-01T15:00:00-04:00", "response_timezone": "America/New_York", "set_aside": null, "set_aside_label": null, "solicitation_number": "N6833526Q1069", "source_status": "active", "source_url": "https://sam.gov/opp/d4b105e622e348b8ad8af095acaa7648/view", "status": "open", "title": "Cart Adapter", "updated_at": "2026-09-09T19:14:30Z", "version": null }, { "agency": { "id": "100000000", "name": "DEPT OF DEFENSE" }, "archive": null, "attachments": [], "attachments_retrieved": false, "award": null, "classification_code": null, "description": "**Amendment 0002**\n\nThis amendment is answer questions received by contactors (see Q&A attachment) and to revise the PWS (changes are in red on attachment) and are as follows:\n\nThe Contractor shall provi", "description_is_excerpt": true, "detail_level": "summary", "history": null, "is_active": true, "is_amendment": true, "is_archived": null, "is_cancelled": false, "is_latest": null, "latest_opportunity_id": null, "modification_count": 2, "naics_codes": [], "notice_type": "combined_synopsis_solicitation", "notice_type_code": "k", "notice_type_label": "Combined Synopsis/Solicitation", "office": { "id": "500020367", "name": "FA8601 AFLCMC PZIO" }, "opportunity_id": "e4b01867044a4f0b9b56d506297ba84b", "organization_hierarchy": [ { "code": "9700", "id": "100000000", "level": 1, "name": "DEPT OF DEFENSE", "type": "DEPARTMENT" }, { "code": "5700", "id": "300000251", "level": 2, "name": "DEPT OF THE AIR FORCE", "type": "AGENCY" }, { "code": "AFMC", "id": "100000570", "level": 3, "name": "AIR FORCE MATERIEL COMMAND", "type": "MAJOR COMMAND" }, { "code": "AFLCMC", "id": "100000997", "level": 4, "name": "AIR FORCE LIFE CYCLE MANAGEMENT CENTER", "type": "SUB COMMAND" }, { "code": "FA8601", "id": "500020367", "level": 5, "name": "FA8601 AFLCMC PZIO", "type": "OFFICE" } ], "parent_opportunity_id": "a9da8c51e84a4b72a9897a6f483845e3", "place_of_performance": null, "points_of_contact": [], "previous_opportunity_id": null, "published_at": "2026-09-09T19:05:08Z", "response_deadline": "2026-09-15T16:00:00Z", "response_deadline_date": "2026-09-15", "response_deadline_local": "2026-09-15T12:00:00-04:00", "response_timezone": "America/New_York", "set_aside": null, "set_aside_label": null, "solicitation_number": "FA860126Q0141", "source_status": "active", "source_url": "https://sam.gov/opp/e4b01867044a4f0b9b56d506297ba84b/view", "status": "open", "title": "HVAC CLEANING", "updated_at": "2026-09-09T19:05:08Z", "version": null } ], "retrieved_at": "2026-09-09T00:00:00Z", "schema_version": "1.0.0", "source_updated_at": null, "source_url": "https://sam.gov/api/prod/sgs/v1/search/?index=opp&mode=search&q=cybersecurity&page=0&size=2&sort=-modifiedDate&is_active=true", "total_count": 916, "upstream_requests": 1, "warnings": [ "include_details=false: naics_codes, set_aside, place_of_performance and attachments are not populated on summary records" ] } ```