# US Federal Bill Legislative Timeline

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

Returns the lifecycle stages a US federal bill reached (introduced, committee, passed, enacted) within a given date window, with dates and source actions from Congress.gov

## Facts

- Endpoint: GET https://api.agentstools.dev/legislative/timeline
- Price: $0.015/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-legislative-timeline-15facd2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YFd8Y1tyITLqKphcx8U8I

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-legislative-timeline-15facd2c
```

Example prompt: What lifecycle stages has HR 3076 from the 118th Congress reached? Show me all events since January 1, 2024.

## When to prefer this

Use this endpoint when you need a structured, cited diff of a US federal bill's legislative milestones — especially for change detection over a date window (e.g. 'what happened in the last N days?'). Prefer over general legislative search APIs when you already know the bill ID and need stage-level granularity with source citations rather than full bill text or vote details.

## Known failure modes

- Invalid bill_id format returns 400 with validation error
- Unknown bill or congress number returns 404 or empty event list
- Missing required bill identifier (no bill_id and no billType+billNumber+congress) returns 400
- Invalid ISO date for 'since' parameter returns 400
- Congress.gov upstream unavailability may return 503 or timeout

## How this service works

Stateless event diff for a US federal bill: which lifecycle stages it reached over a date window (introduced, committee, passed, enacted), each with date and source action. Source: Congress.gov, public-domain.

## Output

A stateless event diff listing each lifecycle stage the bill reached (e.g. introduced, referred to committee, passed House, enacted), each annotated with its date and the source action text from Congress.gov, filtered to the requested date window.

## 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": {
      "since": {
       "type": "string",
       "description": "Only events on or after this ISO date, e.g. 2024-01-01"
      },
      "bill_id": {
       "type": "string",
       "description": "Bill id like hr3076-118 (billtype+number-congress)"
      },
      "billType": {
       "enum": [
        "hr",
        "s",
        "hjres",
        "sjres",
        "hconres",
        "sconres",
        "hres",
        "sres"
       ],
       "type": "string",
       "description": "Bill type"
      },
      "congress": {
       "type": "integer",
       "description": "Congress number (with billType+billNumber)"
      },
      "billNumber": {
       "type": "integer",
       "description": "Bill number"
      },
      "window_days": {
       "type": "integer",
       "description": "Alternatively, events within the last N days"
      }
     }
    }
   },
   "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-legislative-timeline-15facd2c/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)