# OneShot Agent API – Federal Register Record Search

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

Search and retrieve documents from the U.S. Federal Register by keyword, agency, document type, and date range

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/record-federal-register?utm_source=zero.xyz
- Price: $0.005/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-federal-register-record-search-ed3b46bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-l_y2zNpfbdKVtB4CtICC

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-federal-register-record-search-ed3b46bd -d '<json body>'
```

Example prompt: Search the Federal Register for up to 5 proposed rules from the Federal Aviation Administration about drone registration published after 2024-01-01.

## When to prefer this

Use this endpoint when an agent needs to find specific U.S. federal regulatory documents — rules, proposed rules, notices, or presidential documents — by topic, agency, or date range. It is ideal for regulatory research, compliance monitoring, and policy tracking workflows. Prefer this over general web search when you need structured, authoritative metadata (PDF URLs, document numbers, abstracts) directly from the Federal Register source.

## Known failure modes

- Invalid agency slug returns no results or an error — must use the Federal Register's official agency slug format (e.g. 'federal-aviation-administration')
- Invalid document type enum value causes a validation error
- Date format must be YYYY-MM-DD; malformed dates may return an error or no results
- Query too vague or misspelled may return zero results despite matching documents existing
- Payment failure via x402/USDC may block the call before any search is attempted

## How this service works

Find the rules, proposed rules and notices the US government published in the Federal Register that match search words.

## Output

Returns a JSON object with a total count of matching documents and an array of document records, each containing the title, URL, PDF URL, abstract, list of agencies, publication date, document number, and document type (rule, proposed rule, notice, or presidential).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "rule",
    "proposed_rule",
    "notice",
    "presidential"
   ],
   "type": "string",
   "description": "Only this kind of document"
  },
  "limit": {
   "type": "integer",
   "description": "The most documents to return. From 1 to 20. Defaults to `10`."
  },
  "query": {
   "type": "string",
   "description": "Search words, for example drone registration. 2 to 200 characters."
  },
  "agency": {
   "type": "string",
   "description": "Only documents from this agency, as its Federal Register slug, for example federal-aviation-administration. 2 to 80 characters."
  },
  "published_after": {
   "type": "string",
   "description": "Only documents published on or after this date. Use YYYY-MM-DD."
  },
  "published_before": {
   "type": "string",
   "description": "Only documents published on or before this date. Use YYYY-MM-DD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 43,
  "documents": [
   {
    "url": "https://www.federalregister.gov/documents/2026/07/17/2026-14439/establishing-a-fixed-time-period-of-admission-and-an-extension-of-stay-procedure-for-nonimmigrant",
    "type": "Rule",
    "title": "Establishing a Fixed Time Period of Admission and an Extension of Stay Procedure for Nonimmigrant Academic Students, Exchange Visitors, and Representatives of Foreign Information Media",
    "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-07-17/pdf/2026-14439.pdf",
    "abstract": "The Department of Homeland Security (DHS) is amending its regulations to change the admission period in the F, J, and I classifications from duration of status to an admission for a fixed time period.",
    "agencies": [
     "Homeland Security Department"
    ],
    "published_on": "2026-07-17",
    "document_number": "2026-14439"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-federal-register-record-search-ed3b46bd/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)