{"uid":"cap_YFd8Y1tyITLqKphcx8U8I","slug":"us-federal-bill-legislative-timeline-15facd2c","name":"US Federal Bill 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://api.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_qy1KFZJuZkVzs2Hz9Pmjh","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 (introduced, committee, passed, enacted) within a given date window, with dates and source actions from Congress.gov","exampleAgentPrompt":"What lifecycle stages has HR 3076 from the 118th Congress reached? Show me all events since January 1, 2024.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:52:55.253Z","isFirstParty":false}