View as Markdown
Defastra icon

Defastra ACTION

Deep Phone Check

Conducts a risk assessment and digital lookup for a provided phone number. Returns a risk score indicating if the number is disposable, risky, or safe, along with carrier details, location, and potential social profiles. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Defastra account once, then configure and run Deep Phone Check from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "defastra-deep-phone-check",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    defastra: { authProvisionId: "apn_xxxxxxx" },
    timeout: "Timeout",
    label: "Label",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Deep Phone Check inputs
Property Type Description
timeout Timeout string
The timeout parameters allows you to control the response time of the check, allowing you to choose between more detailed results and faster response times. Please read this guide.
Optional
label Label string
A label is any string of text (max. 100 char) that can be attributed to any lookup. They are useful for organizing your data and can be used to search for data in the Observer, or visualize them on the dashboard.
Optional
phoneNumber Phone Number string
The phone number to conduct the risk assessment and digital lookup for, in international format.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
defastra-deep-phone-check
Version
0.0.2
App
Defastra
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes