Skip to main content
POST
/
api
/
agent
/
phone
Phone Lookup
curl --request POST \
  --url https://encrata.com/api/agent/phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>"
}
'
{
  "query": "<string>",
  "phone": "<string>",
  "valid": true,
  "format": {
    "international": "<string>",
    "local": "<string>"
  },
  "country": {
    "code": "<string>",
    "name": "<string>",
    "prefix": "<string>",
    "region": "<string>",
    "city": "<string>",
    "timezone": "<string>"
  },
  "type": "<string>",
  "carrier": {
    "name": "<string>",
    "line_type": "<string>"
  },
  "messaging": {
    "sms_domain": "<string>",
    "sms_email": "<string>"
  },
  "validation": {
    "is_valid": true,
    "line_status": "<string>",
    "is_voip": true,
    "minimum_age": 123
  },
  "registration": {
    "name": "<string>",
    "type": "<string>"
  },
  "risk": {
    "risk_level": "<string>",
    "is_disposable": true,
    "is_abuse_detected": true
  },
  "breaches": {
    "total_breaches": 123,
    "date_first_breached": "<string>",
    "date_last_breached": "<string>"
  },
  "credits": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires an API key in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Request

​
query
string
required
The phone number to look up. Include the country code (e.g. +14155552671).

​
Example request

curl -X POST "https://encrata.com/api/agent/phone" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "+14155552671"}'

​
Response

​
query
string
The original query submitted.
​
phone
string
The normalized phone number.
​
valid
boolean
Whether the phone number is valid.
​
format
object
Phone number formats.
​
country
object
Country and location details.
​
type
string
Line type: mobile, landline, voip, toll_free, etc.
​
carrier
object
Carrier information.
​
messaging
object
SMS gateway information.
​
validation
object
Validation and activity signals.
​
registration
object
Registration information.
​
risk
object
Risk assessment.
​
breaches
object
Breach exposure data.
​
credits
integer
Credits consumed (always 1).

​
Example response

200 OK
{
  "query": "+14155552671",
  "phone": "+14155552671",
  "valid": true,
  "format": {
    "international": "+1 415-555-2671",
    "local": "(415) 555-2671"
  },
  "country": {
    "code": "US",
    "name": "United States",
    "prefix": "+1",
    "region": "California",
    "city": "San Francisco",
    "timezone": "America/Los_Angeles"
  },
  "location": "San Francisco, California, US",
  "type": "mobile",
  "carrier": {
    "name": "T-Mobile",
    "line_type": "mobile"
  },
  "messaging": {
    "sms_domain": "tmomail.net",
    "sms_email": "4155552671@tmomail.net"
  },
  "validation": {
    "is_valid": true,
    "line_status": "active",
    "is_voip": false,
    "minimum_age": 3
  },
  "registration": {
    "name": "John Doe",
    "type": "personal"
  },
  "risk": {
    "risk_level": "low",
    "is_disposable": false,
    "is_abuse_detected": false
  },
  "breaches": {
    "total_breaches": 2,
    "date_first_breached": "2021-03-15",
    "date_last_breached": "2024-08-22"
  },
  "credits": 1
}

​
Notes

  • This endpoint costs 1 credit per lookup.
  • Include the country code for best results (e.g. +1 for US, +44 for UK).
  • All sections (messaging, validation, registration, risk, breaches) are returned when available from the upstream provider.