Skip to Content
CognitoLabs.AIDocs
Tools

Public Data

The index of the Public Data page, the explorer filters, a hospital's price file, and every table's CSV download.

These tools sit beside the row tools (Prices, Utilization, Payer rates, Hospitals) and cover what those don't: the index of the app's Public Data page, the dental filters, our copy of a hospital's price file, and the "Download all (CSV)" of every table. Each download is a short link that works for one hour.

public_sections

Every component of the Public Data page and the tool that returns it. Free.

ParameterTypeDefaultWhat it does

public_utilization_facets

The years (newest first) and, for dental codes, the service categories a utilization dataset has. Free.

ParameterTypeDefaultWhat it does
datasethcpcs | drg | hcpcs_msa | drg_provider | cdt | dental_categoryrequiredWhich CMS or Medicaid utilization table to read.

public_hospital_source_file

A link to our mirrored copy of a hospital's price file. It keeps working after the hospital's own link dies. Needs Public Data.

ParameterTypeDefaultWhat it does
hospital_idstringrequiredOne hospital id (UUID), as returned by find_hospitals.

public_export_utilization

Every matching row of a Medicare or Medicaid utilization table as a CSV. Same filters as browse_utilization. Needs Public Data.

ParameterTypeDefaultWhat it does
categorystringnoneDental category.
codeslist of stringnoneCPT, HCPCS or MS-DRG codes to look up.
datasethcpcs | drg | hcpcs_msa | drg_provider | cdt | dental_categoryrequiredWhich CMS or Medicaid utilization table to read.
dirasc | descnoneSort direction, asc or desc.
hospitalstringnoneA hospital CCN or name, or a metro or hospital id for the dataset you picked.
metrostringnoneMetro area (CBSA) code, 5 digits, for example 12060 for Atlanta. Find it with find_metro.
posF | OnonePlace of service.
qstringnoneSearch the service description, up to 200 characters.
sortstringnoneColumn to sort by.
statestringnoneTwo-letter US state, for example FL. A state on its own is not enough: add codes, apc, q or hospital_ids.
yearstringnoneData year.

public_export_charges

Every matching hospital charge line as a CSV, up to 250,000 rows. Same filters as search_price_transparency. Needs Public Data.

ParameterTypeDefaultWhat it does
apclist of stringnoneAPC codes (Medicare outpatient payment groups).
code_typeCPT | HCPCS | MS-DRG | APCnoneOnly lines of this code type.
codeslist of stringnoneCPT, HCPCS or MS-DRG codes to look up.
hospital_idslist of stringnoneUp to 25 hospital ids (UUIDs), as returned in the hospital_id field of earlier rows.
priced_onlybooleantrueHide lines that have no price. On by default.
qstringnoneSearch the service description, up to 200 characters.
settinginpatient | outpatientnoneOnly inpatient or only outpatient lines.
statestringnoneTwo-letter US state, for example FL. A state on its own is not enough: add codes, apc, q or hospital_ids.

public_export_payer_rates

Insurers' published rates for hospitals and codes as a CSV. Same filters as search_payer_rates. Needs the insurer-rates add-on.

ParameterTypeDefaultWhat it does
codeslist of stringnoneCPT, HCPCS or MS-DRG codes to look up.
hospital_idslist of stringnoneUp to 25 hospital ids (UUIDs), as returned in the hospital_id field of earlier rows.
payerstringnoneOnly this insurer, as named in the data.
statestringrequiredTwo-letter US state, for example FL. A state on its own is not enough: add codes, apc, q or hospital_ids.

public_export_provider_rates

Insurers' published rates for named providers as a CSV: the rows, or with compare=true the table with one column per payer family. Needs the insurer-rates add-on.

ParameterTypeDefaultWhat it does
billing_classprofessional | institutionalprofessionalprofessional or institutional.
codeslist of stringrequiredCPT, HCPCS or MS-DRG codes to look up.
comparebooleanfalse
familystringnoneOnly this payer family.
statestringrequiredTwo-letter US state, for example FL. A state on its own is not enough: add codes, apc, q or hospital_ids.
tinslist of stringrequiredUp to 25 provider tax ids (TIN), as returned by find_providers.

On this page