---
id: "phone"
kind: "datatype"
status: "stable"
is_pii: true
categories: ["pii", "common", "telecom"]
langs: ["common"]
quality: 80
url: "http://registry.apicrafter.io/datatype/phone"
---

# Phone number (`phone`)

Telephone number in standard format (RFC3966), without 'tel:' prefix

- Personal data (PII): yes
- Categories: Personally identifiable information (pii), Common (common), Telecommunications (telecom)
- Countries: global
- Languages: Common to most languages (common)
- Patterns: `nanpphone`, `phone_e164`, `tel_uri`

## Detection

Regular expression (Python `re`):

```
(?=.*\d)(?:(?:(?:\+|00|011)[\.\/\-\ \t]*([17]|2(?:[07]|[1-689]\d)|3(?:[0-4679]|[578]\d)|4(?:[013-9]|2\d)|5(?:[1-8]|[09]\d)|6(?:[0-6]|[789]\d)|8(?:[1246]|[035789]\d)|9(?:[0-58]|[679]\d))[\.\/\-\ \t]*|([17])[\.\/\-\ ])?(?:\((\d{1,6})\)[\.\/\-\ \t]*)?(?:(\d{1,6})[\.\/\-\ ])?(?:(\d{1,6})[\.\/\-\ ])?(?:(\d{1,6})[\.\/\-\ ])?(?:(\d{1,6})[\.\/\-\ ])?(\d{0,10}?)(\d{1,4})(?:[\.\/\-;\ \t]*e?xt?[\.\/\-=\ \t]*(\d{1,14}))?)?
```

## Examples

- `+1-202-456-1414` — White House
- `+1-514-954-8219` — International Civil Aviation Organization

## Mappings

- autotype: `phone-3`
- cdm: `means.identity.service.phone`
- dpv: `pd:TelephoneNumber`
- fibo: <https://spec.edmcouncil.org/fibo/ontology/FND/Places/VirtualPlaces/TelephoneNumber>
- fta: `TELEPHONE`
- google_dlp: `PHONE_NUMBER`
- presidio: `PHONE_NUMBER`
- schema_org: `telephone`
- wikidata: `P1329`

## Metacrafter rules

23 rules: 22 match the field name, 1 match values.

- `arphoneknown` (field, `ar_country/ar_common.yaml`)
- `faxknownpat` (field, `common/common.yaml`)
- `phoneknown` (field, `common/common.yaml`)
- `phoneknownpat` (field, `common/common.yaml`)
- `phoneknownprefix` (field, `common/common.yaml`)
- `esphoneknown` (field, `es/es_common.yaml`)
- `phonebyvalue` (data, `ext/ext_common.yaml`)
- `frphoneknown` (field, `fr/fr_common.yaml`)
- `hiphoneknown` (field, `hi/hi_common.yaml`)
- `jpphoneknown` (field, `jp/jp_common.yaml`)
- `kophoneknown` (field, `ko/ko_common.yaml`)
- `krphoneknown` (field, `kr/kr_common.yaml`)
- `auphoneknown` (field, `pii/au/au_pii.yaml`)
- `brphoneknown` (field, `pii/br/br_pii.yaml`)
- `cnphoneknown` (field, `pii/cn/cn_pii.yaml`)
- `inphoneknown` (field, `pii/in/in_pii.yaml`)
- `jp_pii_jpphoneknown` (field, `pii/jp/jp_pii.yaml`)
- `mxphoneknown` (field, `pii/mx/mx_pii.yaml`)
- `nlphoneknown` (field, `pii/nl/nl_pii.yaml`)
- `ptphoneknown` (field, `pii/pt/pt_pii.yaml`)

## Supported by tools

- `amazonmacie`
- `autotype`
- `awscomprehend`
- `awsglue`
- `azureailanguage`
- `collibra`
- `csvdetective`
- `databricks`
- `datahub`
- `dataprep`
- `dataprofiler`
- `fta`
- `googledlp`
- `greatexpectations`
- `ibmguardium`
- `metacrafter`
- `metadata-guardian`
- `nightfall`
- `openmetadata`
- `oracledatasafe`
- `presidio`
- `scrubadub`
- `snowflake`
- `soda`
- `sqldatacatalog`
- `talend`
- `woodwork`

## Sources

- wikidata: <https://www.wikidata.org/wiki/Property:P1329>
- schema.org: <https://schema.org/telephone>
- schema.org: <https://schema.org/faxNumber>
- wikipedia: <https://en.wikipedia.org/wiki/Telephone_number>

## Quality

Score 80/100. Missing: anchored regexp, negative example, translation.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/phone.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/common/phone.yaml>