340B OPAIS Delta Monitor

Monitor covered entities, contract pharmacies, statuses, states, and relationship changes in HRSA 340B OPAIS.

What this Actor does

• Runs the exact 340b-opais-delta-monitor contract against only the inputs and sources documented below.
• Emits records that are validated against the bundled dataset schema before they are written.
• Keeps source references and stable record identifiers in the output when those fields are declared.
• Provides a bounded sample path for Store inspection; the sample path does not emit a paid event.

Inputs

• mode: Use demo for Apify QA and first-time users, watchlist for production monitoring, or backfill for one-off historical collection.
• sourceMode: Choose whether to run the built-in sample or crawl supplied start URLs.
• startUrls: Approved public source URLs for this Actor run.
• maxItems: Upper bound for emitted records and pay-per-event charges.
• lookbackDays: How far back to inspect source changes when the source supports date filtering.
• baselineDatasetId: Use this when comparing against a previous run or imported snapshot.
• stateKey: Optional named state bucket for recurring monitoring. Defaults to a stable hash of the watchlist.
• sourceIds: Optional source identifiers to include in the run.
• pricingEvents: Buyer-value events expected from this actor.
• sinceLastRun: Use Actor state to skip records whose dedupe keys were saved by earlier runs.
• watchlistTerms: Optional buyer terms used to explain matches and recurring monitoring.
• webhookUrl: Optional endpoint that receives a compact completion alert for scheduled runs.
• includeSourceUrls: Include source URLs in output records.
• includeMatchReasons: Include plain-language match reasons in output records.
• includeRaw: Include compact raw source fragments when supported. Disabled by default for readable output.
• emitDiagnostics: Emit a transparent diagnostic item in demo mode if the live official source is temporarily unavailable.
• outputMode: Shape of returned records.
• actorSlug: Zentra actor slug used for review and traceability.

Sources and access boundary

• https://340bopais.hrsa.gov/
• User-supplied public or authorized source URLs provided through startUrls; live mode fails closed when neither an approved fallback nor a supplied URL exists.

Only public or user-authorized inputs may be processed. The Actor does not bypass authentication, paywalls, CAPTCHAs, access controls, or source terms.

Output

The default dataset exposes these Actor-relevant fields:

• delta_type: Delta Type value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• deltaType: Delta Type value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• entityType: Entity Type value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• entityId: Entity Id value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• name: Name value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• state: State value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• changedFields: Changed Fields value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• recordId: Record Id value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• sourceName: Source Name value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• sourceUrl: Source Url value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• retrievedAt: Retrieved At value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• confidence: Confidence value emitted by 340B OPAIS Delta Monitor when available from the configured source.
• errors: Errors value emitted by 340B OPAIS Delta Monitor when available from the configured source.

The output link exposed by .actor/OUTPUT_SCHEMA.json points to the default dataset: {{links.apiDefaultDatasetUrl}}/items.

Sample run

{
  "mode": "demo",
  "states": [
    "DC"
  ],
  "entityTypes": [
    "DSH"
  ],
  "maxItems": 1,
  "lookbackDays": 3650,
  "sourceMode": "sample",
  "outputMode": "sample-records"
}

Example fields from the bundled deterministic sample:

{
  "delta_type": "Sample delta type for 340B OPAIS Delta Monitor",
  "deltaType": "Sample delta type for 340B OPAIS Delta Monitor",
  "entityType": "Sample entity type for 340B OPAIS Delta Monitor",
  "entityId": "Sample entity id for 340B OPAIS Delta Monitor",
  "name": "Sample name for 340B OPAIS Delta Monitor",
  "state": "Sample state for 340B OPAIS Delta Monitor",
  "changedFields": "Sample changed fields for 340B OPAIS Delta Monitor",
  "recordId": "Sample record id for 340B OPAIS Delta Monitor",
  "sourceName": "340B OPAIS Delta Monitor",
  "sourceUrl": "https://apify.com/zentrafoundry/340b-opais-delta-monitor",
  "retrievedAt": "2026-01-15T09:00:00Z",
  "confidence": 1
}

Sample values are labeled as sample data and are not claims about a live source result.

Pricing and cost control

This source package preserves the Actor's current Apify pay-per-event configuration. The authenticated current event definitions are:

• result-delivered: Charged once for each validated buyer-facing result written to the dataset.

The per-result source event is result-delivered. Production output uses Apify's charged dataset push path and checks the returned charge limit before continuing. Sample, demo, test, and quality-validation paths do not emit a paid event. Start production runs with a small maxItems and an Apify run spending limit.

Reliability and limitations

• Live results depend on the supplied source availability and the fields the source actually returns.
• Missing values remain missing, null, or warning-backed according to the schema; they are not invented.
• A live run that cannot produce a schema-valid result fails instead of publishing a generic substitute.
• Output is decision-support data and does not replace legal, financial, medical, safety, procurement, or compliance review.

Existing public Actor identity

• Owner: zentrafoundry
• Actor ID: MLJ8LQMw5oT4nXxd8
• Slug: 340b-opais-delta-monitor
• Store URL: https://apify.com/zentrafoundry/340b-opais-delta-monitor

This package updates that exact existing public Actor in place. It does not create, clone, upsert, duplicate, draft, privatize, or change pricing or visibility.