# Disclosures Clerk — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access and analyze financial transactions reported by members of Congress through their periodic disclosure filings, including detailed transaction records and aggregated spending breakdowns by category. Track congressional financial activity, identify investment patterns, and view comprehensive summaries of reported trades and holdings.

**Category:** Government & Public Data | **Website:** [disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20033725.pdf](https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20033725.pdf) | **Docs:** [parse.bot/marketplace/593ac4de-4f71-4e72-bb44-9a8bc7dc4fc0/disclosures-clerk-house-gov-api](https://parse.bot/marketplace/593ac4de-4f71-4e72-bb44-9a8bc7dc4fc0/disclosures-clerk-house-gov-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-disclosures-clerk-house-gov-api-593ac4de/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_pie_chart_data

Get aggregated transaction data suitable for a pie chart visualization. Groups transactions by asset (ticker when available, otherwise full asset name) or by transaction type, using midpoint of amount ranges for dollar values. Returns labeled slices with values and percentages. Requires the same filing_id and year as get_transactions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filing_id` | string | No | Filing ID number from the House disclosure system. |
| `group_by` | string | No | How to group transactions. |
| `year` | string | No | Year the filing was made (used in PDF URL path). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-disclosures-clerk-house-gov-api-593ac4de/get_pie_chart_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filing_id":"<string>","group_by":"<string>","year":"<string>"}'
```

### get_transactions

Extract all transactions from a Congressional financial disclosure filing (PTR). Parses the PDF and returns structured data including filer information and each transaction's asset name, ticker, transaction type, date, amount range, and description. A single filing typically contains 1-50 transactions. The PDF is fetched from the House disclosure system by filing_id and year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filing_id` | string | No | Filing ID number from the House disclosure system. |
| `year` | string | No | Year the filing was made (used in PDF URL path). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-disclosures-clerk-house-gov-api-593ac4de/get_transactions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filing_id":"<string>","year":"<string>"}'
```