# 2s.io Congress Bill Lookup

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

Look up or search US Congressional bills via the Library of Congress Congress.gov API, returning bill metadata like title, sponsors, latest action, and policy area

## Facts

- Endpoint: GET https://2s.io/api/gov/congress-bill
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-fe5909a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j0j8Gg2M_N9igJsJCFM3C

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 2s-io-fe5909a6
```

Example prompt: Can you pull up the details on House Bill 1234 from the 119th Congress — I want the title, sponsors, latest action, and what policy area it falls under?

## When to prefer this

Use this endpoint when you need authoritative, structured US Congressional bill data sourced directly from the Library of Congress. Prefer it over web scraping or general search when you need specific bill metadata (sponsors, actions, amendments, committee counts, policy area) for a known bill or want to enumerate bills filtered by type, congress session, and date range with reliable pagination.

## Known failure modes

- Invalid or non-existent bill number returns empty result or 404
- Unsupported bill type enum value returns validation error
- Congress number out of historical range returns no results
- fromDate/toDate in wrong format causes parsing error
- Rate limit or payment failure (x402) blocks the request
- Offset beyond total results returns empty list

## How this service works

Look up or search US Congressional bills via the Library of Congress Congress.gov API. Pass congress + type + number to fetch a specific bill (title, sponsors, latest action, action/amendment/committee counts, policy area, congress.gov URL). Or omit number to list bills filtered by congress, bill type (hr | s | hjres | sjres | hconres | sconres | hres | sres), date range, with pagination + sort. Bill type semantics: hr=House Bill, s=Senate Bill, hjres/sjres=joint resolution, hconres/sconres=concurrent resolution, hres/sres=simple resolution.

## Output

Returns bill metadata including title, sponsor information, latest action taken, counts of actions/amendments/committees, policy area classification, and a direct congress.gov URL. When listing (no bill number), returns a paginated array of bills filtered by congress, type, and optional date range.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "type": "hr",
   "limit": 10,
   "congress": 119
  }
 }
}
```

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "sort": {
       "enum": [
        "updateDate+desc",
        "updateDate+asc"
       ],
       "type": "string",
       "default": "updateDate+desc"
      },
      "type": {
       "enum": [
        "hr",
        "s",
        "hjres",
        "sjres",
        "hconres",
        "sconres",
        "hres",
        "sres"
       ],
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 250,
       "minimum": 1
      },
      "number": {
       "type": "integer",
       "description": "Bill number. Omit to list."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      },
      "toDate": {
       "type": "string"
      },
      "congress": {
       "type": "integer",
       "minimum": 1,
       "description": "Congress number, e.g. 119 for 2025-2027."
      },
      "fromDate": {
       "type": "string",
       "description": "ISO date YYYY-MM-DD, listing only."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-fe5909a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)