# US Congress Bill Status Lookup (GPO GovInfo)

> US Congress Bill Status Lookup (GPO GovInfo) is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Retrieves official status, title, sponsor, and latest action for a specific US Congress bill by congress number, bill type, and bill number from GPO GovInfo BILLSTATUS bulk XML data.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/govtrack-congress?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-congress-bill-status-lookup-gpo-govinfo-b5396863
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gdHHLNLRhb5gm57b6RLvm

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-congress-bill-status-lookup-gpo-govinfo-b5396863
```

Example prompt: What's the current status of Senate Bill 100 in the 119th Congress — who sponsored it and what's the latest action?

## When to prefer this

Use this endpoint when you need official, structured metadata for a specific US Congress bill by its exact identifiers (congress number, bill type, bill number). It is sourced directly from GPO GovInfo BILLSTATUS bulk XML — the authoritative government source — making it superior to third-party scrapers or the now-closed GovTrack API for accuracy and longevity. Prefer this over general legislative search endpoints when you already know the bill's specific identifiers and want structured data including sponsor details, introduced date, latest action, and official links.

## Known failure modes

- Bill not found for given congress/type/number combination — returns error or empty result
- Congress number outside supported range (only congresses with BILLSTATUS files, e.g. 119 confirmed) may return no data
- Invalid bill type string (must be one of: hr, s, hres, sres, hjres, sjres, hconres, sconres) causes validation failure
- Bill number out of range or non-numeric input returns error
- Upstream GPO GovInfo bulk XML unavailable causes fetch failure

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the bill's type, title, number, sponsor name, sponsor party, sponsor state, congress number, introduced date, latest action (date and text), official congress.gov URL, GPO GovInfo source XML URL, and a timestamp of when the data was last checked and updated.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "congress",
      "type",
      "number"
     ],
     "properties": {
      "type": {
       "type": "string",
       "description": "Bill type: hr, s, hres, sres, hjres, sjres, hconres or sconres"
      },
      "number": {
       "type": "string",
       "description": "Bill number, digits, 1 to 5 digits"
      },
      "congress": {
       "type": "string",
       "description": "Congress number, e.g. 119"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "S",
  "title": "Repealing Big Brother Overreach Act",
  "number": 100,
  "source": "https://www.govinfo.gov/bulkdata/BILLSTATUS/119/s/BILLSTATUS-119s100.xml",
  "sponsor": "Sen. Tuberville, Tommy [R-AL]",
  "congress": 119,
  "checkedAt": "2026-10-23T09:37:11.131Z",
  "updatedAt": "2025-12-05T22:08:44Z",
  "congressUrl": "https://www.congress.gov/bill/119th-congress/senate-bill/100",
  "latestAction": {
   "date": "2025-01-15",
   "text": "Referred to the House Committee on Financial Services."
  },
  "sponsorParty": "R",
  "sponsorState": "AL",
  "introducedDate": "2025-01-15"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-congress-bill-status-lookup-gpo-govinfo-b5396863/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)