{"uid":"cap_tgcUVx4VDziLfclXIZhVc","slug":"oneshot-agent-api-find-federal-record-solicitations-562a466f","name":"OneShot Agent API – Find Federal Record Solicitations","description":"Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought and Presolicitation notices with the contracting officer's published contact. Flat price per search.","url":"https://win.oneshotagent.com/v1/tools/find/record-solicitations?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (1-500, default 100)"},"naics":{"type":"array","items":{"type":"string"},"description":"6-digit NAICS codes (1-20)"},"state":{"type":"string","description":"Place-of-performance state code"},"agencies":{"type":"array","items":{"type":"string"},"description":"Agency-name substrings to keep"},"keywords":{"type":"array","items":{"type":"string"},"description":"Title / full-text keywords"},"set_aside":{"type":"string","description":"Set-aside code (SBA, 8A, HZC, SDVOSBC, WOSB, ...)"},"since_days":{"type":"number","description":"Look-back window for posted date (1-365, default 30)"},"active_only":{"type":"boolean","description":"Default true: drop archived notices and past response deadlines"},"has_contact":{"type":"boolean","description":"Only notices with a name + email point of contact"},"notice_types":{"type":"array","items":{"enum":["r","p","o","k","s","a","u","i","g"],"type":"string"},"description":"SAM.gov notice types: r=Sources Sought, p=Presolicitation, o=Solicitation, k=Combined Synopsis, s=Special Notice, a=Award. Default [\"r\",\"p\"]"},"include_description":{"type":"boolean","description":"Default true: fetch description bodies for the first rows"}}},"responseSchema":{"type":"json","example":{"status":"processing","request_id":"uuid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZtJPb6bClzdD6zFOyueff","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter active U.S. federal government solicitations from SAM.gov by NAICS code, agency, keywords, set-aside type, state, and notice type","exampleAgentPrompt":"Find active federal solicitations posted in the last 60 days for IT staffing services — NAICS code 541512 — that are set aside for small businesses (SBA), limited to the state of Virginia, sources sought and presolicitation notice types only, and only show ones with a contact name and email, up to 50 results.","exampleUseCases":[{"title":"Targeting defense IT contracts","prompt":"Search for active federal solicitations in the last 90 days from the Department of Defense for cybersecurity work — NAICS 541519 — set aside for service-disabled veteran-owned small businesses (SDVOSBC), any state, solicitations and combined synopsis notices only, up to 100 results with descriptions."},{"title":"Small business BD pipeline research","prompt":"Find sources sought and presolicitation notices posted in the last 30 days for environmental consulting services — NAICS codes 541620 and 562910 — that are 8A set-asides in Texas or Colorado, and only include notices that have a point of contact email, limit to 25 results."},{"title":"Monitoring active bids in a niche industry","prompt":"Pull up to 200 active federal solicitation notices from the last 14 days for food service and catering — NAICS 722310 — from any agency, all notice types including awards and special notices, across the whole country, include the description text so I can review scope."}],"resultDescription":"Returns a JSON object with a status field ('processing') and a request_id (UUID) that can be used to retrieve the filtered list of matching SAM.gov solicitation records, including notice titles, types, agencies, set-aside codes, place of performance, response deadlines, and optionally full description bodies and point-of-contact details.","failureModes":["Invalid NAICS code format returns validation error","since_days outside 1-365 range rejected","Unsupported set-aside code returns error","No matching solicitations returns empty results array","Payment failure over x402 prevents execution","Response deadline already passed when active_only=true filters out results","Rate limiting if called excessively in short window"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover or monitor U.S. federal government contract opportunities from SAM.gov without a traditional API key subscription. It is ideal for business development automation, small business set-aside screening, NAICS-targeted opportunity pipelines, or compliance research. Prefer this over manual SAM.gov browsing or enterprise procurement tools when cost-per-call efficiency matters and the use case is agent-driven or programmatic. Not suitable for non-U.S. procurement markets or private-sector RFP databases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:38:54.744Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-find-federal-record-solicitations-562a466f"}