Skip to main content
GET
Returns what is known about a phone number: whether it is valid, the carrier and line type, the country, linked online accounts and a risk score.

Parameters

string
required
The phone number in international format, e.g. +4915112345678. Spaces and dashes are allowed.

Headers

string
required
Your API key.

Usage

Counts as one lookup against your plan’s daily allowance (Max: unlimited). When the allowance is used up, the lookup can continue at a per-lookup price charged to your balance (the module’s page in the dashboard shows the price). The price applies even when the lookup finds nothing; a lookup that fails because of an error on our side is not charged.

Example request

SDK example

The same request with the official SDKs. Each one reads your key from OSINTCAT_API_KEY.

Response

string
Always phone.
string
The number in E.164 format.
boolean
Whether anything was found.
object
Risk assessment.
array
The main facts as {label, value} pairs.
array
Detailed findings, grouped (carrier, location, linked accounts …).
object
The full answer the summary is built from.
object
Your usage after this request (plan, lookups_left).

Errors

See Errors for the responses every endpoint can return.