# OneShot Agent API – Find Federal Record Solicitations

> OneShot Agent API – Find Federal Record Solicitations is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-19).

Search and filter active U.S. federal government solicitations from SAM.gov by NAICS code, agency, keywords, set-aside type, state, and notice type

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/record-solicitations?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-find-federal-record-solicitations-562a466f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tgcUVx4VDziLfclXIZhVc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-find-federal-record-solicitations-562a466f -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought and Presolicitation notices with the contracting officer's published contact. Flat price per search.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-find-federal-record-solicitations-562a466f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)