{"uid":"cap_9vGM3jkyUMBPbfc_Pl1jB","slug":"legislative-timeline-f7d615e4","name":"legislative-timeline","description":"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.","url":"https://payai.agentstools.dev/legislative/timeline","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SBpWvhj3L52kz2FoamcaH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Track bill enactment after committee markup","prompt":"Did S 1234 from the 118th Congress move past committee or get enacted in the last 90 days? Show me each stage it reached with the dates."},{"title":"Monitor newly introduced legislation","prompt":"Has HR 7521 from the 118th Congress been introduced or seen any legislative movement since March 1, 2024?"},{"title":"Policy research on bill progression","prompt":"I'm researching federal climate legislation — can you pull the full lifecycle timeline for HJRES 98 from the 118th Congress and tell me every stage it reached and when?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:58:52.210Z","isFirstParty":false}