# 📋 SEC Form N-PX — Mutual Fund Proxy Vote Disclosures (`nexgendata/sec-form-npx-mutual-fund-proxy-votes`) Actor

Pull mutual fund / ETF proxy vote records straight from SEC EDGAR Form N-PX annual disclosures. Every vote cast, every issuer, with management recommendation and voted-with-management flag. Glass Lewis / ISS / Morningstar Voting Rights alternative. Premium institutional pricing.

- **URL**: https://apify.com/nexgendata/sec-form-npx-mutual-fund-proxy-votes.md
- **Developed by:** [Stephan Corbeil](https://apify.com/nexgendata) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 📋 SEC Form N-PX — Mutual Fund Proxy Vote Disclosures

**Every proxy vote, every fund, straight from the SEC.** Pull machine-readable mutual fund and ETF proxy voting records from SEC EDGAR Form N-PX annual disclosures. Filter by fund CIK, by issuer ticker, or by recent filings. Each record carries the fund's vote, the management recommendation, a `voted_with_management` flag, the proposal category (governance, compensation, environmental, social, shareholder), shares voted, and shares on loan. **Governance research and ESG voting analytics at a fraction of Glass Lewis, ISS, or Morningstar Voting Rights pricing.**

This actor unlocks the same data set that powers $1,500-and-up-per-seat enterprise products. Every U.S. registered investment company is required to disclose its proxy votes annually. The filings are public. The XML schema is documented. Nobody has built a clean institutional-grade API around it — until now.

---

### Why this actor beats the alternatives

| Feature | This Actor | ISS Voting Analytics | Glass Lewis Proxy Talk | Morningstar Voting Rights | ProxyMonitor.org |
|---|---|---|---|---|---|
| **Coverage** | ALL N-PX filings (~5,000 funds, ~5M votes/yr) | Enterprise client list only | Enterprise client list only | ~30,000 funds | S&P 500 only |
| **Refresh latency** | Real-time (within hours of EDGAR filing) | Quarterly updates | Quarterly updates | Daily | Annual |
| **Pricing** | Pay-per-vote ($0.05 / record) | Enterprise contract ($25K+/yr) | Enterprise contract ($30K+/yr) | $1,500+/yr per seat | Free, but limited |
| **Filter by fund CIK** | ✅ Direct | Manual through UI | Manual through UI | ✅ | ❌ |
| **Filter by issuer (cross-fund)** | ✅ One query | ✅ | ✅ | ✅ | Partial |
| **Filter by recent filings** | ✅ daysBack window | ❌ | ❌ | ❌ | ❌ |
| **Voted-with-management flag** | ✅ Auto-computed | ✅ | ✅ | ✅ | Partial |
| **ESG categorization** | ✅ (env / social / gov / compensation) | ✅ | ✅ | ✅ | ❌ |
| **Output format** | JSON / CSV / Excel | Excel only | PDF + Excel | CSV via portal | HTML scrape |
| **API / scriptable** | ✅ REST + SDK | ❌ Portal only | ❌ Portal only | Limited | ❌ |
| **Setup time** | < 1 minute | 2-6 weeks | 4-8 weeks | 1 week | None |
| **Source** | SEC EDGAR (primary) | SEC EDGAR + ISS overlay | SEC EDGAR + Glass Lewis overlay | SEC EDGAR | Hand-curated subset |

---

### What you get

Every dataset item is a single proxy vote record with these fields:

* **Fund identifiers:** `fund_cik`, `fund_name`, `fund_series_id`, `fund_series_name`
* **Filing context:** `filing_id` (EDGAR accession), `filing_date`, `period_of_report`
* **Issuer identifiers:** `issuer_name`, `issuer_cusip`, `issuer_isin`, `issuer_ticker` (when joinable)
* **Vote context:** `meeting_date`, `proposal_index`, `proposal_text` (truncated to 500 chars), `proposal_category` (governance / compensation / environmental / social / shareholder / other), `proposal_source` (ISSUER / SHAREHOLDER)
* **The vote itself:** `vote` (For / Against / Abstain / NoVote / Mixed), `vote_management_recommendation`, `voted_with_management` (boolean)
* **Stewardship signal:** `shares_voted`, `shares_on_loan`
* **Audit trail:** `_source_url` — direct link to the EDGAR ProxyVotingTable.xml for that filing

Every field is normalized — no parsing free-text "AGAINST (Withhold)" vs "WITHHELD" vs "AGAINST" across thousands of funds.

---

### Use cases

* **ESG / sustainability fund managers** — verify your own fund family's vote record, audit competitors' say-on-climate votes, build year-over-year ESG voting scorecards
* **Activist hedge fund desks** — see which mutual funds voted against management at your target companies, build a vote-prediction model for the next AGM
* **Governance researchers** — quantify board-recommendation override rates by fund family, cross-correlate fund manager turnover with voting behavior shifts
* **Proxy-advisory firms (Glass Lewis / ISS competitors)** — backtest your recommendation alignment with actual fund votes, benchmark adoption of your guidelines
* **Compensation consultants** — track say-on-pay support rates by industry, by market cap, by fund family
* **Academic finance / governance researchers** — replicate published studies (Aggarwal, Erel, Ferreira, Matos), build longitudinal datasets, panel-data analyses
* **Shareholder activist NGOs** — identify the fund families most receptive to climate / DEI / human-rights proposals
* **Corporate IR teams** — preview which institutional holders are likely to support or oppose upcoming ballot items

---

### Quick start

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")

run = client.actor("nexgendata/sec-form-npx-mutual-fund-proxy-votes").call(
    run_input={
        "mode": "by_cik",
        "cik": "1120925",         ## T. Rowe Price International Index Fund
        "maxVotes": 500,
        "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]},
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["issuer_name"], "|", item["proposal_text"][:80],
          "|", item["vote"], "vs mgmt:", item["vote_management_recommendation"])
````

#### Modes

- `recent_filings` — scan all N-PX filings filed in the last `daysBack` days (default 30). Best for monitoring the late-summer filing rush.
- `by_cik` — pull every vote for one fund / fund-family. Requires `cik`. Use this for compliance audits or peer-fund comparisons.
- `by_issuer` — cross-fund view: every vote from every fund on a single issuer. Accepts a ticker (`AAPL`) or a company-name substring (`Exxon`). Use this for stewardship signal analysis.

***

### Pricing — premium institutional tier

This actor uses **Pay-Per-Event** billing:

| Event | Price |
|---|---|
| Actor start | **$0.005** per run |
| Proxy vote record | **$0.05** per record returned |

Typical query costs:

- **Single-fund full year** (10,000–50,000 votes) — **$500–$2,500**
- **Single-issuer across all funds, one year** (50–200 votes) — **$2.50–$10**
- **One-fund-family quarterly compliance audit** (~5,000 votes) — **$250**
- **Smoke-test query** (`maxVotes: 20`) — **$1.00**

We recommend setting a daily account cap of **$5,000 / 100,000 votes** to bound spend on accidental large pulls.

Compared with ISS Voting Analytics ($25K/yr) or a Morningstar Voting Rights seat ($1,500/yr), a $250 single-audit query pays for itself the first time you avoid a contract renewal.

***

### Related actors from NexGenData

Cross-reference proxy vote behavior with insider trading, institutional holdings, and corporate events:

| Actor | What it does |
|---|---|
| [13F Holdings Delta Tracker](https://apify.com/nexgendata/13f-holdings-delta-tracker) | Quarter-over-quarter changes in 13F institutional holdings |
| [SEC Form 4 Insider Tracker](https://apify.com/nexgendata/sec-form4-insider-tracker) | CEO / CFO / Director / 10%-owner buys & sells |
| [Corporate Actions Tracker](https://apify.com/nexgendata/corporate-actions-tracker) | Dividends, splits, M\&A, spinoffs |
| [Earnings Calendar](https://apify.com/nexgendata/earnings-calendar) | Forward earnings dates with consensus estimates |
| [Analyst Targets Scraper](https://apify.com/nexgendata/analyst-targets-scraper) | Wall Street price targets and rating changes |
| [Pre-IPO Secondary Market](https://apify.com/nexgendata/preipo-secondary-market) | Private market valuations for pre-IPO names |

The whole NexGenData fleet — 100+ premium financial / governance / market actors at [apify.com/nexgendata?fpr=2ayu9b](https://apify.com/nexgendata?fpr=2ayu9b).

***

### FAQ

**Q: Is this real SEC data, or a third-party aggregator?**
A: 100% primary-source EDGAR. We pull directly from `https://www.sec.gov/Archives/edgar/data/...` — the same XML files the SEC publishes. There is no third-party scraper, no rewrite layer. Your `_source_url` field points at the exact XML attachment we parsed.

**Q: How current is the data?**
A: As soon as a fund files Form N-PX, EDGAR indexes it (usually within minutes) and our `recent_filings` mode will surface it on the next run. Most N-PX filings are submitted July through September each year for the 12-month period ending June 30.

**Q: What about pre-2024 filings? I heard the format changed.**
A: SEC Form N-PX Modernization (effective July 2024) introduced the structured XML schema we parse. Pre-modernization filings are unstructured HTML and are skipped with a log message — they're not extractable into the same flat schema reliably. If you need pre-2024 data, request a custom build.

**Q: Why is `issuer_ticker` sometimes null?**
A: Form N-PX requires CUSIP and ISIN but not ticker. We populate CUSIP/ISIN faithfully — join on CUSIP for ticker resolution if you have an OpenFIGI / Refinitiv mapping. Future versions will integrate the SEC company-tickers map.

**Q: How does `voted_with_management` get computed?**
A: It is `true` when the fund's normalized vote (For/Against) equals the issuer management's normalized recommendation. Mixed votes, abstains, and absent recommendations resolve to `false`. The raw values are also exposed so you can rebuild the boolean with your own logic.

**Q: What's the largest filing you can process?**
A: We stream the ProxyVotingTable.xml in 64KB chunks and iterate the parse so memory stays bounded. The largest filings we've parsed are about 100MB and 600,000 vote records per fund family. Set `maxVotes` to bound output volume and cost.

**Q: How does this compare with the Apify 13F Delta Tracker?**
A: 13F shows what funds *own*. N-PX shows what funds *believe*. The two together — holdings + voting record — are the canonical stewardship dataset. Run both as a sister-actor query for any fund family.

**Q: Can I get this data exported to Snowflake / BigQuery / S3?**
A: Yes. Apify's run-on-schedule + dataset export to S3 / GCS / Snowflake is built in. Set up a daily scheduled task and the data lands in your warehouse with no glue code.

**Q: Are votes deduplicated?**
A: Yes — per `(fund_cik, filing_id, proposal_index)` tuple. Re-running the same query will not produce duplicate dataset rows for the same proposal.

**Q: Why is the per-record price $0.05?**
A: This is institutional-grade data with a buyer pool that pays $1,500–$25,000 per seat for the same content elsewhere. The $0.05 / record price keeps the actor affordable for one-off audits ($250 covers a full-fund-year pull) while preserving margin on cross-fund issuer queries that institutions pay premium prices for. Compared to a Morningstar Voting Rights seat, you'll break even on the first focused query.

***

### About NexGenData

NexGenData publishes 100+ premium financial-data and governance actors on Apify — every major U.S. and global financial filing, market data feed, fund holdings, insider activity, and corporate-events source, all with consistent pay-per-event pricing and full audit trails to the primary regulator.

Browse the full fleet: [apify.com/nexgendata?fpr=2ayu9b](https://apify.com/nexgendata?fpr=2ayu9b)

Contact: contact@thenextgennexus.com

***

*SEC Form N-PX is a public disclosure required of all U.S. registered investment companies under Rule 30b1-4 of the Investment Company Act of 1940. This actor reproduces the public record. No subscription is required to view N-PX filings at SEC.gov; this product exists to make the data machine-readable, queryable, and reliably structured at institutional scale.*

# Actor input Schema

## `mode` (type: `string`):

Which slice of Form N-PX filings to scan. `recent_filings` walks all N-PX submissions in the last `daysBack` days. `by_cik` pulls every N-PX filing for a specific fund CIK. `by_issuer` extracts every vote across all funds that mentions a specific issuer (ticker or company-name substring).

## `daysBack` (type: `integer`):

Look at N-PX filings filed within the last N days. Only used when `mode=recent_filings`. Note: most N-PX filings are filed July through September each year for the annual period ending June 30, so a 30-day window outside that range may return zero results.

## `cik` (type: `string`):

SEC CIK (Central Index Key) of the fund / fund-family. Required when `mode=by_cik`. Example: `1120925` for T. Rowe Price International Index Fund. Look up CIK at https://www.sec.gov/cgi-bin/browse-edgar.

## `issuer` (type: `string`):

Issuer the funds voted on. Accepts a US ticker (e.g. `AAPL`, `XOM`) or a company-name substring (e.g. `Apple`, `Exxon`). Required when `mode=by_issuer`. The match is case-insensitive and looks for the token inside the N-PX issuer\_name field.

## `maxVotes` (type: `integer`):

Hard cap on total vote records pushed to the dataset (and metered for billing). A single mid-size fund can produce 10,000+ records, and a fund-family annual filing can exceed 1,000,000 records — set this to control cost.

## `proxyConfiguration` (type: `object`):

Apify proxy configuration. SEC EDGAR has a polite 10 req/sec rate limit and a User-Agent requirement (we use `NexGenData/1.0 contact@thenextgennexus.com`). Residential proxy is recommended for sustained throughput.

## Actor input object example

```json
{
  "mode": "recent_filings",
  "daysBack": 60,
  "cik": "1120925",
  "issuer": "Apple",
  "maxVotes": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "recent_filings",
    "daysBack": 60,
    "cik": "1120925",
    "issuer": "Apple",
    "maxVotes": 200,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/sec-form-npx-mutual-fund-proxy-votes").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "recent_filings",
    "daysBack": 60,
    "cik": "1120925",
    "issuer": "Apple",
    "maxVotes": 200,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/sec-form-npx-mutual-fund-proxy-votes").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "recent_filings",
  "daysBack": 60,
  "cik": "1120925",
  "issuer": "Apple",
  "maxVotes": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call nexgendata/sec-form-npx-mutual-fund-proxy-votes --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/sec-form-npx-mutual-fund-proxy-votes",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "📋 SEC Form N-PX — Mutual Fund Proxy Vote Disclosures",
        "description": "Pull mutual fund / ETF proxy vote records straight from SEC EDGAR Form N-PX annual disclosures. Every vote cast, every issuer, with management recommendation and voted-with-management flag. Glass Lewis / ISS / Morningstar Voting Rights alternative. Premium institutional pricing.",
        "version": "0.0",
        "x-build-id": "fBU5KHO29NHf9iNwI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~sec-form-npx-mutual-fund-proxy-votes/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-sec-form-npx-mutual-fund-proxy-votes",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/nexgendata~sec-form-npx-mutual-fund-proxy-votes/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-sec-form-npx-mutual-fund-proxy-votes",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/nexgendata~sec-form-npx-mutual-fund-proxy-votes/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-sec-form-npx-mutual-fund-proxy-votes",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Query mode",
                        "enum": [
                            "recent_filings",
                            "by_cik",
                            "by_issuer"
                        ],
                        "type": "string",
                        "description": "Which slice of Form N-PX filings to scan. `recent_filings` walks all N-PX submissions in the last `daysBack` days. `by_cik` pulls every N-PX filing for a specific fund CIK. `by_issuer` extracts every vote across all funds that mentions a specific issuer (ticker or company-name substring).",
                        "default": "recent_filings"
                    },
                    "daysBack": {
                        "title": "Days back",
                        "minimum": 1,
                        "maximum": 365,
                        "type": "integer",
                        "description": "Look at N-PX filings filed within the last N days. Only used when `mode=recent_filings`. Note: most N-PX filings are filed July through September each year for the annual period ending June 30, so a 30-day window outside that range may return zero results.",
                        "default": 30
                    },
                    "cik": {
                        "title": "Fund CIK",
                        "type": "string",
                        "description": "SEC CIK (Central Index Key) of the fund / fund-family. Required when `mode=by_cik`. Example: `1120925` for T. Rowe Price International Index Fund. Look up CIK at https://www.sec.gov/cgi-bin/browse-edgar."
                    },
                    "issuer": {
                        "title": "Issuer ticker or company name",
                        "type": "string",
                        "description": "Issuer the funds voted on. Accepts a US ticker (e.g. `AAPL`, `XOM`) or a company-name substring (e.g. `Apple`, `Exxon`). Required when `mode=by_issuer`. The match is case-insensitive and looks for the token inside the N-PX issuer_name field."
                    },
                    "maxVotes": {
                        "title": "Max vote records",
                        "minimum": 1,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Hard cap on total vote records pushed to the dataset (and metered for billing). A single mid-size fund can produce 10,000+ records, and a fund-family annual filing can exceed 1,000,000 records — set this to control cost.",
                        "default": 1000
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy configuration. SEC EDGAR has a polite 10 req/sec rate limit and a User-Agent requirement (we use `NexGenData/1.0 contact@thenextgennexus.com`). Residential proxy is recommended for sustained throughput.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
