---
title: "Phone Validate"
method: GET
path: "/phone-validate"
tags: ["Data Tools"]
---

# Phone Validate

`GET /phone-validate`

Parse, validate and get location information about a phone number

## Query parameters

- `number` string, required
- `country-code` string
- `ip` string

## Response `200`

OK

- PhoneValidateResponse — Structure of phone-validate
  - `valid` boolean, required — Is this a valid phone number
  - `international-calling-code` string, required — The international calling code
  - `country-code` string, required — The phone number country as an ISO 2-letter country code
  - `location` string, required — The phone number location. Could be the city, region or country depending on the type of number
  - `is-mobile` boolean, required — True if this is a mobile number. If the number type is unknown this value will be false
  - `type` string, required — The number type based on the number prefix. <br> Possible values are: <br> <ul> <li>mobile</li> <li>fixed-line</li> <li>premium-rate</li> <li>toll-free</li> <li>voip</li> <li>unknown (use HLR lookup)</li> </ul>
  - `international-number` string, required — The number represented in full international format (E.164)
  - `local-number` string, required — The number represented in local dialing format
  - `country` string, required — The phone number country
  - `country-code3` string, required — The phone number country as an ISO 3-letter country code
  - `currency-code` string, required — ISO 4217 currency code associated with the country
  - `prefix-network` string, required — The network/carrier who owns the prefix (this only works for some countries, use HLR lookup for global network detection)

## Other responses

- `400` — Your API request has been rejected. Check error code for details
- `403` — You have failed to authenticate
- `500` — We messed up, sorry! Your request has caused a fatal exception
- `default` — We messed up, sorry! Your request has caused an error

---

[API](https://skmtc.net/neutrinoapi/apis/neutrino-api.md) · [All operations](https://skmtc.net/neutrinoapi/apis/neutrino-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neutrinoapi/neutrino-api/versions/4ebd6b56de42/schema)