GET/v1/phonelookup

Look up carrier, line type, and network metadata for a phone number

Returns validity, country, region/location and formatting details for a phone `number`, with optional `country`. On this listing the carrier, line type, VoIP, disposable-number and MCC/MNC fields are returned as an upgrade-notice string rather than data. For format and validity checks only use /validatephone.

API Ninjas·$0.001 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "api-ninjas",
  path: "/v1/phonelookup",
  query: {
    "number": "example"
  }
});

console.log(output);

Query parameters

numberrequired

string

Phone number to look up. The leading '+' is optional. If country is not set, include the country code (e.g. 12065550100 or +12065550100).

country

string

2-letter ISO-3166 country code the phone number belongs to.