{ "openapi": "3.0.1", "info": { "title": "Nonprofit Finder: IRS Exempt Organizations by State", "description": "Find U.S. tax-exempt organizations from the IRS Exempt Organizations Business Master File. Filter by state, city, 501(c) type, NTEE cause code, revenue and assets. Records include nonprofit name, address, EIN and financial data. Ready for accountants, fundraisers and market researchers.", "version": "0.1", "x-build-id": "WbLVfUeUhoQA9FYtR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ledgerstar~nonprofit-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ledgerstar-nonprofit-finder", "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/ledgerstar~nonprofit-finder/runs": { "post": { "operationId": "runs-sync-ledgerstar-nonprofit-finder", "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/ledgerstar~nonprofit-finder/run-sync": { "post": { "operationId": "run-sync-ledgerstar-nonprofit-finder", "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": [ "states" ], "properties": { "newSince": { "title": "Alert mode: only organizations new since (optional)", "type": "string", "description": "Turns on alert mode: only return newly recognized organizations, those whose ruling date (the month the IRS recognized their exemption, taken as the first day of that month) is on or after this date. Turn on alertIncludeNewFilings below to also include organizations with a new return. Use an exact date (YYYY-MM-DD) or the word lastRun to return only organizations new since the previous successful run. Leave empty to turn alert mode off." }, "alertLookbackDays": { "title": "Alert mode: lookback safety window in days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only used with the word lastRun above. Also checks this many days before your last run for organizations the IRS posted late. You are never charged twice for the same organization or return, so a larger number is always safe.", "default": 7 }, "alertIncludeNewFilings": { "title": "Alert mode: also include new returns from existing organizations", "type": "boolean", "description": "By default alert mode only returns newly recognized organizations (a new ruling date). Turn this on to also include organizations that are not newly recognized but whose latest return or tax period is new since your date. Each new return for the same organization is delivered once.", "default": false }, "alertStateKey": { "title": "Alert mode: stable state name (optional)", "pattern": "^[a-z0-9-]{1,30}$", "type": "string", "description": "Only used with alert mode (the field above). Give this a fixed name such as vt nightly so this schedule always uses the same saved last run date, even if you change other filters. Letters, numbers and hyphens only, up to 30 characters. Leave empty to have one chosen automatically based on your filters." }, "states": { "title": "States", "type": "array", "description": "One IRS file is downloaded per state.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Puerto Rico", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [ "VT" ] }, "subsections": { "title": "501(c) types (optional)", "type": "array", "description": "e.g. 3 for 501(c)(3) charities, 4 for social-welfare groups, 6 for trade associations. Leave empty for all.", "items": { "type": "string" } }, "nteePrefixes": { "title": "Cause codes (NTEE prefixes, optional)", "type": "array", "description": "e.g. B = education, E = health care, P = human services, X = religion-related, B82 = scholarships. Leave empty for all.", "items": { "type": "string" } }, "cities": { "title": "Cities (optional)", "type": "array", "description": "Exact city name, case-insensitive.", "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP codes or prefixes (optional)", "type": "array", "description": "e.g. 05401 or 054.", "items": { "type": "string" } }, "nameKeywords": { "title": "Name contains (optional)", "type": "array", "description": "Keep organizations whose name contains any of these words, e.g. FOUNDATION, SCHOOL, CLINIC.", "items": { "type": "string" } }, "minRevenue": { "title": "Minimum annual revenue (USD, optional)", "minimum": 0, "type": "integer", "description": "From the organization's latest return on file with the IRS. Organizations without reported revenue are excluded when set." }, "maxRevenue": { "title": "Maximum annual revenue (USD, optional)", "minimum": 0, "type": "integer", "description": "Upper bound on latest reported revenue." }, "minAssets": { "title": "Minimum total assets (USD, optional)", "minimum": 0, "type": "integer", "description": "From the latest return on file." }, "rulingYearFrom": { "title": "Recognized as exempt in or after year (optional)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Find newer organizations, e.g. 2022." }, "sortBy": { "title": "Sort", "enum": [ "none", "revenueDesc", "assetsDesc" ], "type": "string", "description": "'File order' is fastest and stops as soon as enough results are found. Sorting reads the whole state file first.", "default": "none" }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 2000000, "type": "integer", "description": "Stop after this many results. You are charged per result.", "default": 20 } } }, "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 } } } } } } } } } }