# US Federal Bill Search

> US Federal Bill Search is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search US federal bills by keyword with optional filters for Congress number, sponsor, and policy area, returning ranked matching bills with IDs, titles, and latest actions

## Facts

- Endpoint: GET https://api.agentstools.dev/legislative/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-federal-bill-search-40d4441e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sSLOVMumfIOXkxZ4vaNev

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 us-federal-bill-search-40d4441e
```

Example prompt: Search Congress.gov for federal bills about 'clean energy' in the 118th Congress — show me up to 15 results with their titles and latest actions.

## When to prefer this

Use this endpoint when you need to search and discover US federal legislation by topic, keyword, sponsor, or policy area. Prefer this over manual Congress.gov browsing when building automated legislative monitoring, policy research tools, or when an agent needs to surface relevant bills for a given subject quickly. Best when you need a ranked list of bills rather than deep detail on a single known bill.

## Known failure modes

- No bills found matching the keyword — returns empty list
- Invalid Congress number — returns error or empty results
- Query too broad returns maximum 25 results with no guarantee of relevance ranking
- Rate limit or payment failure returns 402 or 429 error
- Sponsor name not found returns empty filtered results

## How this service works

Search US federal bills by keyword (optionally within one Congress) and get a ranked list of matching bills with id, title and latest action. Source: Congress.gov, public-domain.

## Output

A ranked list of matching US federal bills, each with a bill ID, title, and latest legislative action taken, sourced from Congress.gov public-domain data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword / phrase to search bill text"
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Max bills to return, default 10"
      },
      "keyword": {
       "type": "string",
       "description": "Alias for q"
      },
      "sponsor": {
       "type": "string",
       "description": "Optional sponsor name filter"
      },
      "congress": {
       "type": "integer",
       "description": "Optional Congress number to scope the search"
      },
      "policyArea": {
       "type": "string",
       "description": "Optional policy-area keyword to filter results"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-federal-bill-search-40d4441e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)