# legislative-timeline

> legislative-timeline is a paid API for AI agents from payai.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 within a specified date window, including introduced, committee, passed, and enacted events with dates and source actions.

## Facts

- Endpoint: GET https://payai.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/legislative-timeline-f7d615e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9vGM3jkyUMBPbfc_Pl1jB

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 legislative-timeline-f7d615e4
```

Example prompt: What lifecycle stages did HR 3076 from the 118th Congress reach since January 1, 2024? I want to know if it was introduced, passed committee, passed the chamber, or enacted, with the dates for each.

## When to prefer this

Use this endpoint when you need to know which legislative stages a specific US federal bill has reached within a defined time period, sourced authoritatively from Congress.gov. Prefer this over general web search when you need structured, date-stamped lifecycle events rather than news articles or summaries. Ideal for policy monitoring agents, legislative trackers, or compliance workflows that need to detect bill progression automatically.

## Known failure modes

- Invalid or unrecognized bill ID format returns an error or empty result
- Bill not found for given congress, type, and number combination returns empty or 404-like response
- Date window with no events returns an empty events array
- Missing required parameters (bill_id or billType+billNumber+congress) returns a validation error
- Congress.gov data lag may mean very recent actions are not yet reflected

## 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 list of lifecycle events for the specified bill within the requested date window. Each event includes the stage name (e.g. introduced, committee, passed, enacted), the date it occurred, and the source action from Congress.gov that triggered the stage change.

## 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/legislative-timeline-f7d615e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)