# Phone Number Formatting

**Use case:** 

Turn a phone number into easy-to-read national, international, and E.164 formats.

## Input

```json
{
  "phoneNumbers": [
    "020 7946 0958"
  ],
  "defaultCountry": "GB",
  "text": "Call us at +1 202-555-0123.",
  "includeInvalid": true
}
```

## Output

```json
{
  "phoneNumber": {
    "label": "Phone number",
    "format": "string"
  },
  "e164": {
    "label": "E.164 format",
    "format": "string"
  },
  "countryCode": {
    "label": "Country code",
    "format": "string"
  },
  "callingCode": {
    "label": "Calling code",
    "format": "string"
  },
  "type": {
    "label": "Number type",
    "format": "string"
  },
  "carrier": {
    "label": "Carrier",
    "format": "string"
  },
  "location": {
    "label": "Location",
    "format": "string"
  },
  "timeZones": {
    "label": "Time zones",
    "format": "array"
  },
  "internationalFormat": {
    "label": "International format",
    "format": "string"
  },
  "nationalFormat": {
    "label": "National format",
    "format": "string"
  },
  "extension": {
    "label": "Extension",
    "format": "string"
  },
  "source": {
    "label": "Source",
    "format": "string"
  },
  "isValid": {
    "label": "Valid",
    "format": "boolean"
  },
  "isPossible": {
    "label": "Possible",
    "format": "boolean"
  }
}
```

## About this Actor

This example demonstrates how to use [Phone Number Validation API](https://apify.com/maximedupre/phone-number-validation) with a specific input configuration. Visit the [Actor detail page](https://apify.com/maximedupre/phone-number-validation) to learn more, explore other use cases, and run it yourself.