> ## Documentation Index > Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt > Use this file to discover all available pages before exploring further. # Legislative bills > Legislative measures and their derived action stages, with whole-population stage counts and bounded result pages. ## OpenAPI ````yaml https://astreus.ai/openapi.json get /api/v1/countries/{iso}/government/bills openapi: 3.1.0 info: title: Astreus API version: '2026-11-11' description: >- Astreus is a financial data terminal that turns the world's unstructured financial disclosure into structured, traceable data. It reads what companies, exchanges and central banks publish — annual and interim reports, SEC filings, results announcements, investor presentations, earnings calls, 8-Ks, regulator notices and policy text — across the United States, the Gulf (Tadawul, DFM, ADX, Boursa Kuwait, QSE), Japan, Taiwan, Korea, the UK and Europe, and serves it as data a program can trust: standardized financial statements (annual, quarterly, semiannual), segments and KPIs, the tables inside the notes, filing sections as text, investor decks page by page, earnings-call transcripts and audio, span-anchored observations, management guidance scored against outcomes, typed 8-K events, an attributed intraday news tape, insider and 13F ownership, a people registry, macro series (the current vintage: the latest published value for each period) and central-bank text, benchmark, commodity and compute-price series, and a source-linked claim graph with declared validation limits. Use `fact-source` and document metadata to retain available provenance. Publication and entitlement gates apply per dataset; inspect availability and tool limitations. Coverage is published live: `GET /api/v1/landing/coverage` (no key) returns every market served with company counts, history depth, completeness and periods held per data type — ask it before answering "what do you cover?". `{id}` is a ticker, a numeric SEC CIK, or a platform key for a non-SEC issuer (XSAU000001) — the `cik` field of the company payload. Human-readable guides: https://doc.astreus.ai (coverage at /coverage, data catalog at /data-catalog). Tiers: `public` endpoints need no credentials. Everything else takes an **API key** — create one on the Developers page in the terminal (https://astreus.ai/developers) and send it as `X-API-KEY: pk_live_...` (or `Authorization: Bearer pk_live_...`). Signed-in terminal sessions may use their Cognito ID token instead. Rate limits and quotas are per plan (fixed UTC windows): Free — 30 req/min, 250 req/day; Build — 300 req/min, 100,000 req/month; Scale — custom. Build, Scale and prepaid credits are set up with sales (https://astreus.ai/contact), not self-serve. Responses carry RateLimit-*, X-Quota-* and, when credits pay, X-Billing-Source/X-Credits-Remaining-USD headers; a 429 carries `Retry-After` and a machine `code` of rate_limited or quota_exceeded (with sales_email). Server-side use: `/api/v1` sends no CORS headers, so a browser page on another origin cannot call it. Call it from a server, a script or an agent, and keep the key there. Versioning: `info.version` is the UTC date the contract last changed, and every response carries it in `x-astreus-api-version`. Within `/api/v1` changes are additive; a field or parameter that will go is marked `deprecated` first and kept for at least 90 days. Policy: https://doc.astreus.ai/versioning. Not investment advice. See /terms. contact: email: saif@astreus.ai termsOfService: https://astreus.ai/terms license: name: 'Proprietary: Astreus terms of service' url: https://astreus.ai/terms servers: - url: https://astreus.ai security: [] tags: - name: Search & Meta description: Entity resolution and platform metadata. - name: Company Data description: Profiles, structure, leadership, calendars. - name: Geo & Assets description: >- Physical assets on the map — what a company owns, operates or develops, where, since when, at what location precision, and the source behind each fact. - name: Financial Statements description: >- Standardized XBRL-derived statements — every line traceable to its filing via fact provenance. - name: SEC Filings description: >- The filing index and documents (SEC and exchange-published), parsed section text, and the tables inside the notes as gated grids and series. - name: 8-K Events description: >- Material events: 8-K items and exchange disclosures by item code, filterable by family, with extracted item text. - name: News description: >- The intraday news tape: filings, releases and licensed wires with source attribution, storylines and topics. - name: Transcripts & Calls description: Earnings-call transcripts, span-anchored observations, IR decks. - name: Guidance & Scorecards description: What management promised vs. what happened. - name: Ownership & Insiders description: 13F holders, Forms 3/4/5, the people registry. - name: Macro description: >- Economic series (the current vintage: the latest published value for each period) and central-bank text. - name: Market Data description: Daily bars for stocks, benchmarks, commodities and compute. - name: Intelligence description: Narratives and source-linked claims with declared validation status. - name: Analytics description: Charting over any catalog series. paths: /api/v1/countries/{iso}/government/bills: get: tags: - Macro summary: Legislative bills description: >- Legislative measures and their derived action stages, with whole-population stage counts and bounded result pages. operationId: get-legislative-bills parameters: - name: iso in: path required: true description: ISO alpha-2 country code. schema: type: string - name: congress in: query description: >- Congress number (1–200) or all; default the newest held. A congress not held falls back to the newest. schema: type: string - name: stage in: query description: Action stage. schema: type: string enum: - introduced - passed_one - cleared - law - vetoed - name: voted in: query description: 1 to require a recorded vote. schema: type: string enum: - '1' - '0' - name: q in: query description: Title contains; max 120 characters. schema: type: string - name: limit in: query description: Rows per page, 1–200; default 50. schema: type: integer minimum: 1 maximum: 200 default: 50 - name: offset in: query description: Rows to skip. schema: type: integer minimum: 0 default: 0 responses: '200': description: OK content: application/json: schema: type: object properties: iso2: type: string available: type: boolean load: type: object properties: isSample: type: boolean inProgress: type: boolean unrecorded: type: boolean lastLoadedAt: type: string format: date-time stale: type: boolean staleLanes: type: array items: type: string failedLanes: type: array items: {} runs: type: array items: type: object properties: sourceCode: type: string lane: type: string mode: type: string status: type: string rowsWritten: type: integer finishedAt: type: string format: date-time congress: type: - integer - 'null' congresses: type: array items: type: integer stage: type: 'null' voted: type: boolean query: type: 'null' total: type: integer stageCounts: type: object properties: introduced: type: integer passed_one: type: integer cleared: type: integer law: type: integer vetoed: type: integer votedCounts: type: object properties: introduced: type: integer passed_one: type: integer cleared: type: integer law: type: integer vetoed: type: integer offset: type: integer limit: type: integer bills: type: array items: type: object properties: congress: type: integer billType: type: string billNumber: type: integer label: type: string title: type: string introducedDate: type: string format: date originChamber: type: string policyArea: type: 'null' sponsor: type: object properties: bioguideId: type: string name: type: string party: type: string stateCode: type: string personKey: type: string cosponsorCount: type: integer latestActionDate: type: string format: date latestActionText: type: string lawNumber: type: 'null' summary: type: 'null' url: type: string subjects: type: array items: {} stage: type: string measureClass: type: string passedHouse: type: boolean passedSenate: type: boolean committees: type: array items: type: object properties: systemCode: type: string name: type: string activity: type: string actions: type: array items: type: object properties: seq: type: integer date: type: string format: date chamber: type: - string - 'null' type: type: string text: type: string cosponsors: type: array items: type: object properties: bioguideId: type: string name: type: string party: type: string stateCode: type: string personKey: type: string sponsorshipDate: type: string format: date isOriginal: type: boolean withdrawnDate: type: 'null' votes: type: array items: {} description: >- Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls. x-schema-source: inferred example: iso2: US available: true load: isSample: false inProgress: false unrecorded: false lastLoadedAt: '2026-09-19T01:51:46.741Z' stale: true staleLanes: - govinfo/bills failedLanes: [] runs: - sourceCode: govinfo lane: bills mode: backfill status: succeeded rowsWritten: 2803741 finishedAt: '2026-09-19T01:51:46.741Z' congress: 119 congresses: - 119 - 118 stage: null voted: false query: null total: 18956 stageCounts: introduced: 17380 passed_one: 1424 cleared: 38 law: 112 vetoed: 2 votedCounts: introduced: 94 passed_one: 344 cleared: 8 law: 61 vetoed: 2 offset: 0 limit: 2 bills: - congress: 119 billType: hr billNumber: 10477 label: H.R. 10477 title: >- To amend the Sarbanes-Oxley Act of 2002 to exclude the audits of privately held, non-carrying brokers and dealers that are in good standing from certain requirements under title I of that Act, and for… introducedDate: '2026-09-17' originChamber: house policyArea: null sponsor: bioguideId: H001072 name: J. French Hill party: R stateCode: AR personKey: USGVP00026 cosponsorCount: 0 latestActionDate: '2026-09-17' latestActionText: Referred to the House Committee on Financial Services. lawNumber: null summary: null url: >- https://www.congress.gov/bill/119th-congress/house-bill/10477 subjects: [] stage: introduced measureClass: bill passedHouse: false passedSenate: false committees: - systemCode: hsba00 name: Committee on Financial Services activity: Referred To actions: - seq: 3 date: '2026-09-17' chamber: house type: IntroReferral text: Referred to the House Committee on Financial Services. - seq: 2 date: '2026-09-17' chamber: null type: IntroReferral text: Introduced in House cosponsors: [] votes: [] - congress: 119 billType: hr billNumber: 10478 label: H.R. 10478 title: >- To direct the Secretary of Veterans Affairs to establish a pilot program to arrange for qualified pension assistance organizations to provide claims development support to veterans and beneficiaries, … introducedDate: '2026-09-17' originChamber: house policyArea: null sponsor: bioguideId: R000612 name: John W. Rose party: R stateCode: TN personKey: USGVP00443 cosponsorCount: 3 latestActionDate: '2026-09-17' latestActionText: Referred to the House Committee on Veterans' Affairs. lawNumber: null summary: null url: >- https://www.congress.gov/bill/119th-congress/house-bill/10478 subjects: [] stage: introduced measureClass: bill passedHouse: false passedSenate: false committees: - systemCode: hsvr00 name: Committee on Veterans' Affairs activity: Referred To actions: - seq: 3 date: '2026-09-17' chamber: house type: IntroReferral text: Referred to the House Committee on Veterans' Affairs. - seq: 2 date: '2026-09-17' chamber: null type: IntroReferral text: Introduced in House cosponsors: - bioguideId: B001309 name: Tim Burchett party: R stateCode: TN personKey: USGVP00070 sponsorshipDate: '2026-09-17' isOriginal: true withdrawnDate: null - bioguideId: M001216 name: Cory Mills party: R stateCode: FL personKey: USGVP00363 sponsorshipDate: '2026-09-17' isOriginal: true withdrawnDate: null votes: [] '400': description: >- A query parameter the route does not take (unknown_parameter), a value outside its type, enum or range (invalid_parameter), or a required one missing (missing_parameter); `param` names it. A request refused against this spec's parameter list is not metered. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Unknown company, country, symbol or resource. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited. Honour Retry-After. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] - cognitoIdToken: [] components: schemas: Error: type: object required: - error - code properties: error: type: string description: Human-readable message. It may change; branch on `code`. code: type: string description: >- Stable machine code; every error carries one. unknown_parameter, invalid_parameter and missing_parameter come with `param`; unknown_parameter also with `allowed`. A route may add codes of its own (e.g. key_limit); treat an unlisted code by its HTTP status. enum: - unknown_parameter - invalid_parameter - missing_parameter - invalid_request - unauthenticated - upgrade_required - forbidden - not_found - conflict - too_large - unsupported_media_type - rate_limited - quota_exceeded - auth_unavailable - upstream_unavailable - internal_error param: type: string description: The query parameter at fault, when one is. allowed: type: array items: type: string description: 'With unknown_parameter: every query parameter the route takes.' securitySchemes: apiKey: type: apiKey in: header name: X-API-KEY description: >- Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as `Authorization: Bearer pk_live_...`. x-default: pk_live_YOUR_KEY cognitoIdToken: type: http scheme: bearer bearerFormat: JWT description: >- Amazon Cognito ID token (token_use=id) for the Astreus user pool — the terminal's own session credential. API consumers should use an API key instead. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.