Phone number prebuilt entity for a LUIS app

Important

LUIS will be retired on October 1st 2025 and starting April 1st 2023 you will not be able to create new LUIS resources. We recommend migrating your LUIS applications to conversational language understanding to benefit from continued product support and multilingual capabilities.

The phonenumber entity extracts a variety of phone numbers including country code. Because this entity is already trained, you do not need to add example utterances to the application. The phonenumber entity is supported in en-us culture only.

Types of a phone number

Phonenumber is managed from the Recognizers-text GitHub repository

Resolution for this prebuilt entity

The following entity objects are returned for the query:

my mobile is 1 (800) 642-7676

V3 response

The following JSON is with the verbose parameter set to false:

"entities": {
    "phonenumber": [
        "1 (800) 642-7676"
    ]
}

V3 verbose response

The following JSON is with the verbose parameter set to true:

"entities": {
    "phonenumber": [
        "1 (800) 642-7676"
    ],
    "$instance": {

        "phonenumber": [
            {
                "type": "builtin.phonenumber",
                "text": "1 (800) 642-7676",
                "startIndex": 13,
                "length": 16,
                "score": 1.0,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

V2 response

The following example shows the resolution of the builtin.phonenumber entity.

"entities": [
    {
        "entity": "1 (800) 642-7676",
        "type": "builtin.phonenumber",
        "startIndex": 13,
        "endIndex": 28,
        "resolution": {
            "score": "1",
            "value": "1 (800) 642-7676"
        }
    }
]

Next steps

Learn about the percentage, number, and temperature entities.