# Validate and format a phone number

Tomba

Phone number → validity, local/international/E.164/RFC3966 formats, country, line type, carrier, region and timezones

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Validate and format a phone number (tool ID: tomba.people-phone-verify). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Verify phone numbers](https://scrollport.com/tools/phone-validation-api)

**Current price:** $0.0125/request

**Availability:** Ready to run

## Tool details

**About this tool**

Phone number → validity, local/international/E.164/RFC3966 formats, country, line type, carrier, region and timezones Retrieve one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

**Inputs and outputs**

### Input

`country_code` string · optional

ISO-2 country to interpret a national-format number against, e.g. US

minLength: 1 · maxLength: 500

`phone` string · required

the number to validate; URL-encode a leading + as %2B

minLength: 1 · maxLength: 500

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "tomba.people-phone-verify",
  "input": {
    "phone": "+14155550100"
  }
}
```

### Output

```
{
  "data": {
    "valid": true,
    "region": {
      "code": "CA",
      "name": "California"
    },
    "timezones": [
      "America/Los_Angeles"
    ],
    "country_code": "US"
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"phone":"+14155550100"}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/tomba/people-phone-verify
