HCP
A resolved healthcare professional — the unified identity, profile, and activity data we hold for a single clinician or researcher. Returned by the HCP endpoints.
- Data areas
- Healthcare
- Fields
- 22 fields · 3 PII · 1 relationships
- Export
Fields
| Field | Type | Constraints | Source | Exposed by | Description |
|---|---|---|---|---|---|
| Identity | |||||
| aggkHcpId | string | required | Identity Graph | v3 HcpResponse | AggKnowledge's stable identifier for a resolved healthcare professional. Use it to fetch or cross-reference the same HCP across endpoints and over time. |
| aggkPersonId | string | nullablefk → person | Identity Graph | v3 HcpResponse | The resolved Person this professional maps to in the identity graph, when they are also present as a person. |
| gmc | string | nullable | Third-party | v3 HcpResponse | UK General Medical Council (GMC) reference number for the professional. |
| npi | string | nullable | Third-party | v3 HcpResponse | US National Provider Identifier (NPI) for the professional. |
| orcid | string | nullable | Third-party | v3 HcpResponse | ORCID identifier for the professional, used to attribute published research. |
| rpps | string | nullable | Third-party | v3 HcpResponse | French RPPS number (Répertoire Partagé des Professionnels de Santé) for the professional. |
| Profile | |||||
| designations | string[] | required | Third-party | v3 HcpResponse | Professional designations or credentials held (e.g. MD, PhD). |
| firstName | string | nullablePII | Third-party | v3 HcpResponse | The professional's given (first) name. |
| isInactive | boolean | nullable | Derived | v3 HcpResponse | Whether the professional is flagged as inactive. |
| isIndustry | boolean | nullable | Derived | v3 HcpResponse | Whether the professional is classified as industry-affiliated. |
| lastName | string | nullablePII | Third-party | v3 HcpResponse | The professional's family (last) name. |
| middleName | string | nullablePII | Third-party | v3 HcpResponse | The professional's middle name, when known. |
| socialMediaUrl | string | nullable | Third-party | v3 HcpResponse | Normalized URL of the professional's social media profile. |
| socialProfile | string | nullable | Third-party | v3 HcpResponse | Normalized URL of the professional's social profile. The same value as socialMediaUrl, under the name the rest of v3 uses. |
| specialties | object[] | required | Third-party | v3 HcpResponse | Medical specialties the professional practices in, each with a UMLS CUI placeholder (null until the NUCC-to-UMLS mapping ships). |
| Activity | |||||
| patientCount | integer | nullable | Derived | v3 HcpResponse | Estimated number of distinct patients seen by the professional. |
| paymentsTotal | string | nullable | Third-party | v3 HcpResponse | Total industry payments received by the professional, as a formatted currency amount. |
| socialMediaMentionTotal | integer | nullable | Derived | v3 HcpResponse | Total social-media mentions of the professional. |
| topIndications | object[] | required | Derived | v3 HcpResponse | The professional's leading focus areas over their whole record, with no year breakdown: up to five per activity type, ordered by prevalence within each. Every entry names the concept, its UMLS CUI when mapped, the activity type it was ranked over and the volume behind it. Counts are not comparable between activity types, so the entries are ranked within a type and never against each other. |
| worksCounts | objectHcpWorksCounts | required | Derived | v3 HcpResponse | Publication, clinical trial, and congress counts for the professional, each broken out into a trailing 5-year and an all-time total. |
| Associations | |||||
| affiliations | object[]HcpAffiliationItem | required | Third-party | v3 HcpResponse | Organizations and institutions the professional is affiliated with, each with per-affiliation activity counts. |
| focusAreas | object[]HcpFocusAreaItem | required | Derived | v3 HcpResponse | Therapeutic focus areas derived from the professional's activity, ranked by asset volume. |
Relationships
- references one Person.