Data dictionary

Every table and column in the Channel Keys listing. Refer to objects as CORE.<TABLE> under the database name you choose when you get the listing. Column names are plain uppercase identifiers, so no quoting is needed.

Keys and conventions

Tables

NDC_PRODUCT 345,642 rows

FDA NDC Directory product rows (finished, excluded and unfinished files) with typed dates and normalized application numbers.

ColumnType
PRODUCT_IDVARCHAR
PRODUCT_NDCVARCHAR
PRODUCT_NDC9VARCHAR
LABELER_CODEVARCHAR
PRODUCT_CODEVARCHAR
PRODUCT_TYPEVARCHAR
PROPRIETARY_NAMEVARCHAR
PROPRIETARY_NAME_SUFFIXVARCHAR
NONPROPRIETARY_NAMEVARCHAR
DOSAGE_FORMVARCHAR
ROUTEVARCHAR
START_MARKETING_DATEDATE
END_MARKETING_DATEDATE
MARKETING_CATEGORYVARCHAR
APPLICATION_NUMBERVARCHAR
APPL_TYPEVARCHAR
APPL_NOVARCHAR
LABELER_NAMEVARCHAR
SUBSTANCE_NAMEVARCHAR
ACTIVE_NUMERATOR_STRENGTHVARCHAR
ACTIVE_INGRED_UNITVARCHAR
PHARM_CLASSESVARCHAR
DEA_SCHEDULEVARCHAR
NDC_EXCLUDE_FLAGVARCHAR
LISTING_RECORD_CERTIFIED_THROUGHDATE
SOURCE_FILEVARCHAR
SNAPSHOT_DATEDATE

NDC_PACKAGE 640,244 rows

FDA NDC Directory package rows with the 11-digit NDC.

ColumnType
PRODUCT_IDVARCHAR
PRODUCT_NDCVARCHAR
NDC_PACKAGE_CODEVARCHAR
NDC11VARCHAR
PRODUCT_NDC9VARCHAR
PACKAGE_DESCRIPTIONVARCHAR
START_MARKETING_DATEDATE
END_MARKETING_DATEDATE
NDC_EXCLUDE_FLAGVARCHAR
SAMPLE_PACKAGEVARCHAR
SOURCE_FILEVARCHAR
SNAPSHOT_DATEDATE

DIM_NDC11 638,180 rows

One row per 11-digit NDC (5-4-2) with product, labeler, application, marketing dates, Orange Book LOE fields and discontinuation flag. Precedence: finished > unfinished > excluded.

ColumnType
NDC11VARCHAR
NDC_PACKAGE_CODEVARCHAR
PRODUCT_NDCVARCHAR
PRODUCT_NDC9VARCHAR
PRODUCT_IDVARCHAR
LABELER_CODEVARCHAR
PRODUCT_CODEVARCHAR
PACKAGE_CODEVARCHAR
PRODUCT_TYPEVARCHAR
PROPRIETARY_NAMEVARCHAR
PROPRIETARY_NAME_SUFFIXVARCHAR
NONPROPRIETARY_NAMEVARCHAR
DOSAGE_FORMVARCHAR
ROUTEVARCHAR
SUBSTANCE_NAMEVARCHAR
ACTIVE_NUMERATOR_STRENGTHVARCHAR
ACTIVE_INGRED_UNITVARCHAR
PHARM_CLASSESVARCHAR
DEA_SCHEDULEVARCHAR
MARKETING_CATEGORYVARCHAR
APPLICATION_NUMBERVARCHAR
APPL_TYPEVARCHAR
APPL_NOVARCHAR
LABELER_NAMEVARCHAR
PACKAGE_DESCRIPTIONVARCHAR
SAMPLE_PACKAGEVARCHAR
START_MARKETING_DATEDATE
END_MARKETING_DATEDATE
SOURCE_FILEVARCHAR
IS_DISCONTINUEDBOOLEAN
IN_ORANGE_BOOKBOOLEAN
OB_ANY_RLDBOOLEAN
LAST_PATENT_EXPIRYDATE
LAST_EXCLUSIVITY_DATEDATE
EST_LOE_DATEDATE
SNAPSHOT_DATEDATE
N_SOURCE_ROWSBIGINT

DIM_LABELER 18,241 rows

One row per labeler code with best name, product counts, marketing-date range and the matched CMS Open Payments manufacturer (exact or fuzzy, score shown).

ColumnType
LABELER_CODEVARCHAR
LABELER_NAMEVARCHAR
LABELER_NAME_NORMVARCHAR
N_PRODUCTSBIGINT
N_ACTIVE_PRODUCTSBIGINT
N_PACKAGESBIGINT
FIRST_MARKETING_DATEDATE
LAST_MARKETING_DATEDATE
OP_MANUFACTURER_IDVARCHAR
OP_MANUFACTURER_NAMEVARCHAR
OP_MATCH_METHODVARCHAR
OP_MATCH_SCOREDOUBLE
SNAPSHOT_DATEDATE

XREF_NDC_FORMATS 640,244 rows

Crosswalk between FDA 10-digit hyphenated NDCs (4-4-2, 5-3-2, 5-4-1), 10-digit unhyphenated and the 11-digit claims format.

ColumnType
NDC11VARCHAR
NDC10_HYPHENATEDVARCHAR
NDC10_DIGITSVARCHAR
NDC11_HYPHENATEDVARCHAR
FDA_FORMATVARCHAR
SOURCE_FILEVARCHAR
SNAPSHOT_DATEDATE

OB_PRODUCT 48,865 rows

Orange Book products (applicant, TE code, RLD/RS flags, approval date).

ColumnType
INGREDIENTVARCHAR
DF_ROUTEVARCHAR
TRADE_NAMEVARCHAR
APPLICANTVARCHAR
STRENGTHVARCHAR
APPL_TYPEVARCHAR
APPL_NOVARCHAR
PRODUCT_NOVARCHAR
TE_CODEVARCHAR
APPROVAL_DATEDATE
APPROVAL_DATE_TEXTVARCHAR
RLDVARCHAR
RSVARCHAR
OB_TYPEVARCHAR
APPLICANT_FULL_NAMEVARCHAR
SNAPSHOT_DATEDATE

OB_PATENT 22,438 rows

Orange Book patents with expiry dates, use codes and delist flags.

ColumnType
APPL_TYPEVARCHAR
APPL_NOVARCHAR
PRODUCT_NOVARCHAR
PATENT_NOVARCHAR
PATENT_EXPIRE_DATEDATE
DRUG_SUBSTANCE_FLAGVARCHAR
DRUG_PRODUCT_FLAGVARCHAR
PATENT_USE_CODEVARCHAR
DELIST_FLAGVARCHAR
SUBMISSION_DATEDATE
SNAPSHOT_DATEDATE

OB_EXCLUSIVITY 2,347 rows

Orange Book exclusivity codes and dates.

ColumnType
APPL_TYPEVARCHAR
APPL_NOVARCHAR
PRODUCT_NOVARCHAR
EXCLUSIVITY_CODEVARCHAR
EXCLUSIVITY_DATEDATE
SNAPSHOT_DATEDATE

DIM_APPLICATION 27,428 rows

One row per NDA/ANDA with first approval, last patent expiry, last exclusivity, estimated loss-of-exclusivity date and linked NDC product counts.

ColumnType
APPL_TYPEVARCHAR
APPL_NOVARCHAR
N_OB_PRODUCTSBIGINT
APPLICANTVARCHAR
APPLICANT_FULL_NAMEVARCHAR
FIRST_APPROVAL_DATEDATE
ANY_RLDBOOLEAN
TRADE_NAMESVARCHAR[]
LAST_PATENT_EXPIRYDATE
N_PATENTSBIGINT
LAST_EXCLUSIVITY_DATEDATE
EXCLUSIVITY_CODESVARCHAR[]
EST_LOE_DATEDATE
N_NDC_PRODUCTSBIGINT
N_LABELERSBIGINT
FIRST_NDC_MARKETING_DATEDATE
SNAPSHOT_DATEDATE

SDUD_UTILIZATION 17,221,265 rows

Medicaid State Drug Utilization Data by state, NDC, year and quarter (FFS and MCO), typed measures and suppression flag.

ColumnType
UTILIZATION_TYPEVARCHAR
STATEVARCHAR
NDC11VARCHAR
LABELER_CODEVARCHAR
PRODUCT_CODEVARCHAR
PACKAGE_CODEVARCHAR
YEARINTEGER
QUARTERINTEGER
YEAR_QUARTERINTEGER
SUPPRESSION_USEDBOOLEAN
PRODUCT_NAMEVARCHAR
UNITS_REIMBURSEDDOUBLE
NUMBER_OF_PRESCRIPTIONSDOUBLE
TOTAL_AMOUNT_REIMBURSEDDOUBLE
MEDICAID_AMOUNT_REIMBURSEDDOUBLE
NON_MEDICAID_AMOUNT_REIMBURSEDDOUBLE
SNAPSHOT_DATEDATE

OPAIS_COVERED_ENTITY 94,951 rows

340B OPAIS covered entities (participating and terminated) with addresses, officials and termination details.

ColumnType
ID_340BVARCHAR
CE_IDBIGINT
ENTITY_TYPEVARCHAR
ENTITY_NAMEVARCHAR
ENTITY_SUB_NAMEVARCHAR
PARTICIPATINGVARCHAR
PARTICIPATING_START_DATEDATE
TERMINATION_DATEDATE
TERMINATION_REASONVARCHAR
GRANT_NUMBERVARCHAR
SITE_IDVARCHAR
MEDICARE_PROVIDER_NUMBER"NULL"
NOFO_NUMBERVARCHAR
ASSISTANCE_FROM_DATEDATE
ASSISTANCE_TO_DATEDATE
RURALBOOLEAN
STREET_ORGANIZATION"NULL"
STREET_ADDRESS1VARCHAR
STREET_ADDRESS2VARCHAR
STREET_ADDRESS3VARCHAR
STREET_CITYVARCHAR
STREET_STATEVARCHAR
STREET_ZIPVARCHAR
STREET_ZIP4VARCHAR
BILLING_ORGANIZATIONVARCHAR
BILLING_ADDRESS1VARCHAR
BILLING_ADDRESS2VARCHAR
BILLING_ADDRESS3VARCHAR
BILLING_CITYVARCHAR
BILLING_STATEVARCHAR
BILLING_ZIPVARCHAR
BILLING_ZIP4VARCHAR
AUTHORIZING_OFFICIAL_NAMEVARCHAR
AUTHORIZING_OFFICIAL_TITLEVARCHAR
AUTHORIZING_OFFICIAL_PHONEVARCHAR
PRIMARY_CONTACT_NAMEVARCHAR
PRIMARY_CONTACT_TITLEVARCHAR
PRIMARY_CONTACT_PHONEVARCHAR
CERTIFIED_DECERTIFIED_DATETIMESTAMP
COMMENTSVARCHAR
EDIT_DATETIMESTAMP
N_CONTRACT_PHARMACIESBIGINT
IS_PARTICIPATINGBOOLEAN
SNAPSHOT_DATEDATE

OPAIS_CONTRACT_PHARMACY 409,900 rows

340B contract pharmacy arrangements per covered entity with begin and termination dates and an is_active flag.

ColumnType
ID_340BVARCHAR
CE_IDBIGINT
PHARMACY_NAMEVARCHAR
CONTRACT_IDBIGINT
PHARMACY_IDBIGINT
CONTRACT_BEGIN_DATEDATE
CONTRACT_TERMINATION_DATEDATE
PHARMACY_ORGANIZATION"NULL"
PHARMACY_ADDRESS1VARCHAR
PHARMACY_ADDRESS2VARCHAR
PHARMACY_ADDRESS3VARCHAR
PHARMACY_CITYVARCHAR
PHARMACY_STATEVARCHAR
PHARMACY_ZIPVARCHAR
PHARMACY_ZIP4VARCHAR
PHARMACY_PHONEVARCHAR
PHARMACY_PHONE_EXTVARCHAR
IS_ACTIVEBOOLEAN
SNAPSHOT_DATEDATE

OPAIS_CE_NPI 759,991 rows

NPIs registered to each 340B covered entity.

ColumnType
ID_340BVARCHAR
CE_IDBIGINT
NPIVARCHAR
STATEVARCHAR
SNAPSHOT_DATEDATE

OPAIS_CE_MEDICAID 297,056 rows

Medicaid billing numbers registered to each 340B covered entity.

ColumnType
ID_340BVARCHAR
CE_IDBIGINT
MEDICAID_NUMBERVARCHAR
STATEVARCHAR
SNAPSHOT_DATEDATE

OPAIS_CE_SHIPPING 165,048 rows

Ship-to addresses registered to each 340B covered entity.

ColumnType
ID_340BVARCHAR
CE_IDBIGINT
IS_340B_STREET_ADDRESSBOOLEAN
SHIPPING_ORGANIZATIONVARCHAR
SHIPPING_ADDRESS1VARCHAR
SHIPPING_ADDRESS2VARCHAR
SHIPPING_ADDRESS3VARCHAR
SHIPPING_CITYVARCHAR
SHIPPING_STATEVARCHAR
SHIPPING_ZIPVARCHAR
SHIPPING_ZIP4VARCHAR
SNAPSHOT_DATEDATE

OP_PAYMENT_SUMMARY 20,631 rows

CMS Open Payments general payments summarized by manufacturer, program year, recipient type, nature and form of payment.

ColumnType
MANUFACTURER_IDVARCHAR
MANUFACTURER_NAMEVARCHAR
PROGRAM_YEARINTEGER
COVERED_RECIPIENT_TYPEVARCHAR
NATURE_OF_PAYMENTVARCHAR
FORM_OF_PAYMENTVARCHAR
N_RECORDSBIGINT
N_PAYMENTSDOUBLE
TOTAL_USDDOUBLE
N_RECIPIENTSBIGINT
SNAPSHOT_DATEDATE

OP_PRODUCT_SUMMARY 66,151 rows

Open Payments general payments summarized by manufacturer and product (with NDC-11 where the reported NDC resolves), split and full-amount views.

ColumnType
MANUFACTURER_IDVARCHAR
MANUFACTURER_NAMEVARCHAR
PROGRAM_YEARINTEGER
COVERED_RECIPIENT_TYPEVARCHAR
NATURE_OF_PAYMENTVARCHAR
PRODUCT_TYPEVARCHAR
PRODUCT_CATEGORYVARCHAR
PRODUCT_NAMEVARCHAR
NDC_RAW_DIGITSVARCHAR
NDC_RAWVARCHAR
N_RECORDSBIGINT
TOTAL_USD_FULLDOUBLE
TOTAL_USD_SPLITDOUBLE
NDC11VARCHAR
SNAPSHOT_DATEDATE

OP_RECIPIENT_MANUFACTURER_YEAR 9,461,472 rows

Open Payments general payments summarized by covered recipient (NPI or profile id), manufacturer and program year.

ColumnType
COVERED_RECIPIENT_TYPEVARCHAR
PROFILE_IDVARCHAR
NPIVARCHAR
TEACHING_HOSPITAL_IDVARCHAR
TEACHING_HOSPITAL_NAMEVARCHAR
FIRST_NAMEVARCHAR
LAST_NAMEVARCHAR
SPECIALTY_1VARCHAR
RECIPIENT_STATEVARCHAR
MANUFACTURER_IDVARCHAR
MANUFACTURER_NAMEVARCHAR
PROGRAM_YEARINTEGER
N_RECORDSBIGINT
TOTAL_USDDOUBLE
SNAPSHOT_DATEDATE

OP_ENTITY_PROFILE 4,482 rows

Open Payments company and teaching-hospital profiles (physician profiles excluded).

ColumnType
ENTITY_IDVARCHAR
ENTITY_PROVIDER_TYPEVARCHAR
ENTITY_NPIVARCHAR
ENTITY_ALTERNATE_IDVARCHAR
ENTITY_TYPEVARCHAR
ENTITY_NAMEVARCHAR
ENTITY_ALTERNATE_NAME1VARCHAR
ENTITY_ALTERNATE_NAME2VARCHAR
ENTITY_ALTERNATE_NAME3VARCHAR
ENTITY_ALTERNATE_NAME4VARCHAR
ENTITY_ALTERNATE_NAME5VARCHAR
ENTITY_ADDRESS_LINE_1VARCHAR
ENTITY_ADDRESS_LINE_2VARCHAR
ENTITY_CITYVARCHAR
ENTITY_STATEVARCHAR
ENTITY_ZIPCODEVARCHAR
ENTITY_COUNTRY_NAMEVARCHAR
ENTITY_PROVINCE_NAMEVARCHAR
ENTITY_SPECIALTYVARCHAR
LOCATIONVARCHAR
SNAPSHOT_DATEDATE

CHANGE_LOG 0 rows

Row-level adds, removals and field changes between consecutive refreshes for NDC, Orange Book and 340B tables (old and new values as JSON).

ColumnType
SNAPSHOT_DATEDATE
PREV_SNAPSHOT_DATEDATE
TABLE_NAMEVARCHAR
ENTITY_KEYVARCHAR
CHANGE_TYPEVARCHAR
CHANGED_FIELDSVARCHAR[]
OLD_VALUESJSON
NEW_VALUESJSON

META_SOURCE_RUN 13 rows

Source files behind this refresh: URL, size, SHA-256 and server last-modified.

ColumnType
SOURCEVARCHAR
RUN_DATEVARCHAR
FILEVARCHAR
BYTESBIGINT
SHA256VARCHAR
URLVARCHAR
LAST_MODIFIEDVARCHAR
BUILD_DATEDATE