# ForgeMesh Legislation Lookup

> ForgeMesh Legislation Lookup is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns official metadata for a specific US House or Senate bill or resolution by bill type, number, and congress, including sponsor, introduction date, latest action, committees, and cosponsor counts.

## Facts

- Endpoint: POST https://x402.forgemesh.io/legislation-lookup
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-legislation-lookup-4d06590a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6lJfWjGdgY4Ie_-24FjU6

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 forgemesh-legislation-lookup-4d06590a -d '<json body>'
```

Example prompt: Can you pull up the official details for Senate bill S 2226 from the 118th Congress — I need the sponsor, latest action, and policy area?

## When to prefer this

Use this endpoint when you have a specific bill identifier (type + number + congress) and need authoritative, structured metadata from Congress.gov. It is the deterministic alternative to keyword-based legislation search — ideal when the bill number is already known and you need official sponsor, status, and committee data quickly.

## Known failure modes

- Invalid bill type returns error or empty result — only hr, s, hjres, sjres, hconres, sconres, hres, sres are valid
- Bill number not found for the specified congress returns empty or null bill data
- Non-existent congress number returns no results
- Stale cache may return data up to one hour old for recently updated bills
- Malformed request body returns validation error

## How this service works

Legislation lookup by bill identifier: official metadata for House and Senate bills and resolutions — sponsor, introduction date, latest action, committees, cosponsor and amendment counts — cached one hour. The deterministic companion to keyword-based regulation search.

## Output

A JSON object containing the bill's official title, type, number, congress session, list of sponsors with full names, policy area, latest action text and date, and attribution to Congress.gov as a public domain source. Data is cached for one hour.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string",
   "description": "bill type: hr, s, hjres, sjres, hconres, sconres, hres, sres (default hr)"
  },
  "number": {
   "type": "string",
   "description": "bill number, e.g. '1' (default 1)"
  },
  "congress": {
   "type": "string",
   "description": "congress number, e.g. '119' (default 119)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "bill": {
    "type": "S",
    "title": "National Defense Authorization Act example",
    "number": "2226",
    "congress": 118,
    "sponsors": [
     {
      "fullName": "Sen. Example"
     }
    ],
    "policyArea": {
     "name": "Armed Forces and National Security"
    },
    "latestAction": {
     "text": "Became Public Law",
     "actionDate": "2024-12-11"
    }
   }
  },
  "attribution": "Congress.gov (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-legislation-lookup-4d06590a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)