# New US Healthcare Organizations β€” Weekly NPI Feed (`fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed`) Actor Latest weekly Type-2 NPI organization enumerations from official NPPES data, available as a free preview or complete one-state and nationwide editions. - **URL**: https://apify.com/fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed.md - **Developed by:** [UpsideRadar](https://apify.com/fixmyerrorcode) (community) - **Categories:** Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $29,000.00 / 1,000 nationwide weekly editions This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Receive the latest weekly set of newly enumerated US healthcare organizations without downloading and processing the large official NPPES release yourself. Choose a **free 10-record preview**, a **complete one-state or territory edition for US$9**, or the **complete nationwide edition for US$29**. Results contain newly enumerated Type-2 NPIs only, with the fields and provenance needed for repeatable analysis and automation. *Built by UpsideRadar from authoritative public data.* > **Most important limitation:** NPI enumeration does not prove that an organization has opened, is operating, is licensed, is credentialed, is Medicare-enrolled, or has buying intent. Type-1 individuals and personal contact fields are excluded. This independent product is not endorsed by or affiliated with CMS. ### Best for - healthcare market-intelligence and territory teams; - provider-network and coverage researchers; - organization onboarding and data-operations workflows; - analysts monitoring newly issued organizational identifiers. ### Why use this instead of the raw weekly release? The official archive is wide and requires discovery, secure download handling, validation, extraction, date-window interpretation, and deduplication. This Actor handles: - official weekly archive discovery; - bounded archive and CSV validation; - extraction of Type-2 organizations only; - release-window comparison and deterministic geography filtering; - deduplication and non-chargeable quarantine of invalid records; - source provenance, official archive URLs, and SHA-256 hashes; - a stable, automation-ready dataset schema; - duplicate-charge protection for the same customer, release, edition, and geography. You receive analysis-ready organization records while the full provenance, classification basis, hashes, and warnings remain available in JSON. ### Pricing and completeness | Edition | Maximum charge | What you receive | |---|---:|---| | Free preview | **US$0** | Up to 10 accepted records | | One state or territory | **US$9** | Complete eligible weekly edition for exactly one selected code | | Nationwide | **US$29** | Complete eligible nationwide weekly edition | Paid editions ignore the legacy preview limit. They return every eligible record up to the documented hard safety ceiling of **25,000 records**. If an eligible edition ever exceeds that ceiling, the run fails **before charging** instead of selling a partial edition. The edition event is charged once only after the official archive downloads, all archive and CSV checks pass, parsing completes, at least one eligible record exists, the complete edition is prepared, and the run spending limit permits the charge. A rerun of the same customer, official release, edition type, and geography is not charged again. Failures, zero-result editions, previews, duplicate editions, invalid rows, exclusions, quarantines, and internal retries do not trigger an edition charge. ### Quick start 1. Select **Free preview**. 2. Choose **One state or territory** and enter one two-letter code, or choose **Nationwide**. 3. Run the Actor and review the `organizations` dataset view. Switch to **Complete weekly edition** only when you are ready for the clearly shown fixed price. Free California preview: ```json { "mode": "preview", "geography": "selected_states", "states": ["CA"] } ```` Complete nationwide weekly edition: ```json { "mode": "weekly_edition", "geography": "nationwide" } ``` The second input can charge US$29 after successful preparation. Set the run maximum total charge to at least US$29 before starting it. ### Practical use cases #### Healthcare market intelligence Measure the weekly flow of newly issued organizational NPIs by state, city, or ZIP without treating enumeration as evidence of commercial activity. #### Territory and coverage analysis Compare organization-enumeration volume across geographies as one input to territory planning or provider-network research. #### Organization onboarding workflows Use the stable schema and NPI identifier to route newly enumerated organizations into verification, enrichment, or onboarding systems. ### Output The default table places customer-readable fields first: 1. legal organization name; 2. city, state, and ZIP; 3. enumeration date; 4. NPI and NPI status; 5. organization/subpart indicator; 6. primary taxonomy code; 7. source release end date. Full JSON also retains the official archive name and URL, archive SHA-256, collection time, classification basis, provenance, secondary taxonomy codes, and warnings. Taxonomy descriptions and organization contact fields are intentionally not added. Example: ```json { "schemaVersion": "1.0.0", "legalOrganizationName": "EXAMPLE ORGANIZATION", "city": "SACRAMENTO", "state": "CA", "zip": "95814", "enumerationDate": "2026-07-15", "npi": "1234567890", "npiStatus": "ACTIVE", "organizationSubpart": "NO", "primaryTaxonomyCode": "332B00000X", "sourceReleaseEndDate": "2026-07-19", "classification": "NEW_TYPE2_NPI", "warnings": [ "NPI enumeration does not establish opening, activity, licensing, credentialing, Medicare enrollment, or purchasing intent." ] } ``` The example name and NPI are synthetic. Production output never includes Type-1 individuals. ### What this does not tell you - whether an organization has opened or is currently operating; - whether it holds any state licence or professional credential; - whether it is enrolled in Medicare or another payer network; - whether the organization is ready to purchase, is a sales lead, or has buying intent; - whether the location, taxonomy, or organization status remains unchanged after the source release. Verify material decisions against the relevant authoritative sources. ### Source and safeguards The Actor uses official weekly NPPES V2 archives discovered from `download.cms.gov`. Only exact HTTPS weekly archive names on that host are accepted. Archives are streamed with bounded download, expansion, entry, row, time, NPI, and output limits. Redirects, traversal paths, arbitrary URLs, local paths, proxies, browser use, public debug or simulation controls, customer taxonomy filters, and full-ZIP export are rejected. ### API and automation The public inputs are `mode`, `geography`, and `states`. Older Tasks may still submit `maxItems`, `releaseSelection`, `includeFullZip`, or `editionCode`; those fields remain accepted for compatibility but are hidden from the ordinary form. Paid completeness, release discovery, full-ZIP protection, billing attribution, and duplicate-charge keys are enforced internally. For a recurring workflow, save a free-preview Task first. Review the returned schema and current release, then create a separately named paid Task with an explicit maximum total charge of US$9 or US$29. ### Support and troubleshooting - **State input rejected:** provide exactly one valid two-letter US state or territory code. - **Spending limit rejected:** set the run maximum total charge to at least US$9 for one state or US$29 nationwide. - **No records:** the selected geography may have no eligible Type-2 enumeration in the current weekly release; zero-result editions are not charged. - **Duplicate edition:** the same customer, release, edition type, and geography was already charged; the rerun is not charged again. - **Safety ceiling exceeded:** the complete eligible edition is above 25,000 records, so the Actor stops before charging. - **Source or archive failure:** validation fails closed. Retry later or report the failed run through the Actor’s Issues tab with the run ID and non-sensitive log excerpt. Do not include API tokens, personal information, or private datasets in a public issue. # Actor input Schema ## `mode` (type: `string`): Free preview always returns at most 10 accepted records. Complete weekly edition ignores any legacy preview limit. ## `geography` (type: `string`): Choose exactly one state or territory for US$9, or nationwide for US$29. ## `states` (type: `array`): Enter exactly one two-letter code, such as CA, TX, FL, or NY. Ignored for nationwide editions. ## `maxItems` (type: `integer`): API compatibility only. Preview is capped at 10; paid editions always use the 25,000-record safety ceiling and never inherit this value. ## `includeFullZip` (type: `boolean`): API compatibility only. Must remain false; source archives are validated in memory and never exported. ## `releaseSelection` (type: `string`): API compatibility only. The public product always discovers the latest completed official weekly release. ## `editionCode` (type: `string`): Accepted for older Tasks but ignored. Billing attribution and duplicate protection are generated internally from the customer, official release, edition type, and geography. ## Actor input object example ```json { "mode": "preview", "geography": "selected_states", "states": [ "CA" ], "maxItems": 10, "includeFullZip": false, "releaseSelection": "latest_completed_week" } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `runSummary` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed").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 = {} # Run the Actor and wait for it to finish run = client.actor("fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed").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 '{}' | apify call fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fixmyerrorcode/newly-enumerated-us-healthcare-organizations-weekly-npi-feed", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "New US Healthcare Organizations β€” Weekly NPI Feed", "description": "Latest weekly Type-2 NPI organization enumerations from official NPPES data, available as a free preview or complete one-state and nationwide editions.", "version": "0.1", "x-build-id": "xikFzVGgFbwmD5krw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fixmyerrorcode~newly-enumerated-us-healthcare-organizations-weekly-npi-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fixmyerrorcode-newly-enumerated-us-healthcare-organizations-weekly-npi-feed", "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/fixmyerrorcode~newly-enumerated-us-healthcare-organizations-weekly-npi-feed/runs": { "post": { "operationId": "runs-sync-fixmyerrorcode-newly-enumerated-us-healthcare-organizations-weekly-npi-feed", "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/fixmyerrorcode~newly-enumerated-us-healthcare-organizations-weekly-npi-feed/run-sync": { "post": { "operationId": "run-sync-fixmyerrorcode-newly-enumerated-us-healthcare-organizations-weekly-npi-feed", "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": [ "mode", "geography" ], "properties": { "mode": { "title": "Edition", "enum": [ "preview", "weekly_edition" ], "type": "string", "description": "Free preview always returns at most 10 accepted records. Complete weekly edition ignores any legacy preview limit.", "default": "preview" }, "geography": { "title": "Geography", "enum": [ "selected_states", "nationwide" ], "type": "string", "description": "Choose exactly one state or territory for US$9, or nationwide for US$29.", "default": "selected_states" }, "states": { "title": "State or territory code", "minItems": 1, "maxItems": 1, "uniqueItems": true, "type": "array", "description": "Enter exactly one two-letter code, such as CA, TX, FL, or NY. Ignored for nationwide editions.", "items": { "type": "string", "pattern": "^[A-Za-z]{2}$" }, "default": [ "CA" ] }, "maxItems": { "title": "Legacy record limit", "minimum": 1, "maximum": 25000, "type": "integer", "description": "API compatibility only. Preview is capped at 10; paid editions always use the 25,000-record safety ceiling and never inherit this value.", "default": 10 }, "includeFullZip": { "title": "Legacy full-ZIP export", "type": "boolean", "description": "API compatibility only. Must remain false; source archives are validated in memory and never exported.", "default": false }, "releaseSelection": { "title": "Release selection", "type": "string", "description": "API compatibility only. The public product always discovers the latest completed official weekly release.", "default": "latest_completed_week" }, "editionCode": { "title": "Legacy edition code", "pattern": "^[a-z0-9][a-z0-9_-]{2,63}$", "type": "string", "description": "Accepted for older Tasks but ignored. Billing attribution and duplicate protection are generated internally from the customer, official release, edition type, and geography." } } }, "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 } } } } } } } } } } ```