# US Employer & 401(k) Plan Data — Form 5500 (DOL) (`foxlabs/us-employer-benefit-plans`) Actor
Every US employer that files an ERISA benefit plan — 401(k), pension, health & welfare — from the official DOL Form 5500 datasets. Name, EIN, phone, address, industry (NAICS), plan type, participant counts & assets. ~1M plans/year. Public domain, no key, no proxy.
- **URL**: https://apify.com/foxlabs/us-employer-benefit-plans.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## 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
## US Employer & 401(k) Plan Data — Form 5500 (DOL)
Need a **fresh, contactable list of US employers** — with the retirement and health plans they sponsor, who runs them, and how big they are? This Actor turns the U.S. Department of Labor's official **Form 5500 & 5500-SF** filings into ready-to-use B2B records: **~1,000,000 employer benefit-plan filings per year**, each with the sponsor's **name, EIN, phone, mailing address, industry (NAICS), plan type, participant count and plan assets**.
Built on the DOL's **public-domain** Form 5500 datasets — free to reuse **and resell**. **No API key, no login, no proxies, no fragile HTML scraping** — it reads the official annual data files directly, so it doesn't break.
- 🏢 **~1M plans/year** — every employer that files an ERISA plan (401(k), pension, health & welfare), not a sample
- ☎️ **~99% have a sponsor phone**, ~100% a mailing address & EIN (measured) — a call-ready lead source
- 📊 **Size & money signals** — participant counts on every plan, **total assets** on small plans
- ⚡ **One run → one clean, flat dataset** (JSON / CSV / Excel / API), filterable by state, industry, size & plan type
### Quick start (API)
Get 100 California health-care employers (NAICS 62) with a phone, in one call:
```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~us-employer-benefit-plans/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "year": "2023", "states": ["CA"], "industryCodes": ["62"], "onlyWithPhone": true, "maxResults": 100 }'
````
Prefer no code? Open the **Input** tab, set your filters, and click **Start** — then download the results.
### What you get
One clean, flat record per plan filing (an employer can sponsor several plans):
| Field | Type | Description |
|---|---|---|
| `sponsorName` | string | Employer / plan sponsor legal name |
| `dbaName` | string | "Doing business as" name, when filed |
| `ein` | string | 9-digit federal Employer ID Number |
| `phone` | string | Sponsor phone number |
| `address` / `city` / `state` / `zip` | string | Sponsor mailing address |
| `businessCode` / `industry` | string | 6-digit NAICS code + its sector name |
| `planName` | string | Name of the benefit plan |
| `planNumber` | string | 3-digit plan number (unique per sponsor) |
| `planEntityType` | string | Single-employer, multiemployer, multiple-employer or DFE |
| `planEffectiveDate` | string | When the plan started |
| `isPensionPlan` / `isWelfarePlan` | bool | Retirement plan / health & welfare plan |
| `benefitCodes` | string | Raw DOL benefit-type codes (e.g. `2K` = 401(k)) |
| `participants` / `activeParticipants` | number | Participant counts — an employer-size signal |
| `totalAssets` / `totalAssetsFormatted` | number / string | Plan assets — reported directly on small (5500-SF) plans |
| `planSize` | string | `large` (100+ participants, Form 5500) or `small` (Form 5500-SF) |
| `formType` / `ackId` / `planYear` / `filingDate` | string | Provenance & filing identifiers |
#### Sample output
```json
{
"sponsorName": "THE LAW OFFICE OF ANTHONY SCAR",
"ein": "472100868",
"phone": "7184762411",
"address": "9131 QUEENS BLVD STE 522",
"city": "ELMHURST",
"state": "NY",
"zip": "11373",
"businessCode": "522298",
"industry": "Finance & Insurance",
"planName": "THE LAW OFFICE OF ANTHONY SCAR 401(K) PROFIT SHARING PLAN & TRUST",
"planNumber": "001",
"planEntityType": "Single-employer plan",
"isPensionPlan": true,
"isWelfarePlan": false,
"benefitCodes": "2E2F2G2J2K2S2T3D",
"participants": 5,
"totalAssets": 433758,
"totalAssetsFormatted": "$434K",
"planSize": "small",
"formType": "5500-SF",
"planYear": "2023",
"filingDate": "2024-07-01"
}
```
### Input & filters
- **Plan year** — 2019–2023 (filings arrive up to ~10 months after year-end, so the most complete recent year is usually 2 years back).
- **States** — 2-letter codes (`["CA","NY","TX"]`); leave empty for all.
- **Industry (NAICS)** — one or more code prefixes: `62` = health care, `54` = professional services, `23` = construction, `52` = finance, or longer prefixes to narrow.
- **Employer name contains** — keyword match on the sponsor name (`hospital`, `bank`, `acme`).
- **Plan size** — large (100+ participants), small (under 100), or all.
- **Plan type** — pension/retirement (401(k), DB), health & welfare, or any.
- **Participant range** — `minParticipants` / `maxParticipants` to target employers by headcount.
- **Minimum assets** — keep only plans reporting at least *N* in assets (small plans).
- **Only employers with a phone** — for call-ready lists.
- **Max results** — up to 500,000.
### Example inputs (copy & paste)
```jsonc
// 1) Lead list — California health-care employers with a phone
{ "year": "2023", "states": ["CA"], "industryCodes": ["62"], "onlyWithPhone": true, "maxResults": 2000 }
// 2) 401(k) advisors — small retirement plans in Texas with $1M–$10M in assets
{ "year": "2023", "states": ["TX"], "planSize": "small", "planType": "pension", "minAssets": 1000000, "maxResults": 5000 }
// 3) Mid-market targeting — employers with 100–1,000 participants nationwide
{ "year": "2023", "planSize": "large", "minParticipants": 100, "maxParticipants": 1000, "maxResults": 20000 }
// 4) Named employer — every plan a specific company sponsors
{ "year": "2023", "keyword": "tesla", "maxResults": 100 }
// 5) Benefits brokers — health & welfare plans in the New York metro
{ "year": "2023", "states": ["NY", "NJ", "CT"], "planType": "welfare", "maxResults": 10000 }
// 6) Whole-state export — every filing employer in Florida
{ "year": "2023", "states": ["FL"], "maxResults": 50000 }
// 7) Construction sector — large plans, NAICS 23, with participant counts
{ "year": "2023", "industryCodes": ["23"], "planSize": "large", "maxResults": 15000 }
```
### Use cases
- **401(k) / retirement-plan sales.** You sell recordkeeping, advisory or TPA services. Filter `planType: "pension"` + `planSize: "small"` + an asset range → a list of plan sponsors with **phone, EIN and plan assets**, ranked by size — the exact book that BrightScope and Judy Diamond built businesses on.
- **Employee-benefits & insurance brokers.** Target `planType: "welfare"` in your states → employers running health & welfare plans, with contacts, to pitch group benefits.
- **B2B lead generation.** Every record is an established US employer with a **verified mailing address and phone** and an industry (NAICS) — a clean, compliant, public-record lead source with a built-in size signal (participants).
- **Market sizing & research.** Count filers by state, industry or plan type; rank sponsors by participants or assets to size a segment and spot the leaders.
- **CRM enrichment.** Match your prospects by EIN or name → append plan type, participant count, assets and industry. Missing fields return `null`, never a guess.
- **Competitive & M\&A intelligence.** Track which employers sponsor which plans, how many participants and how much in assets — filing over filing, year over year.
### Performance & throughput
Each run streams the official annual data file for the chosen year (the large-plan file is ~30 MB, the small-plan file ~130 MB), filtering as it reads — so it stops as soon as your `maxResults` is met. Filtered pulls are fast (a few thousand records in well under a minute); a full-year, no-filter export processes ~1M filings. There are no external keys, proxies or rate limits — throughput is bounded only by your Apify plan.
### Integrations
**JavaScript** (`apify-client`):
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('foxlabs/us-employer-benefit-plans').call({
year: '2023', states: ['CA'], industryCodes: ['62'], onlyWithPhone: true, maxResults: 500,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```
**Python** (`apify-client`):
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("foxlabs/us-employer-benefit-plans").call(run_input={
"year": "2023", "states": ["CA"], "industryCodes": ["62"], "onlyWithPhone": True, "maxResults": 500,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item["sponsorName"], item.get("phone"), item.get("totalAssetsFormatted"))
```
Also works with **Make / n8n / Zapier** (Apify app → run this Actor, map the input), scheduled runs, webhooks, and the **Apify MCP server** for AI agents.
### Data quality (measured, 2023 large plans)
| Field | Fill rate |
|---|---|
| Sponsor name, EIN, plan name, plan type | **100%** |
| Mailing address, city, state, ZIP | **~99.9%** |
| Sponsor phone | **~99.3%** |
| Industry code (NAICS) | **~96.5%** |
| Participant counts | **~96.3%** |
| Total assets | small (5500-SF) plans: **direct**; large plans: via Schedule H *(not joined in v1 — value is `null`)* |
Measured on the full 2023 large-plan dataset. Every value is read from the filed form — never fabricated; missing values are `null`.
### Pricing
**Pay per result** — you're billed per plan record returned. There's an Apify **free tier** to evaluate the full feature set before you scale. The underlying data is public-domain and there are no proxy or third-party costs.
### FAQ
**Can I use this data commercially / resell it?** Yes. Form 5500 data is a **U.S. government work in the public domain** — free to reuse and redistribute, including commercially.
**How fresh is the data?** It reads the DOL's official annual dataset for the year you pick. DOL refreshes these files as filings and amendments arrive; each run pulls the current "latest filing per plan" version.
**Why is the most complete year ~2 years back?** Plans file up to ~10 months after their year-end, plus extensions. 2023 is essentially complete; the current year is still filling in.
**Do I need an account with the DOL?** No. No key, no login — it's public open data.
**What's an EIN?** The 9-digit federal Employer Identification Number — a stable key to match and dedupe employers across datasets.
**What's the difference between large and small plans?** Large plans (100+ participants) file Form 5500 with richer schedules; small plans (under 100) file the shorter 5500-SF, which reports total assets directly. Set `planSize` to pick one or merge both.
**How do I find 401(k) plans specifically?** Filter `planType: "pension"`. The raw `benefitCodes` field carries DOL codes (e.g. `2K` = 401(k) feature) if you need finer detail.
**Do you include plan assets for large plans?** Large-plan financials live on Schedule H, which v1 does not join yet — so `totalAssets` is populated for small plans and `null` for large ones (participant counts are on both). Schedule H enrichment is on the roadmap.
**Can I get several years?** Run once per `year` and combine — filings link across years by EIN + plan number.
**How many records in one run?** Up to 500,000 via `maxResults`.
### Troubleshooting
- **0 results** → filters too narrow. Widen the `states`/`industryCodes`, clear `onlyWithPhone`/`minAssets`, or check the `year`.
- **`totalAssets` is null** → that plan is a large (Form 5500) filing; assets there come from Schedule H (not joined in v1). Small (5500-SF) plans carry assets directly.
- **First results take a moment** → the Actor streams the official annual file at the start of each run (it's built for filtered lists, not single instant lookups); with a `maxResults` it stops early.
- **A sponsor name looks truncated** → small-plan sponsor names are as filed with the DOL; some filers abbreviate. Values are never altered.
### Notes, limits & legal (honest)
- **License.** Form 5500 series data is published by the U.S. Department of Labor (EBSA) as a public-domain U.S. government work; redistribution — including commercial — is permitted.
- **Personal data.** Records describe *employers and their plans*, not consumers. Sponsor phone/address are business contact details filed on a public federal form.
- **Assets on large plans.** `totalAssets` is `null` for large (Form 5500) plans in v1 — those figures are on Schedule H, planned for a future release. Participant counts are present on all plans.
- **Amended/duplicate filings.** The Actor uses DOL's "latest filing per plan" dataset, so you get one current record per plan (not every historical amendment).
- **Not affiliated** with the U.S. Department of Labor; this Actor redistributes their public data.
### Support
Questions, a field you'd like added (Schedule H financials, Schedule C service providers?), or a custom build? Open the **Issues** tab on this Actor, or email **info@foxlabs.com.tr**. We reply fast.
*If this Actor saves you time, a ⭐ review really helps.*
### Changelog
#### 0.1
- Initial release. ~1M US employer benefit-plan filings per year from the official DOL Form 5500 & 5500-SF datasets (public domain): sponsor name, EIN, phone, mailing address, industry (NAICS), plan name & type, participant counts, and plan assets (small plans). Filter by year, state, industry, plan size, plan type, participant range, assets and employer name. No key, no proxy.
***
Part of the **[foXLabs data platform](https://data.foxlabs.com.tr/)** — official public-data company, contact, ownership, jobs, charity, location & AI-search intelligence scrapers. Browse the full suite at **[data.foxlabs.com.tr](https://data.foxlabs.com.tr/)**.
# Actor input Schema
## `year` (type: `string`):
Which Form 5500 filing year to pull. Filings arrive up to ~10 months after year-end, so the most complete recent year is usually 2 years back.
## `states` (type: `array`):
Keep only employers in these US states — 2-letter codes (e.g. \["CA", "NY", "TX"]). Leave empty for all states.
## `industryCodes` (type: `array`):
Keep only employers whose business code starts with one of these NAICS prefixes. 2 digits = sector (e.g. "62" health care, "54" professional services, "23" construction), or use longer prefixes to narrow. Leave empty for all industries.
## `keyword` (type: `string`):
Keep only employers whose name contains this text (case-insensitive). Example: "hospital", "bank", "acme". Leave empty to browse by the other filters.
## `planSize` (type: `string`):
Large plans (Form 5500, generally 100+ participants) report richer detail; small plans (Form 5500-SF, under 100) include total assets directly. "All" merges both.
## `planType` (type: `string`):
Pension = retirement plans (401(k), defined benefit). Welfare = health, life, disability & other benefits. "Any" returns both.
## `minParticipants` (type: `integer`):
Keep only plans with at least this many participants — a proxy for employer headcount. Leave empty for no minimum.
## `maxParticipants` (type: `integer`):
Keep only plans with at most this many participants. Leave empty for no maximum.
## `minAssets` (type: `integer`):
Keep only plans reporting at least this much in total assets. Note: assets are reported directly only on small (5500-SF) plans; large plans report assets on Schedule H. Leave empty for no minimum.
## `onlyWithPhone` (type: `boolean`):
Return only employers that list a sponsor phone number (≈99% do). Useful for call-ready lead lists.
## `maxResults` (type: `integer`):
Maximum number of employer/plan records to return.
## Actor input object example
```json
{
"year": "2023",
"states": [
"CA"
],
"industryCodes": [],
"planSize": "all",
"planType": "any",
"onlyWithPhone": false,
"maxResults": 1000
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"states": [
"CA"
],
"industryCodes": [],
"maxResults": 1000
};
// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/us-employer-benefit-plans").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"states": ["CA"],
"industryCodes": [],
"maxResults": 1000,
}
# Run the Actor and wait for it to finish
run = client.actor("foxlabs/us-employer-benefit-plans").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 '{
"states": [
"CA"
],
"industryCodes": [],
"maxResults": 1000
}' |
apify call foxlabs/us-employer-benefit-plans --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=foxlabs/us-employer-benefit-plans",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "US Employer & 401(k) Plan Data — Form 5500 (DOL)",
"description": "Every US employer that files an ERISA benefit plan — 401(k), pension, health & welfare — from the official DOL Form 5500 datasets. Name, EIN, phone, address, industry (NAICS), plan type, participant counts & assets. ~1M plans/year. Public domain, no key, no proxy.",
"version": "0.1",
"x-build-id": "kbbpm6rY42ov6gn8l"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/foxlabs~us-employer-benefit-plans/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-foxlabs-us-employer-benefit-plans",
"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/foxlabs~us-employer-benefit-plans/runs": {
"post": {
"operationId": "runs-sync-foxlabs-us-employer-benefit-plans",
"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/foxlabs~us-employer-benefit-plans/run-sync": {
"post": {
"operationId": "run-sync-foxlabs-us-employer-benefit-plans",
"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",
"properties": {
"year": {
"title": "Plan year",
"enum": [
"2023",
"2022",
"2021",
"2020",
"2019"
],
"type": "string",
"description": "Which Form 5500 filing year to pull. Filings arrive up to ~10 months after year-end, so the most complete recent year is usually 2 years back.",
"default": "2023"
},
"states": {
"title": "States",
"type": "array",
"description": "Keep only employers in these US states — 2-letter codes (e.g. [\"CA\", \"NY\", \"TX\"]). Leave empty for all states.",
"items": {
"type": "string"
}
},
"industryCodes": {
"title": "Industry filter (NAICS)",
"type": "array",
"description": "Keep only employers whose business code starts with one of these NAICS prefixes. 2 digits = sector (e.g. \"62\" health care, \"54\" professional services, \"23\" construction), or use longer prefixes to narrow. Leave empty for all industries.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "Employer name contains",
"type": "string",
"description": "Keep only employers whose name contains this text (case-insensitive). Example: \"hospital\", \"bank\", \"acme\". Leave empty to browse by the other filters."
},
"planSize": {
"title": "Plan size",
"enum": [
"all",
"large",
"small"
],
"type": "string",
"description": "Large plans (Form 5500, generally 100+ participants) report richer detail; small plans (Form 5500-SF, under 100) include total assets directly. \"All\" merges both.",
"default": "all"
},
"planType": {
"title": "Plan type",
"enum": [
"any",
"pension",
"welfare"
],
"type": "string",
"description": "Pension = retirement plans (401(k), defined benefit). Welfare = health, life, disability & other benefits. \"Any\" returns both.",
"default": "any"
},
"minParticipants": {
"title": "Minimum participants",
"minimum": 0,
"type": "integer",
"description": "Keep only plans with at least this many participants — a proxy for employer headcount. Leave empty for no minimum."
},
"maxParticipants": {
"title": "Maximum participants",
"minimum": 0,
"type": "integer",
"description": "Keep only plans with at most this many participants. Leave empty for no maximum."
},
"minAssets": {
"title": "Minimum plan assets (USD)",
"minimum": 0,
"type": "integer",
"description": "Keep only plans reporting at least this much in total assets. Note: assets are reported directly only on small (5500-SF) plans; large plans report assets on Schedule H. Leave empty for no minimum."
},
"onlyWithPhone": {
"title": "Only employers with a phone number",
"type": "boolean",
"description": "Return only employers that list a sponsor phone number (≈99% do). Useful for call-ready lead lists.",
"default": false
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 500000,
"type": "integer",
"description": "Maximum number of employer/plan records to return.",
"default": 1000
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```