{ "openapi": "3.0.1", "info": { "title": "Nonprofit Lookup: 501c3 Status & Form 990 Search", "description": "Checks whether a US nonprofit's tax-exempt status is still valid. Form 990 data alone cannot tell you: an organisation can carry a decade of filings and the deductible flag while the IRS revoked its exemption. Reconciles the 990 record against the IRS auto-revocation list and Publication 78.", "version": "0.1", "x-build-id": "5opGcODpOvHotiH2T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aiqlabs~nonprofit-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aiqlabs-nonprofit-lookup", "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/aiqlabs~nonprofit-lookup/runs": { "post": { "operationId": "runs-sync-aiqlabs-nonprofit-lookup", "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/aiqlabs~nonprofit-lookup/run-sync": { "post": { "operationId": "run-sync-aiqlabs-nonprofit-lookup", "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": { "eins": { "title": "EINs", "type": "array", "description": "Employer Identification Numbers to audit. Hyphenated (13-4087914) and bare (134087914) both work, and a leading zero lost to a spreadsheet is restored.", "items": { "type": "string" } }, "searchQuery": { "title": "Search: name or keyword", "type": "string", "description": "Instead of, or in addition to, a list of EINs: find organisations by name or keyword and audit the matches." }, "searchState": { "title": "Search: state", "type": "string", "description": "Two-letter state code to narrow the search, for example NY." }, "searchNteeCode": { "title": "Search: NTEE major group", "type": "string", "description": "NTEE major group number (1-10) to narrow the search, for example 3 for Health." }, "searchSubsection": { "title": "Search: 501(c) subsection", "type": "string", "description": "501(c) subsection to narrow the search, for example 3 for charities." }, "maxOrganizations": { "title": "Maximum organisations", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on how many organisations to audit in one run. Anything beyond it is dropped and the count is reported in SUMMARY.", "default": 100 }, "filingGapYears": { "title": "Filing gap threshold (years)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Report an organisation whose most recent Form 990 is at least this many years old. Three consecutive missed years is what triggers automatic revocation.", "default": 3 }, "checkRevocationList": { "title": "Check the IRS auto-revocation list", "type": "boolean", "description": "Download the IRS Automatic Revocation of Exemption List. This is the only source that says whether an exemption was actually lost. Turning it off makes every exempt status unknown rather than intact.", "default": true }, "checkPublication78": { "title": "Check IRS Publication 78", "type": "boolean", "description": "Download IRS Publication 78 data, the list of organisations eligible to receive tax-deductible contributions.", "default": true }, "concurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many Form 990 lookups to run at once. ProPublica is a free public service, so keep this modest.", "default": 4 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 10, "maximum": 300, "type": "integer", "description": "Per-request timeout. The IRS bulk downloads are large, so this guards the handshake rather than the whole transfer.", "default": 60 } } }, "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 } } } } } } } } } }