{ "openapi": "3.0.1", "info": { "title": "Form 5500 Employee Benefit Plan & 401(k) Filings Scraper", "description": "Scrape US Form 5500 benefit plan filings: 401(k), pension, ESOP and health plans with the sponsoring employer name, EIN, mailing address, participant counts, plan assets and decoded plan features. Filter by employer, state, NAICS sector, plan year, headcount or assets. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "mPu00c8Okg6N2zg5n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~form-5500-benefit-plans-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-form-5500-benefit-plans-scraper", "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/scrapers_lat~form-5500-benefit-plans-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-form-5500-benefit-plans-scraper", "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/scrapers_lat~form-5500-benefit-plans-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-form-5500-benefit-plans-scraper", "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": { "searchQueries": { "title": "Employer Or Plan Names To Search", "type": "array", "description": "One search per entry. Matches the sponsoring employer name or the plan name, so \"Tesla\" returns every Tesla benefit plan filing. Leave empty to sweep purely by the filters below.", "items": { "type": "string" } }, "sponsorNames": { "title": "Sponsoring Employer Names (exact)", "type": "array", "description": "Restrict to these employer names, matched as a whole phrase. Use when a keyword search returns too many unrelated employers.", "items": { "type": "string" } }, "planNames": { "title": "Plan Names (exact)", "type": "array", "description": "Restrict to these plan names, matched as a whole phrase, e.g. \"Acme Inc 401(k) Plan\".", "items": { "type": "string" } }, "eins": { "title": "Employer EINs", "type": "array", "description": "Nine-digit employer identification numbers, with or without the dash. The most precise way to pull every plan and every year for one company.", "items": { "type": "string" } }, "states": { "title": "Employer States", "type": "array", "description": "Two-letter US state codes of the sponsoring employer, e.g. CA, TX, NY.", "items": { "type": "string" } }, "cities": { "title": "Employer Cities", "type": "array", "description": "Cities of the sponsoring employer, e.g. Chicago. Combine with a state for accurate local targeting.", "items": { "type": "string" } }, "zipCodes": { "title": "Employer ZIP Codes", "type": "array", "description": "Five or nine digit ZIP codes of the sponsoring employer.", "items": { "type": "string" } }, "businessSectors": { "title": "Industry Sectors (2-digit NAICS)", "type": "array", "description": "Two-digit NAICS sector codes, e.g. 62 health care, 54 professional services, 31 manufacturing, 52 finance, 23 construction, 72 accommodation and food.", "items": { "type": "string" } }, "businessCodes": { "title": "Industry Codes (6-digit NAICS)", "type": "array", "description": "Full six-digit NAICS business codes for precise industry targeting, e.g. 541511 custom computer programming.", "items": { "type": "string" } }, "planCategory": { "title": "Plan Category", "enum": [ "any", "pension", "definedContribution", "definedBenefit", "welfare" ], "type": "string", "description": "Narrow to retirement plans or to health and welfare plans.", "default": "any" }, "only401k": { "title": "Only Plans With A 401(k) Feature", "type": "boolean", "description": "Return only plans that report a Code section 401(k) feature.", "default": false }, "planCharacteristicCodes": { "title": "Plan Feature Codes", "type": "array", "description": "Official Form 5500 plan characteristic codes, e.g. 2J 401(k) feature, 2S automatic enrollment, 2O ESOP, 1C cash balance, 4A health, 4D dental, 4E vision.", "items": { "type": "string" } }, "employerPlanTypes": { "title": "Employer Plan Types", "type": "array", "description": "1 single-employer, 2 multiple-employer, 3 multiemployer, 4-10 direct filing entities (master trusts, collective trusts, pooled separate accounts).", "items": { "type": "string" } }, "planYearFrom": { "title": "Plan Year From", "minimum": 1990, "maximum": 2030, "type": "integer", "description": "Earliest plan year to include. Filings go back to 2009." }, "planYearTo": { "title": "Plan Year To", "minimum": 1990, "maximum": 2030, "type": "integer", "description": "Latest plan year to include." }, "minParticipants": { "title": "Min Participants", "minimum": 0, "type": "integer", "description": "Only plans covering at least this many people at the start of the year — a reliable proxy for employer headcount." }, "maxParticipants": { "title": "Max Participants", "minimum": 0, "type": "integer", "description": "Only plans covering at most this many people." }, "minAssetsUsd": { "title": "Min Plan Assets (USD)", "minimum": 0, "type": "integer", "description": "Only plans holding at least this much at the end of the year." }, "maxAssetsUsd": { "title": "Max Plan Assets (USD)", "minimum": 0, "type": "integer", "description": "Only plans holding at most this much at the end of the year." }, "countryCodes": { "title": "Foreign Employer Countries", "type": "array", "description": "Two-letter country codes for employers based outside the US, e.g. CA, GB, BM, KY.", "items": { "type": "string" } }, "latestFilingOnly": { "title": "Drop Superseded Filings", "type": "boolean", "description": "Keep only the most recently received filing for each plan year, so amended re-filings do not appear (and are not charged) twice.", "default": true }, "latestPlanYearOnly": { "title": "Latest Plan Year Only", "type": "boolean", "description": "Return one row per plan — its most recent plan year only. Ideal for building a current prospect list rather than a filing history.", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "dateReceived", "assets", "participants", "planYear", "sponsorName", "planName" ], "type": "string", "description": "Order of the returned filings.", "default": "dateReceived" }, "sortOrder": { "title": "Sort Order", "enum": [ "desc", "asc" ], "type": "string", "description": "Descending puts the newest, largest or best-funded plans first.", "default": "desc" }, "maxFilings": { "title": "Max Filings To Scrape", "minimum": 1, "type": "integer", "description": "Maximum number of Form 5500 filings to return in this run." }, "withAiSummary": { "title": "AI plan summary (paid add-on)", "type": "boolean", "description": "Add a plain-English AI summary of each benefit plan (type, sponsor, participants, assets, notable features) via AI. Opt-in, billed per enriched record; requires a paid Apify plan.", "default": false } } }, "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 } } } } } } } } } }