Newly Enumerated US Healthcare Organizations — local 1.1 candidate

Deployment boundary: this working-tree copy describes the local 1.1.0 material-upgrade candidate. The current public Apify release is build 0.0.13, evidenced by validation/APIFY_PUBLICATION_2026-07-26.json. Taxonomy filtering and the added Type-2 business-practice fields below are not live public capabilities until the 25 August commercial gate, pre-action scoped approval, promotion and authenticated readback all pass. Do not use this README alone to determine the live contract.

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 authorized-official/personal fields are excluded. Business-practice details are source-reported and not independently verified. 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 or exact-taxonomy-code 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:

{
  "mode": "preview",
  "geography": "selected_states",
  "states": ["CA"]
}

Complete nationwide weekly edition:

{
  "mode": "weekly_edition",
  "geography": "nationwide"
}

Behavioral-health taxonomy preview (local 1.1 candidate only; not public on build 0.0.13):

{
  "mode": "preview",
  "geography": "selected_states",
  "states": ["CA"],
  "taxonomyCodes": ["261QM0850X"]
}

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 — local 1.1 candidate

The default table places customer-readable fields first:

1. legal and other organization names;
2. source-reported business-practice address and organization phone;
3. city, state, and ZIP;
4. enumeration date;
5. NPI and the limited source-release deactivation status;
6. organization/subpart indicator;
7. primary and additional taxonomy codes;
8. source release end date.

Full JSON also retains the official archive name and URL, archive SHA-256, actual observation time, classification basis, provenance, all taxonomy positions, and warnings. Taxonomy descriptions and curated groups remain withheld pending an approved commercial-use mapping.

Example:

{
  "schemaVersion": "1.1.0",
  "recordType": "nppes_type2_organization_enumeration",
  "signalId": "nppes:type2:1234567890:2026-07-15",
  "legalOrganizationName": "EXAMPLE ORGANIZATION",
  "businessPracticeAddressLine1": "100 EXAMPLE AVE",
  "city": "SACRAMENTO",
  "state": "CA",
  "zip": "95814",
  "organizationPhone": "5555550100",
  "enumerationDate": "2026-07-15",
  "npi": "1234567890",
  "npiStatus": "NOT_DEACTIVATED_IN_SOURCE_RELEASE",
  "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, unvalidated taxonomy values, and full-ZIP export are rejected.

API and automation — local 1.1 candidate

The candidate 1.1 inputs are mode, geography, states, and optional exact taxonomyCodes. A matching record may use any of its source-reported taxonomy positions. These statements do not alter the current public 0.0.13 contract. Older Tasks may still submit maxItems, releaseSelection, includeFullZip, or editionCode; those fields remain accepted for candidate 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.