> For the complete documentation index, see [llms.txt](https://docs.teleskope.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.teleskope.ai/specifications/entity-taxonomy-v2.md).

# Data Elements

Entity Taxonomy v2 organizes **62 entity labels** into **9 hierarchical families** using dot notation. For example, `PERSONAL.name.given` is the v2 label for a given name.

{% hint style="info" %}
Teleskope environments are being migrated to Entity Taxonomy v2 in phases. Some environments may continue to return v1 labels until their migration is complete.
{% endhint %}

## How Data Elements Are Detected

Teleskope classifies content in two independent ways. **Data elements** identify specific sensitive values inside the content, such as a name or an API key. **Document types** describe what a file is about, such as a contract or a financial forecast, and are covered in [Document Type Manager](https://docs.teleskope.ai/the-platform/document-type-manager.md#how-document-types-are-assigned).

1. **Extract.** Text is extracted from each file, including text in images. See [File Formats](https://docs.teleskope.ai/specifications/file-formats.md) for supported formats.
2. **Detect.** A machine learning model is the primary detector, supplemented by pattern rules:
   * **The machine learning model** uses the surrounding context to identify and label sensitive values, including those with no fixed format, such as names, addresses, and health conditions.
   * **Pattern rules** are regular expressions that fill gaps in the model's coverage for values with a strict format, such as country-specific national IDs and provider-specific API keys.
3. **Refine.** Results are combined and filtered to remove duplicates and low-confidence matches. Sub-elements are reported under their parent label.
4. **Quality check.** Where enabled, an AI review acts as an additional validation layer on detected matches.

## Label Structure

| Level | Description | Example               |
| ----- | ----------- | --------------------- |
| L1    | Family      | `PERSONAL`            |
| L2    | Category    | `PERSONAL.name`       |
| L3    | Subcategory | `PERSONAL.name.given` |

Some labels also have **sub-elements**: narrower detectors for a specific country or provider format, such as a Spanish DNI under `GOVERNMENT.national_id` or an OpenAI API key under `SECRETS.api_key`. Sub-elements improve detection but are not reported separately. A match is reported under its parent label and sub-elements do not appear as selectable elements. See [Sub-Elements](#sub-elements) for the full list.

Different categories of elements are separated into tables and optional descriptions are provided for ambiguous element names.

### Personal Information

Core personal identifiers. `PERSONAL.dob` captures full and partial dates of birth.

| Parent Label       | Element Label             | Description                            |
| ------------------ | ------------------------- | -------------------------------------- |
| `PERSONAL`         | `PERSONAL.name`           | Full or unspecified person name        |
| `PERSONAL.name`    | `PERSONAL.name.given`     | Given or first name                    |
| `PERSONAL.name`    | `PERSONAL.name.family`    | Family or last name                    |
| `PERSONAL`         | `PERSONAL.email`          | Email address                          |
| `PERSONAL`         | `PERSONAL.phone`          | Phone number                           |
| `PERSONAL`         | `PERSONAL.dob`            | Date of birth, including partial dates |
| `PERSONAL`         | `PERSONAL.username`       | Username or handle                     |
| `PERSONAL`         | `PERSONAL.address`        | Full or unspecified address            |
| `PERSONAL.address` | `PERSONAL.address.street` | Street address                         |
| `PERSONAL.address` | `PERSONAL.address.unit`   | Apartment, suite, or unit              |
| `PERSONAL.address` | `PERSONAL.address.po_box` | Post office box                        |

### Protected Information

Protected class attributes relevant to Title VII and related regulations.

| Parent Label    | Element Label               | Description                                                      |
| --------------- | --------------------------- | ---------------------------------------------------------------- |
| `PROTECTED`     | `PROTECTED.race_ethnicity`  | Race or ethnicity                                                |
| `PROTECTED`     | `PROTECTED.religion`        | Religious affiliation                                            |
| `PROTECTED`     | `PROTECTED.sex`             | Sex-related attribute when a more specific label is not returned |
| `PROTECTED.sex` | `PROTECTED.sex.pregnancy`   | Pregnancy status                                                 |
| `PROTECTED.sex` | `PROTECTED.sex.orientation` | Sexual orientation                                               |
| `PROTECTED.sex` | `PROTECTED.sex.gender`      | Gender or gender identity                                        |
| `PROTECTED`     | `PROTECTED.national_origin` | National origin                                                  |
| `PROTECTED`     | `PROTECTED.age`             | Age                                                              |
| `PROTECTED`     | `PROTECTED.disability`      | Disability status                                                |
| `PROTECTED`     | `PROTECTED.genetic_info`    | Genetic information                                              |

### Government Information

Government-issued identifiers. Country-specific passport variants are consolidated into `GOVERNMENT.passport`.

| Parent Label | Element Label                | Description                                                                                                |
| ------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `GOVERNMENT` | `GOVERNMENT.ssn`             | Social Security Number                                                                                     |
| `GOVERNMENT` | `GOVERNMENT.ein`             | Employer Identification Number or Taxpayer Identification Number                                           |
| `GOVERNMENT` | `GOVERNMENT.passport`        | Passport number                                                                                            |
| `GOVERNMENT` | `GOVERNMENT.drivers_license` | Driver's license number                                                                                    |
| `GOVERNMENT` | `GOVERNMENT.license_plate`   | License plate number                                                                                       |
| `GOVERNMENT` | `GOVERNMENT.national_id`     | National identity, social insurance, or personal tax number. See [Sub-Elements](#national-id-sub-elements) |
| `GOVERNMENT` | `GOVERNMENT.vin`             | Vehicle Identification Number                                                                              |

### Payments Information (PCI)

Payment card and banking identifiers.

| Parent Label | Element Label              | Description                 |
| ------------ | -------------------------- | --------------------------- |
| `FINANCIAL`  | `FINANCIAL.card_number`    | Credit card number          |
| `FINANCIAL`  | `FINANCIAL.card_expiry`    | Credit card expiration date |
| `FINANCIAL`  | `FINANCIAL.cvv`            | Credit card CVV             |
| `FINANCIAL`  | `FINANCIAL.routing_number` | Routing number              |
| `FINANCIAL`  | `FINANCIAL.iban`           | IBAN                        |
| `FINANCIAL`  | `FINANCIAL.swift`          | SWIFT code                  |
| `FINANCIAL`  | `FINANCIAL.bank_account`   | Bank account number         |

### Health Information (PHI)

Protected health information.

| Parent Label | Element Label          | Description                        |
| ------------ | ---------------------- | ---------------------------------- |
| `MEDICAL`    | `MEDICAL.diagnosis`    | Diagnosis                          |
| `MEDICAL`    | `MEDICAL.medication`   | Medication                         |
| `MEDICAL`    | `MEDICAL.procedure`    | Medical procedure                  |
| `MEDICAL`    | `MEDICAL.insurance_id` | Health insurance member identifier |
| `MEDICAL`    | `MEDICAL.mrn`          | Medical record number              |
| `MEDICAL`    | `MEDICAL.medical_code` | Medical code                       |
| `MEDICAL`    | `MEDICAL.provider_id`  | Medical provider identifier        |

### Secrets

Authentication credentials and cryptographic material.

| Parent Label | Element Label         | Description                                                                       |
| ------------ | --------------------- | --------------------------------------------------------------------------------- |
| `SECRETS`    | `SECRETS.password`    | Password. See [Sub-Elements](#secrets-sub-elements)                               |
| `SECRETS`    | `SECRETS.api_key`     | API key or service secret key. See [Sub-Elements](#secrets-sub-elements)          |
| `SECRETS`    | `SECRETS.private_key` | Private key or certificate-like secret. See [Sub-Elements](#secrets-sub-elements) |
| `SECRETS`    | `SECRETS.seed_phrase` | Seed phrase                                                                       |
| `SECRETS`    | `SECRETS.token`       | Authentication token. See [Sub-Elements](#secrets-sub-elements)                   |

### Technical Information

System and network identifiers.

| Parent Label | Element Label             | Description                                                                                                                |
| ------------ | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `TECHNICAL`  | `TECHNICAL.ip`            | IP address                                                                                                                 |
| `TECHNICAL`  | `TECHNICAL.mac`           | MAC address                                                                                                                |
| `TECHNICAL`  | `TECHNICAL.url`           | URL or website                                                                                                             |
| `TECHNICAL`  | `TECHNICAL.account_id`    | Account or device identifier. See [Sub-Elements](#technical-sub-elements)                                                  |
| `TECHNICAL`  | `TECHNICAL.hostname`      | Hostname                                                                                                                   |
| `TECHNICAL`  | `TECHNICAL.imei`          | IMEI or device serial-style identifier                                                                                     |
| `TECHNICAL`  | `TECHNICAL.telemetry_id`  | Telemetry identifier                                                                                                       |
| `TECHNICAL`  | `TECHNICAL.credential_id` | Non-secret identifier half of a credential pair, such as an AWS access key ID. See [Sub-Elements](#technical-sub-elements) |

### Location Information

Geographic and coordinate data.

| Parent Label | Element Label          | Description                                    |
| ------------ | ---------------------- | ---------------------------------------------- |
| `LOCATION`   | `LOCATION.country`     | Country                                        |
| `LOCATION`   | `LOCATION.state`       | State or province                              |
| `LOCATION`   | `LOCATION.city`        | City                                           |
| `LOCATION`   | `LOCATION.postal_code` | Postal code or ZIP code                        |
| `LOCATION`   | `LOCATION.coordinates` | Latitude, longitude, or geographic coordinates |

### Organization Information

Business and team entity identifiers.

| Parent Label   | Element Label            | Description                             |
| -------------- | ------------------------ | --------------------------------------- |
| `ORGANIZATION` | `ORGANIZATION.org_name`  | Organization, employer, or company name |
| `ORGANIZATION` | `ORGANIZATION.team_name` | Team name                               |

## Sub-Elements

Sub-elements are reported under their parent label. For example, a Polish PESEL is reported as `GOVERNMENT.national_id`, and a Stripe secret key is reported as `SECRETS.api_key`.

### National ID Sub-Elements

Reported as `GOVERNMENT.national_id`.

| Country       | Identifier                                       |
| ------------- | ------------------------------------------------ |
| Austria       | Social insurance number (SVNR)                   |
| Belgium       | National Number                                  |
| Bulgaria      | EGN                                              |
| Canada        | Social Insurance Number (SIN)                    |
| Croatia       | OIB                                              |
| Cyprus        | Tax Identification Code (TIC)                    |
| Czechia       | Rodné číslo                                      |
| Denmark       | CPR number                                       |
| Estonia       | Isikukood                                        |
| Finland       | Henkilötunnus (HETU)                             |
| France        | NIR (social security number)                     |
| Germany       | Tax ID (Steuer-ID), social insurance number      |
| Greece        | AMKA                                             |
| Hungary       | Személyi azonosító                               |
| Ireland       | PPS Number                                       |
| Italy         | Codice Fiscale                                   |
| Latvia        | Personas kods                                    |
| Lithuania     | Asmens kodas                                     |
| Luxembourg    | Matricule                                        |
| Malta         | ID card number                                   |
| Mexico        | CURP, NSS, RFC                                   |
| Netherlands   | BSN                                              |
| Poland        | PESEL                                            |
| Portugal      | NIF                                              |
| Romania       | CNP                                              |
| Slovakia      | Rodné číslo                                      |
| Slovenia      | EMŠO                                             |
| Spain         | DNI, NIE                                         |
| Sweden        | Personnummer                                     |
| United States | Individual Taxpayer Identification Number (ITIN) |

### Secrets Sub-Elements

| Reported as           | Sub-elements                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SECRETS.api_key`     | Airtable, Anthropic, AWS secret access key, Azure AD client secret, Azure storage account key, Datadog API and application keys, Figma, Firebase Cloud Messaging, GitHub, Google API key, Google OAuth client secret, Grafana, HubSpot private app token, Linear, Mailchimp, Mailgun, New Relic, OpenAI, PayPal client secret, SendGrid, Shopify, Square, Stripe, Supabase, Twilio auth token       |
| `SECRETS.token`       | Atlassian, AWS session token, Braintree access token, CircleCI, Cloudflare, Databricks, DigitalOcean, Discord bot token, Docker Hub, Dropbox, GitHub, GitLab, HashiCorp Vault, HTTP Basic credentials and `Authorization` headers, Hugging Face, JSON Web Token (JWT), Marqeta, Notion, npm, NuGet, Okta, PayPal REST access token, PyPI, RubyGems, Slack token, SonarQube, Stripe, Terraform Cloud |
| `SECRETS.private_key` | PEM private keys (including encrypted and Base64-wrapped), PGP, PuTTY, SSH2 (ssh.com), JSON Web Key (JWK), GCP service account key, NATS NKEY seed, PASERK, webhook signing secret                                                                                                                                                                                                                  |
| `SECRETS.password`    | Passwords in SQL statements, connection URIs, JDBC URLs, `curl -u` credentials, and PowerShell `ConvertTo-SecureString`; OTP seeds in `otpauth://` URIs                                                                                                                                                                                                                                             |

### Technical Sub-Elements

| Reported as               | Sub-elements                                                                                                                                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `TECHNICAL.account_id`    | AWS account ID, Azure tenant and subscription IDs, GCP project ID and project number, OpenStack project ID, Salesforce org and user IDs, Slack user, team, and channel IDs, Stripe account and customer IDs, Twilio Account SID |
| `TECHNICAL.credential_id` | AWS access key ID, Azure client ID, Twilio API key SID                                                                                                                                                                          |

## Optional Element Packs

Regional element packs are disabled by default. Contact your Technical Account Manager to enable one.

| Pack       | Elements                                                                                                                                                                                                           |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| UK GDPR    | UK National Insurance Number, UK Sort Code, UK Unique Taxpayer Reference, UK Driving Licence, UK NHS Number                                                                                                        |
| Indian PII | Aadhaar Number, Indian PAN, Indian Voter ID, Indian Pincode, Indian Driving License, Indian GSTIN, Indian Bank Account Number, IFSC Code, UPI ID, Indian Business Registration Number, Indian Income Tax Filing ID |

## V1 Mapping Reference

| V1 Label                                                                         | V2 Label                     | Change                  |
| -------------------------------------------------------------------------------- | ---------------------------- | ----------------------- |
| `email`                                                                          | `PERSONAL.email`             | Renamed                 |
| `phone_number`                                                                   | `PERSONAL.phone`             | Renamed                 |
| `first_name`                                                                     | `PERSONAL.name.given`        | Renamed                 |
| `last_name`                                                                      | `PERSONAL.name.family`       | Renamed                 |
| `name`                                                                           | `PERSONAL.name`              | Renamed                 |
| `birthday`, `birthday_year`, `birthday_month`, `birthday_day`                    | `PERSONAL.dob`               | Consolidated            |
| `street_address`                                                                 | `PERSONAL.address.street`    | Renamed                 |
| `us_address`                                                                     | `PERSONAL.address`           | Consolidated            |
| `us_ssn`                                                                         | `GOVERNMENT.ssn`             | Renamed                 |
| `passport` variants                                                              | `GOVERNMENT.passport`        | Consolidated            |
| `drivers_license`                                                                | `GOVERNMENT.drivers_license` | Exact match             |
| `ein`, `tin`                                                                     | `GOVERNMENT.ein`             | Consolidated            |
| `vin`                                                                            | `GOVERNMENT.vin`             | Exact match             |
| `license_plate`, `license_plate_number`                                          | `GOVERNMENT.license_plate`   | Renamed                 |
| `credit_card`                                                                    | `FINANCIAL.card_number`      | Renamed                 |
| `cc_expiration`                                                                  | `FINANCIAL.card_expiry`      | Renamed                 |
| `cvv`                                                                            | `FINANCIAL.cvv`              | Exact match             |
| `aba_routing`                                                                    | `FINANCIAL.routing_number`   | Renamed                 |
| `iban`                                                                           | `FINANCIAL.iban`             | Exact match             |
| `swift_code`                                                                     | `FINANCIAL.swift`            | Renamed                 |
| `us_bank`                                                                        | `FINANCIAL.bank_account`     | Renamed                 |
| `zipcode`                                                                        | `LOCATION.postal_code`       | Renamed                 |
| `country`                                                                        | `LOCATION.country`           | Exact match             |
| `state`                                                                          | `LOCATION.state`             | Exact match             |
| `city`                                                                           | `LOCATION.city`              | Exact match             |
| `latitude`, `longitude`, `geo_coordinates`, `location`                           | `LOCATION.coordinates`       | Consolidated            |
| `organization`, `employer`                                                       | `ORGANIZATION.org_name`      | Consolidated            |
| `website`                                                                        | `TECHNICAL.url`              | Renamed                 |
| `ip_address`, `ipv4`, `ipv6`                                                     | `TECHNICAL.ip`               | Consolidated            |
| `mac_address`                                                                    | `TECHNICAL.mac`              | Renamed                 |
| `device_id`, `account_id`                                                        | `TECHNICAL.account_id`       | Consolidated            |
| `password`                                                                       | `SECRETS.password`           | Exact match             |
| `api_key`, `aws_secret_access_key`, `gitapp_key`, `gcp_auth_cert_url`            | `SECRETS.api_key`            | Consolidated            |
| `aws_access_key_id`                                                              | `TECHNICAL.credential_id`    | Moved                   |
| `github_auth_token`, `gitlab_key`, `jira_token`, `stripe_token`, `marqeta_token` | `SECRETS.token`              | Consolidated            |
| `certificate`                                                                    | `SECRETS.private_key`        | Approximate             |
| `race`                                                                           | `PROTECTED.race_ethnicity`   | Renamed                 |
| `gender`                                                                         | `PROTECTED.sex.gender`       | Renamed and moved to L3 |
| `religion`                                                                       | `PROTECTED.religion`         | Exact match             |
| `age`                                                                            | `PROTECTED.age`              | Exact match             |
| `origin`                                                                         | `PROTECTED.national_origin`  | Renamed                 |
| `prescription_number`                                                            | `MEDICAL.mrn`                | Approximate             |

## Labels No Longer Detected

The following v1 labels do not have a v2 equivalent and are not returned by the classifier after migration:

| V1 Label                                                                               | Reason                                                               |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `height`, `weight`                                                                     | Not PII-relevant                                                     |
| `date`, `timestamp`, `calendar`, `appointment_date`                                    | Too generic; dates are contextual                                    |
| `death_date`                                                                           | Insufficient training signal                                         |
| `transaction`, `transaction_id`, `transaction_amount`, `transaction_date`              | Not PII-relevant                                                     |
| `transaction_vendor`                                                                   | Use `ORGANIZATION.org_name` instead                                  |
| `monetary_amount`, `currency`, `salary`, `account_balance`, `loan_number`, `bank_name` | Not PII-relevant                                                     |
| `cc_type`                                                                              | Not PII-relevant                                                     |
| `us_ssn_last_four`, `cc_last_four`                                                     | Partial SSNs and card numbers are not detected in v2 but are planned |
| `blood_type`, `diagnosis_date`, `admission_date`, `discharge_date`                     | Replaced by the expanded `MEDICAL` family                            |
| `marital_status`, `language`, `occupation`                                             | Not PII-relevant                                                     |
| `middle_name`, `initials`, `title`                                                     | Covered by `PERSONAL.name`                                           |
