Skip to main content
The get_phone_type tool returns whether a phone number is registered as residential or business. This is useful for B2B campaigns or compliance scenarios where different rules apply.

​
When to Use

  • B2B campaigns that should only target business numbers
  • Compliance scenarios where residential vs business distinction matters
  • Lead qualification and routing decisions

​
Parameters

​
phone
string
required
10-digit North American phone number to check (e.g., "5039367187").
​
loginId
string
API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

​
Response

​
success
boolean
Whether the API call succeeded.
​
phone
string
The phone number checked.
​
type
string
  • R - Residential
  • B - Business
  • U - Unknown
​
typeDescription
string
Human-readable description of the type.
​
isResidential
boolean
true if the number is residential.
​
isBusiness
boolean
true if the number is a business line.
​
errorCode
string
Machine-readable error code (when failed).
​
errorMessage
string
Human-readable error description (when failed).

​
Examples

{
  "phone": "5039367187"
}

​
Usage Notes

  • Some numbers may return U (Unknown) if classification data is not available
  • Business numbers may have different DNC exemptions depending on your campaign type
  • Consider combining with scrub_phone_numbers for complete compliance checking