# US Congress Bill Status Lookup

> US Congress Bill Status Lookup is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Looks up official US congressional bill records by congress number, bill type, and bill number, returning title, sponsor, latest action, policy area, committee referrals, and counts of actions, cosponsors, and amendments.

## Facts

- Endpoint: POST https://x402.forgemesh.io/congress-bill-lookup
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-congress-bill-status-lookup-aeaf5c94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N58Ea1E-BTaC2r14WYXV1

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-congress-bill-status-lookup-aeaf5c94 -d '<json body>'
```

Example prompt: What's the current status of House bill HR 1 in the 119th Congress — can you get the title, sponsor, latest action, and policy area?

## When to prefer this

Choose this endpoint when you need authoritative, structured US congressional bill data — title, sponsor, latest action, policy area, committee referrals, and counts — keyed by congress number, bill type, and bill number. Prefer it over web scraping or general search when you need deterministic, reproducible lookups from official Congress.gov data without maintaining your own legislative database or API key.

## Known failure modes

- Invalid bill type string returns an error or empty result
- Non-existent bill number for the given congress returns no data
- Malformed congress number (e.g. non-numeric) causes a validation error
- Bill exists but has no latest action recorded yet
- Cache may return data up to one hour old, missing very recent congressional actions

## How this service works

US bill status lookup: pass congress number, bill type, and bill number and get the official record — title, sponsor, latest action with date, policy area, committee referrals, and counts of actions, cosponsors, and amendments with links to each. Deterministic input, cached one hour. For legislative-tracking, policy, and news agents.

## Output

A JSON object containing the bill's type, title, number, congress session, sponsor name(s), policy area, latest action text and date, committee referrals, and counts of total actions, cosponsors, and amendments, plus an attribution note citing Congress.gov as the public domain source. Results are cached for one hour.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string",
   "description": "bill type: hr, s, hjres, sjres, hconres, sconres, hres, sres (default hr)"
  },
  "number": {
   "type": "string",
   "description": "bill number, e.g. '1' (default 1)"
  },
  "congress": {
   "type": "string",
   "description": "congress number, e.g. '119' (default 119)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "bill": {
    "type": "S",
    "title": "National Defense Authorization Act example",
    "number": "2226",
    "congress": 118,
    "sponsors": [
     {
      "fullName": "Sen. Example"
     }
    ],
    "policyArea": {
     "name": "Armed Forces and National Security"
    },
    "latestAction": {
     "text": "Became Public Law",
     "actionDate": "2024-12-11"
    }
   }
  },
  "attribution": "Congress.gov (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-congress-bill-status-lookup-aeaf5c94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)