{ "openapi": "3.0.1", "info": { "title": "IRS 990 Nonprofit Officers and Compensation", "description": "Named officers, directors and key employees with pay, hours and titles from IRS e-filed 990, 990-EZ and 990-PF returns.", "version": "0.3", "x-build-id": "rAJRxplowYtS15GaL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagrit~irs-990-officer-compensation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagrit-irs-990-officer-compensation", "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/datagrit~irs-990-officer-compensation/runs": { "post": { "operationId": "runs-sync-datagrit-irs-990-officer-compensation", "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/datagrit~irs-990-officer-compensation/run-sync": { "post": { "operationId": "run-sync-datagrit-irs-990-officer-compensation", "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": [ "organizations" ], "properties": { "organizations": { "title": "Organizations (EIN or name)", "type": "array", "description": "Nonprofits to look up. Each entry is either a 9-digit EIN (with or without the dash, e.g. 53-0196605) or part of an organization name (at least 3 characters, case-insensitive, matched against the name on the IRS filing index). A name can match many organizations, so combine it with Maximum results.", "default": [ "53-0196605" ], "items": { "type": "string" } }, "filingYears": { "title": "IRS filing years to search", "type": "array", "description": "Years in which the returns were e-filed with the IRS (not the tax year). Supported: 2024 and later. Leave empty to search the current and the previous filing year, which covers the latest return of almost every organization. Each year adds a 14-28 MB index download and about 15 seconds to the run. Tax years from about 2022 on are covered; older returns are not available through the IRS indexes this Actor reads.", "items": { "type": "integer", "minimum": 2024 } }, "onlyLatestTaxYear": { "title": "Only the latest tax year per organization", "type": "boolean", "description": "Return people from the most recent tax period found for each organization. Turn off to get every period found in the selected filing years, for example to see how pay changed between years.", "default": true }, "taxYears": { "title": "Tax years", "type": "array", "description": "Only returns whose tax period ends in one of these years, e.g. [2023]. Leave empty for any year. Only years covered by the selected filing years can match (2022 and later)." }, "formTypes": { "title": "Form types", "type": "array", "description": "Which IRS forms to read. Allowed: 990 (full return: roles, related-organization pay, Schedule J breakdown, contractors), 990EZ (small organizations: officers, directors, key employees and, if listed, the five highest-paid employees and contractors), 990PF (private foundations: officers, trustees, the five highest-paid employees and contractors). Leave empty for all three.", "default": [ "990", "990EZ", "990PF" ], "items": { "type": "string" } }, "roles": { "title": "Roles", "type": "array", "description": "Keep only people with one of these roles. Allowed: officer, director-trustee, key-employee, highest-compensated-employee, former, independent-contractor. Form 990 reports all six; Form 990-PF and Form 990-EZ report only highest-compensated-employee and independent-contractor, so setting this excludes their officers, directors and trustees. Leave empty for everyone.", "items": { "type": "string" } }, "minCompensationUsd": { "title": "Minimum total compensation (USD)", "minimum": 0, "type": "integer", "description": "Keep only people whose total reported compensation is at least this amount. 0 keeps everyone, including unpaid board members.", "default": 0 }, "includeContractors": { "title": "Include independent contractors", "type": "boolean", "description": "Add the five highest-paid independent contractors listed on Form 990 Part VII Section B, Form 990-EZ Part VI line 51 or Form 990-PF Part VII-B, with the services they provided. Selecting the independent-contractor role turns this on.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many rows in total across all organizations.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Leave disabled: the IRS site does not block datacenter traffic, and a residential proxy only raises the platform cost of the run.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }