Overview

Candid Health is an open data platform and 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. Available datasets and their schemas are listed below.

Refresh Cadence

Tables are refreshed on a nightly cadence.

Please email support@joincandidhealth.com for more information and access to the feature.

Table Information

Encounter & Service Line Metadata

Schemas

FieldTypeKey
encounter_idSTRINGPK
created_atDATETIME
updated_atDATETIME
organization_idSTRING
organization_nameSTRING
date_of_serviceDATE
external_idSTRING
prior_authorization_numberSTRING
patient_authorized_releaseBOOL
benefits_assigned_to_providerBOOL
provider_accepts_assignmentBOOL
appointment_typeSTRING
place_of_service_codeSTRING
place_of_service_code_as_submittedSTRING
delay_reason_codeSTRING
coding_attributionSTRING
synchronicitySTRING
billing_provider_idSTRING
billing_provider_first_nameSTRING
billing_provider_last_nameSTRING
billing_provider_organization_nameSTRING
billing_provider_tax_idSTRING
billing_provider_npiSTRING
billing_provider_taxonomy_codeSTRING
billing_provider_qualifierSTRING
billing_provider_address_address_1STRING
billing_provider_address_address_2STRING
billing_provider_address_citySTRING
billing_provider_address_stateSTRING
billing_provider_address_zip_codeSTRING
billing_provider_address_zip_plus_four_codeSTRING
rendering_provider_first_nameSTRING
rendering_provider_last_nameSTRING
rendering_provider_organization_nameSTRING
rendering_provider_tax_idSTRING
rendering_provider_npiSTRING
rendering_provider_taxonomy_codeSTRING
rendering_provider_qualifierSTRING
rendering_provider_address_address_1STRING
rendering_provider_address_address_2STRING
rendering_provider_address_citySTRING
rendering_provider_address_stateSTRING
rendering_provider_address_zip_codeSTRING
rendering_provider_address_zip_plus_four_codeSTRING
referring_provider_first_nameSTRING
referring_provider_last_nameSTRING
referring_provider_organization_nameSTRING
referring_provider_tax_idSTRING
referring_provider_npiSTRING
referring_provider_taxonomy_codeSTRING
referring_provider_qualifierSTRING
referring_provider_address_address_1STRING
referring_provider_address_address_2STRING
referring_provider_address_citySTRING
referring_provider_address_stateSTRING
referring_provider_address_zip_codeSTRING
referring_provider_address_zip_plus_four_codeSTRING
initial_referring_provider_first_nameSTRING
initial_referring_provider_last_nameSTRING
initial_referring_provider_organization_nameSTRING
initial_referring_provider_tax_idSTRING
initial_referring_provider_npiSTRING
initial_referring_provider_taxonomy_codeSTRING
initial_referring_provider_qualifierSTRING
initial_referring_provider_address_address_1STRING
initial_referring_provider_address_address_2STRING
initial_referring_provider_address_citySTRING
initial_referring_provider_address_stateSTRING
initial_referring_provider_address_zip_codeSTRING
initial_referring_provider_address_zip_plus_four_codeSTRING
supervising_provider_first_nameSTRING
supervising_provider_last_nameSTRING
supervising_provider_organization_nameSTRING
supervising_provider_tax_idSTRING
supervising_provider_npiSTRING
supervising_provider_taxonomy_codeSTRING
supervising_provider_qualifierSTRING
supervising_provider_address_address_1STRING
supervising_provider_address_address_2STRING
supervising_provider_address_citySTRING
supervising_provider_address_stateSTRING
supervising_provider_address_zip_codeSTRING
supervising_provider_address_zip_plus_four_codeSTRING
ordering_provider_first_nameSTRING
ordering_provider_last_nameSTRING
ordering_provider_organization_nameSTRING
ordering_provider_tax_idSTRING
ordering_provider_npiSTRING
ordering_provider_taxonomy_codeSTRING
ordering_provider_qualifierSTRING
ordering_provider_address_address_1STRING
ordering_provider_address_address_2STRING
ordering_provider_address_citySTRING
ordering_provider_address_stateSTRING
ordering_provider_address_zip_codeSTRING
ordering_provider_address_zip_plus_four_codeSTRING
service_facility_idSTRING
service_facility_organization_nameSTRING
service_facility_npiSTRING
service_facility_address_address_1STRING
service_facility_address_address_2STRING
service_facility_address_citySTRING
service_facility_address_stateSTRING
service_facility_address_zip_codeSTRING
service_facility_address_zip_plus_four_codeSTRING
pay_to_address_address_1STRING
pay_to_address_address_2STRING
pay_to_address_citySTRING
pay_to_address_stateSTRING
pay_to_address_zip_codeSTRING
pay_to_address_zip_plus_four_codeSTRING
patient_external_idSTRING
patient_first_nameSTRING
patient_last_nameSTRING
patient_genderSTRING
patient_date_of_birthDATE
patient_address_address_1STRING
patient_address_address_2STRING
patient_address_citySTRING
patient_address_stateSTRING
patient_address_zip_codeSTRING
patient_address_zip_plus_four_codeSTRING
patient_phone_numbersARRAY<STRING>
patient_phone_consentBOOL
patient_emailSTRING
patient_email_consentBOOL
guarantor_external_idSTRING
guarantor_first_nameSTRING
guarantor_last_nameSTRING
guarantor_date_of_birthDATE
guarantor_address_address_1STRING
guarantor_address_address_2STRING
guarantor_address_citySTRING
guarantor_address_stateSTRING
guarantor_address_zip_codeSTRING
guarantor_address_zip_plus_four_codeSTRING
guarantor_phone_numbersARRAY<STRING>
guarantor_phone_consentBOOL
guarantor_emailSTRING
guarantor_email_consentBOOL
subscriber_primary_first_nameSTRING
subscriber_primary_last_nameSTRING
subscriber_primary_genderSTRING
subscriber_primary_date_of_birthDATE
subscriber_primary_patient_relationship_to_subscriber_codeSTRING
subscriber_primary_address_address_1STRING
subscriber_primary_address_address_2STRING
subscriber_primary_address_citySTRING
subscriber_primary_address_stateSTRING
subscriber_primary_address_zip_codeSTRING
subscriber_primary_address_zip_plus_four_codeSTRING
subscriber_primary_insurance_card_member_idSTRING
subscriber_primary_insurance_card_group_numberSTRING
subscriber_primary_payer_plan_group_idSTRING
subscriber_primary_payer_plan_group_nameSTRING
subscriber_primary_insurance_card_plan_nameSTRING
subscriber_primary_insurance_card_plan_typeSTRING
subscriber_primary_insurance_card_insurance_typeSTRING
subscriber_primary_insurance_card_payer_nameSTRING
subscriber_primary_insurance_card_payer_idSTRING
subscriber_primary_insurance_card_rx_binSTRING
subscriber_primary_insurance_card_rx_pcnSTRING
subscriber_primary_insurance_card_payer_address_address_1STRING
subscriber_primary_insurance_card_payer_address_address_2STRING
subscriber_primary_insurance_card_payer_address_citySTRING
subscriber_primary_insurance_card_payer_address_stateSTRING
subscriber_primary_insurance_card_payer_address_zip_codeSTRING
subscriber_primary_insurance_card_payer_address_zip_plus_four_codeSTRING
subscriber_secondary_first_nameSTRING
subscriber_secondary_last_nameSTRING
subscriber_secondary_genderSTRING
subscriber_secondary_date_of_birthDATE
subscriber_secondary_patient_relationship_to_subscriber_codeSTRING
subscriber_secondary_address_address_1STRING
subscriber_secondary_address_address_2STRING
subscriber_secondary_address_citySTRING
subscriber_secondary_address_stateSTRING
subscriber_secondary_address_zip_codeSTRING
subscriber_secondary_address_zip_plus_four_codeSTRING
subscriber_secondary_insurance_card_member_idSTRING
subscriber_secondary_insurance_card_group_numberSTRING
subscriber_secondary_payer_plan_group_idSTRING
subscriber_secondary_payer_plan_group_nameSTRING
subscriber_secondary_insurance_card_plan_nameSTRING
subscriber_secondary_insurance_card_plan_typeSTRING
subscriber_secondary_insurance_card_insurance_typeSTRING
subscriber_secondary_insurance_card_payer_nameSTRING
subscriber_secondary_insurance_card_payer_idSTRING
subscriber_secondary_insurance_card_rx_binSTRING
subscriber_secondary_insurance_card_rx_pcnSTRING
subscriber_secondary_insurance_card_payer_address_address_1STRING
subscriber_secondary_insurance_card_payer_address_address_2STRING
subscriber_secondary_insurance_card_payer_address_citySTRING
subscriber_secondary_insurance_card_payer_address_stateSTRING
subscriber_secondary_insurance_card_payer_address_zip_codeSTRING
subscriber_secondary_insurance_card_payer_address_zip_plus_four_codeSTRING
subscriber_tertiary_first_nameSTRING
subscriber_tertiary_last_nameSTRING
subscriber_tertiary_genderSTRING
subscriber_tertiary_date_of_birthDATE
subscriber_tertiary_patient_relationship_to_subscriber_codeSTRING
subscriber_tertiary_address_address_1STRING
subscriber_tertiary_address_address_2STRING
subscriber_tertiary_address_citySTRING
subscriber_tertiary_address_stateSTRING
subscriber_tertiary_address_zip_codeSTRING
subscriber_tertiary_address_zip_plus_four_codeSTRING
subscriber_tertiary_insurance_card_member_idSTRING
subscriber_tertiary_insurance_card_group_numberSTRING
subscriber_tertiary_payer_plan_group_idSTRING
subscriber_tertiary_payer_plan_group_nameSTRING
subscriber_tertiary_insurance_card_plan_nameSTRING
subscriber_tertiary_insurance_card_plan_typeSTRING
subscriber_tertiary_insurance_card_insurance_typeSTRING
subscriber_tertiary_insurance_card_payer_nameSTRING
subscriber_tertiary_insurance_card_payer_idSTRING
subscriber_tertiary_insurance_card_rx_binSTRING
subscriber_tertiary_insurance_card_rx_pcnSTRING
subscriber_tertiary_insurance_card_payer_address_address_1STRING
subscriber_tertiary_insurance_card_payer_address_address_2STRING
subscriber_tertiary_insurance_card_payer_address_citySTRING
subscriber_tertiary_insurance_card_payer_address_stateSTRING
subscriber_tertiary_insurance_card_payer_address_zip_codeSTRING
subscriber_tertiary_insurance_card_payer_address_zip_plus_four_codeSTRING
vitals_height_inINT64
vitals_weight_lbsINT64
vitals_blood_pressure_systolic_mmhgINT64
vitals_blood_pressure_diastolic_mmhgINT64
vitals_body_temperature_fFLOAT64
vitals_hemoglobin_gdlFLOAT64
vitals_hematocrit_pctFLOAT64
responsible_partySTRING
billable_statusSTRING
claim_idSTRINGPK
claim_patient_control_numberSTRING
claim_externally_generated_patient_control_numberSTRING
claim_statusSTRING
claim_adjudicated_network_statusSTRING
claim_clia_numberSTRING
diagnosis_codesSTRING
FieldTypeKey
service_line_idSTRINGPK
created_atDATETIME
updated_atDATETIME
encounter_idSTRING
organization_idSTRING
organization_nameSTRING
procedure_codeSTRING
date_of_serviceDATE
end_date_of_serviceDATE
quantitySTRING
unitsSTRING
modifiersARRAY<STRING>
positionINT64
diagnosis_zero_nameSTRING
diagnosis_zero_codeSTRING
diagnosis_zero_code_typeSTRING
diagnosis_zero_positionINT64
diagnosis_one_nameSTRING
diagnosis_one_codeSTRING
diagnosis_one_code_typeSTRING
diagnosis_one_positionINT64
diagnosis_two_nameSTRING
diagnosis_two_codeSTRING
diagnosis_two_code_typeSTRING
diagnosis_two_positionINT64
diagnosis_three_nameSTRING
diagnosis_three_codeSTRING
diagnosis_three_code_typeSTRING
diagnosis_three_positionINT64
drug_identification_service_id_qualifierSTRING
drug_identification_national_drug_codeSTRING
drug_identification_national_drug_unit_countSTRING
drug_identification_measurement_unit_codeSTRING
drug_identification_link_sequence_numberSTRING
drug_identification_pharmacy_prescription_numberSTRING
conversion_formulaSTRING
drug_descriptionSTRING
place_of_service_codeSTRING
place_of_service_code_as_submittedSTRING
descriptionSTRING
referring_provider_first_nameSTRING
referring_provider_last_nameSTRING
referring_provider_organization_nameSTRING
referring_provider_tax_idSTRING
referring_provider_npiSTRING
referring_provider_taxonomy_codeSTRING
referring_provider_qualifierSTRING
referring_provider_address_address_1STRING
referring_provider_address_address_2STRING
referring_provider_address_citySTRING
referring_provider_address_stateSTRING
referring_provider_address_zip_codeSTRING
referring_provider_address_zip_plus_four_codeSTRING
initial_referring_provider_first_nameSTRING
initial_referring_provider_last_nameSTRING
initial_referring_provider_organization_nameSTRING
initial_referring_provider_tax_idSTRING
initial_referring_provider_npiSTRING
initial_referring_provider_taxonomy_codeSTRING
initial_referring_provider_qualifierSTRING
initial_referring_provider_address_address_1STRING
initial_referring_provider_address_address_2STRING
initial_referring_provider_address_citySTRING
initial_referring_provider_address_stateSTRING
initial_referring_provider_address_zip_codeSTRING
initial_referring_provider_address_zip_plus_four_codeSTRING
supervising_provider_first_nameSTRING
supervising_provider_last_nameSTRING
supervising_provider_organization_nameSTRING
supervising_provider_tax_idSTRING
supervising_provider_npiSTRING
supervising_provider_taxonomy_codeSTRING
supervising_provider_qualifierSTRING
supervising_provider_address_address_1STRING
supervising_provider_address_address_2STRING
supervising_provider_address_citySTRING
supervising_provider_address_stateSTRING
supervising_provider_address_zip_codeSTRING
supervising_provider_address_zip_plus_four_codeSTRING
ordering_provider_first_nameSTRING
ordering_provider_last_nameSTRING
ordering_provider_organization_nameSTRING
ordering_provider_tax_idSTRING
ordering_provider_npiSTRING
ordering_provider_taxonomy_codeSTRING
ordering_provider_qualifierSTRING
ordering_provider_address_address_1STRING
ordering_provider_address_address_2STRING
ordering_provider_address_citySTRING
ordering_provider_address_stateSTRING
ordering_provider_address_zip_codeSTRING
ordering_provider_address_zip_plus_four_codeSTRING

Financial Transactions Data

The core of the financial transactions data model is the export_transaction table. This table will have most of the information you need to analyze your financial transactions. If you need to access more detailed data about one type of transaction, you can join the export_transaction table to one of the associated detail tables using an inner join:

1SELECT
2 *
3FROM export_transaction
4JOIN export_adjustment_details
5 ON export_transaction.transaction_type = 'ADJUSTMENT'
6 AND export_transaction.transaction_id = export_adjustment_details.transaction_id

Full diagram of relationships and JOIN predicates:

Informational Adjustments are not associated with financial transactions and can be directly associated with Service Lines or Encounters

Service Line Charges can be joined to Transactions through the charge_id and also to Service Lines through the service_line_id:

1SELECT
2 *
3FROM export_transaction
4JOIN export_service_line_charge
5 ON export_transaction.charge_id = export_service_line_charge.id
6JOIN export_service_line
7 ON export_service_line_charge.service_line_id = export_service_lineservice_line_id

In diagram form:

Schemas

FieldTypeKey
transaction_idSTRINGPK
transaction_typeSTRING
voids_transaction_idSTRING
voided_by_transaction_idSTRING
transaction_timestampTIMESTAMP
organization_idSTRING
organization_nameSTRING
amount_centsINT64
target_idSTRING
target_typeSTRING
counter_party_idSTRING
counter_party_typeSTRING
payer_plan_group_idSTRING
batch_dateTIMESTAMP
encounter_idSTRING
service_line_idSTRING
charge_idSTRING
FieldTypeKey
transaction_idSTRINGPK
payment_posted_dateTIMESTAMP
check_dateDATE
claim_status_codeINT64
payment_typeSTRING
external_payment_idSTRING
payer_plan_group_idSTRING
charge_idSTRING
organization_idSTRING
organization_nameSTRING
FieldTypeKey
transaction_idSTRINGPK
sourceSTRING
carcSTRING
external_payment_idSTRING
check_dateDATE
adjustment_reasonSTRING
payer_plan_group_idSTRING
charge_idSTRING
posted_statusSTRING
organization_idSTRING
organization_nameSTRING
FieldTypeKey
idSTRINGPK
organization_idSTRING
organization_nameSTRING
adjustment_timestampTIMESTAMP
adjustment_typeSTRING
posted_statusSTRING
amount_centsINT64
carcSTRING
patient_idSTRING
encounter_idSTRING
service_line_idSTRING
latest_charge_idSTRING
FieldTypeKey
created_atTIMESTAMP
updated_atTIMESTAMP
idSTRINGPK
organization_idSTRING
service_line_idSTRING
billing_provider_npiSTRING
procedure_codeSTRING
quantityNUMERIC
date_of_serviceTIMESTAMP
rendering_provider_npiSTRING
place_of_service_codeSTRING
charge_statusSTRING
billing_provider_tax_idSTRING
service_facility_nameSTRING
service_facility_address1STRING
service_facility_citySTRING
service_facility_stateSTRING
service_facility_zip_codeSTRING