Phone Lookup

Validate and retrieve detailed information about phone numbers including carrier data, number type (mobile, landline, VoIP), country code, and formatting validation, supporting international phone numbers across multiple regions.

Lookup a phone number

Lookup a phone number using multiple APIs. The first successful response will be returned.

GET

/ phone-lookup

Parameters

Name	Type	Description	Required
phone	string		Optional

Response

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean",
      "description": "Whether the phone number is valid",
      "example": true
    },
    "countryPrefix": {
      "type": "string",
      "description": "The country prefix of the phone number",
      "example": "+45"
    },
    "countryCode": {
      "type": "string",
      "description": "The country code of the phone number",
      "example": "DK"
    },
    "countryName": {
      "type": "string",
      "description": "The country name of the phone number",
      "example": "Denmark"
    },
    "location": {
      "type": "string",
      "description": "The location of the phone number",
      "example": "DK, Denmark"
    },
    "carrier": {
      "type": "string",
      "description": "The carrier of the phone number",
      "example": "Telenor"
    },
    "lineType": {
      "type": "string",
      "description": "The type of line of the phone number",
      "example": "mobile"
    }
  }
}

curl --request GET \
  --url "https://www.apikiss.com/api/v1/phone-lookup?phone=1234567890" \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.apikiss.com/api/v1/phone-lookup"
querystring = {"phone":"1234567890"}

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

const url = "https://www.apikiss.com/api/v1/phone-lookup?phone=1234567890";
const options = {
  method: "GET",
  headers: {
    Authorization: "Bearer <token>"
  },
  
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.apikiss.com/api/v1/phone-lookup?phone=1234567890",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
  
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error: " . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
  
)

func main() {
	url := "https://www.apikiss.com/api/v1/phone-lookup?phone=1234567890"
  payload := nil
	req, _ := http.NewRequest("GET", url, payload)
	req.Header.Add("Authorization", "Bearer <token>")
  

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://www.apikiss.com/api/v1/phone-lookup?phone=1234567890"))
                .header("Authorization", "Bearer <token>")
                
                .method("GET", HttpRequest.BodyPublishers.noBody())
                .build();
        
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean",
      "description": "Whether the phone number is valid",
      "example": true
    },
    "countryPrefix": {
      "type": "string",
      "description": "The country prefix of the phone number",
      "example": "+45"
    },
    "countryCode": {
      "type": "string",
      "description": "The country code of the phone number",
      "example": "DK"
    },
    "countryName": {
      "type": "string",
      "description": "The country name of the phone number",
      "example": "Denmark"
    },
    "location": {
      "type": "string",
      "description": "The location of the phone number",
      "example": "DK, Denmark"
    },
    "carrier": {
      "type": "string",
      "description": "The carrier of the phone number",
      "example": "Telenor"
    },
    "lineType": {
      "type": "string",
      "description": "The type of line of the phone number",
      "example": "mobile"
    }
  }
}

{
  "error": "Bad Request",
  "message": "Invalid parameters"
}

Authorizations

Authorization

header

required

Authentication token in the format "Bearer <token>"

Path Parameters

phone

string

Response

200 - application/json

valid

boolean

Whether the phone number is valid

Example: true

countryPrefix

string

The country prefix of the phone number

Example: +45

countryCode

string

The country code of the phone number

Example: DK

countryName

string

The country name of the phone number

Example: Denmark

location

string

The location of the phone number

Example: DK, Denmark

carrier

string

The carrier of the phone number

Example: Telenor

lineType

string

The type of line of the phone number

Example: mobile

Try it out

Response

Click "Send Request" to see the response...