Candid Data Share | Candid

Candid Data Share is an open data platform that makes it easy to retrieve datasets out of Candid Health in a first-class way. The intention of this Data Share is to provide access to datasets that can be easily synchronized into other data platforms for customer and partner needs outside of the Candid Health platform.

Cloud-native access to these shared BigQuery datasets is provided through service account credentials. In addition to using one of BigQuery’s client libraries, external tools such as Fivetran or Airbyte can be configured with those credentials to provide direct access to and automatically synchronize the datasets.

Do Not Use For Patient Invoicing

Candid Data Share is not designed to support patient invoicing workflows. For all patient invoicing use cases, you must use the Patient Invoicing API. This is the only supported method for ensuring balance accuracy.

Candid Data Share data is generated on a periodic basis and does not provide a live, real-time view of a patient’s balance. Please be advised that Candid cannot support issues related to invoicing breaks or inaccuracies that result from using Candid Data Share for this purpose.

Refresh Cadence

Tables are refreshed on a nightly cadence.

Additional Resources

Available datasets and their schemas are listed in the table groups below.
If you manage your own data ingestion pipeline, please reference this Support Center article for efficient implementation guidance: Candid Data Share: Incremental Data Pulls

Access & Support

Breaking changes to Candid Data Share will be shared with customers at least a month in advance. A new table being created or a new field being added to an existing table is not considered a breaking change.

Please email support@joincandidhealth.com for more information and access to Candid Data Share.

Table Groups

Encounters & Service Lines

Core encounter and service line data with associated financial summaries.

Table	Description
export_encounter	Data at the encounter level
export_financial_summary	Persisted financial summary at the encounter level, including patient responsibility, copay, deductible, and coinsurance
export_service_line	Data at the service line level
export_service_line_financial_summary	Persisted financial summary at the service line level, including patient responsibility, copay, deductible, and coinsurance
export_service_line_projected_financials	Projected financial data at the service line level

Financial Transactions

Transaction-level data including payments, charges, and adjustments.

Table	Description
export_adjustment_details	Additional information related to balance-impacting adjustments
export_batch_details	Batch period details for financial grouping
export_charge_details	Additional information related to charges on a claim
export_informational_adjustment_details	Additional information related to non-balance-impacting adjustments
export_payment_details	Additional information related to payments
export_transaction	Essential information related to transactions

Patients & Payers

Patient merge tracking and payer information.

Table	Description
export_patient_merge	Synchronizes and tracks patient identities across multiple EMRs, ensuring a cleaner single source of truth for patient data
export_payer	Essential information related to payers on Candid