---
title: "Validate a phone number"
method: POST
path: "/numbervalidator"
---

# Validate a phone number

`POST /numbervalidator`

Performs a number validation request. This is a paid service. For pricing check [here](https://www.routee.net/pricing/number-validation/)

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `getPorted` boolean — Indicates if the number validator result will concern the number's ported network (only if the number is ported). Pricing differs if you select this option. Visit [here](https://dev.routee.net/#/management/financial/pricing) for pricing information. Default value: false
  - `to` string, required — The number that the number validator service will use. Format with a '+' and country code (E.164 format).
  - `host` string — The host name or the IP address. This field is used in order to get information about the country of an IP or a domain name.

## Response `200`

200

- object
  - `to` string
  - `createdAt` string
  - `getPorted` boolean
  - `numberValidatorId` string
  - `details` object
    - `type` string
    - `ported` boolean
    - `network` string
    - `networkCode` string
    - `countryCode` string
    - `countryPrefix` string
  - `formats` object
    - `international` string
    - `national` string
    - `rfc3966` string
  - `geo` object
    - `host` string
    - `country` string
    - `countryISO2Code` string
    - `countryISO3Code` string
    - `continent` string
  - `applicationName` string
  - `valid` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)