# US House PTR Filing Tracker

> US House PTR Filing Tracker is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a list of US House financial disclosure (Periodic Transaction Report) filing events, filterable by year, state/district, member name, and filing type, including PDF links and metadata.

## Facts

- Endpoint: POST https://x402.forgemesh.io/congress-ptr-tracker
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-house-ptr-filing-tracker-584d7140
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ALZOQ43q5VBAiHkYX1U05

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-house-ptr-filing-tracker-584d7140 -d '<json body>'
```

Example prompt: Can you pull up the most recent House PTR filings from 2026 for Virginia representatives — I want the filing dates, document IDs, and PDF links for up to 20 results?

## When to prefer this

Use this endpoint when you need to discover, list, or monitor US House member financial disclosure (PTR) filings by year, state, district, or member name, and need direct PDF links to official documents. Prefer this over manual scraping of the House Clerk website when you want structured, filterable, machine-readable results. The companion trades endpoint on the same host is better if you need parsed individual trade rows rather than filing-level metadata.

## Known failure modes

- No filings found matching filters — returns empty filings array with matched:0
- Invalid filing_type code — may return no results or an error
- limit exceeds maximum of 100 — request rejected
- Year with no data yet returns empty result set
- Network or payment failure returns HTTP 402 or 5xx

## How this service works

Periodic transaction report tracker for the US House: each entry is one filing event — member, district, date, document id, PDF link — so an agent can poll for fresh trade disclosures and fetch parsed rows from the companion trades endpoint. Covers all filing types with a code legend in every response.

## Output

A JSON object containing a list of filing events, each with the member's last name, first name, state/district code, chamber, filing date, filing type code, filing type label (e.g. 'periodic transaction report (STOCK Act trades)'), document ID, and a direct PDF URL to the official House Clerk disclosure. Also includes total matched count, returned count, and a public domain attribution note.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "description": "filing year, e.g. 2026"
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "state": {
   "type": "string",
   "description": "state or district prefix, e.g. 'TX' or 'TX02'"
  },
  "member": {
   "type": "string",
   "description": "member name substring"
  },
  "filing_type": {
   "type": "string",
   "description": "filing type code, e.g. 'P' for periodic transaction report"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "filings": [
   {
    "last": "Wittman",
    "year": 2026,
    "first": "Robert J.",
    "doc_id": "20034916",
    "chamber": "house",
    "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034916.pdf",
    "filing_date": "7/10/2026",
    "filing_type": "P",
    "state_district": "VA01",
    "filing_type_label": "periodic transaction report (STOCK Act trades)"
   }
  ],
  "matched": 14,
  "returned": 5,
  "attribution": "US House Clerk financial disclosures (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-house-ptr-filing-tracker-584d7140/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)