Data247

Learn how to use Data247 with Composio

Overview

SLUG: DATA247

Description

A Data Management Platform for all of your data needs.

Authentication Details

generic_api_key
stringRequired

Connecting to Data247

Create an auth config

Use the dashboard to create an auth config for the Data247 toolkit. This allows you to connect multiple Data247 accounts to Composio for agents to use.

1

Select App

Navigate to Data247.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Data247 Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4data247_auth_config_id = "ac_YOUR_DATA247_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Data247 for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, data247_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Data247 toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Append Email by Name and Address

Description

Tool to find email addresses associated with name and postal address. Use when you need to discover the email address for a contact given their name and residential or business address.

Action Parameters

address
stringRequired
city
stringRequired
fname
stringRequired
lname
stringRequired
state
stringRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Gender by First Name

Description

Tool to determine a person's probable gender based on their first (given) name. Use when you need to infer gender from a first name with confidence percentage.

Action Parameters

fname
stringRequired
out
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Name (CNAM Lookup)

Description

Tool to get CNAM (Caller Name Delivery) data for a phone number. Use when you need to find the registered owner name associated with a phone number from carrier-grade telco data.

Action Parameters

out
string
phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Phone to Contact

Description

Tool to append phone numbers to contact records using name and address. Use when you need to find phone numbers (business or residential) associated with a person's name and address. Returns primary phone with type classification and additional phone numbers if available.

Action Parameters

address
stringRequired
city
stringRequired
firstname
stringRequired
lastname
stringRequired
state
stringRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Property Data

Description

Tool to retrieve comprehensive property data including home stats, ownership information, financials and foreclosure data. Use when you need detailed property information for any US address.

Action Parameters

address
stringRequired
city
stringRequired
out
string
state
stringRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Reverse Email Lookup

Description

Tool to perform reverse email lookup and retrieve contact information. Use when you need to find the name, phone, and address associated with an email address. Returns personal identifiers, contact details, and address components.

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Reverse Phone Lookup

Description

Tool to perform reverse phone lookup and retrieve name and address information. Use when you need to find the contact details associated with a phone number. Returns personal identifiers, address components, and demographic data.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append Reverse Zipcode Lookup

Description

Tool to get formatted address components from a zipcode. Use when you need to retrieve city, state, county, congressional district, timezone, and other location data for a given 5 or 9 digit zipcode.

Action Parameters

plus4
string
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Append ZIP+4 to Address

Description

Tool to append ZIP+4 postal codes to addresses and standardize address information. Use when you need to obtain complete 9-digit zipcodes for accurate mail delivery or address validation.

Action Parameters

address
stringRequired
city
stringRequired
firstname
string
lastname
string
state
stringRequired
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Check Account Balance

Description

Tool to check Data247 account balance and remaining credits. Use when you need to verify available credits before making API requests.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Carrier Type for Phone Number

Description

Tool to determine carrier type for USA and Canadian phone numbers. Use when you need to identify if a phone number is a Mobile, Landline, or VOIP line. Returns the carrier type classification for the queried phone number.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get USA Carrier and SMS/MMS Gateway Info

Description

Tool to get carrier information, wireless status, and SMS/MMS gateway addresses for USA phone numbers. Use when you need to obtain carrier name, determine if a number is wireless, or retrieve email-to-SMS and email-to-MMS gateway addresses for sending messages to a phone number.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Check Phone Number for Fraud/SPAM

Description

Tool to check if a phone number is on SPAM callers list. Use when you need to verify if a phone number has been reported as spam or fraud. Returns spam risk level (Low, Medium, or High) and reason for the classification.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add Phone to Do-Not-Call List

Description

Tool to add phone numbers to your internal do-not-call (DNC) list. Use when you need to mark phone numbers that should not be contacted. Returns confirmation with action status 'ADDED' for successfully added numbers.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Check Phone Number Against DNC Lists

Description

Tool to check if a phone number exists in Federal or internal Do-Not-Call list. Use when you need to verify if a phone number is safe to dial or if it's on a DNC list. Returns status indicating whether phone is OK-TO-DIAL, FEDERAL DNC, INTERNAL DNC, or UNAUTHORIZED.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove Phone from Do-Not-Call List

Description

Tool to remove phone numbers from your internal do-not-call (DNC) list. Use when you need to unmark phone numbers that were previously marked as do-not-call. Returns confirmation with action status 'REMOVED' for successfully removed numbers.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Locate IP Address - Get Geolocation Data

Description

Tool to get geolocation data for IPv4 addresses including city, state, country, and coordinates. Use when you need to determine the geographic location of an IP address worldwide.

Action Parameters

ip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Carrier and Gateway Info (Text@ Service)

Description

Tool to get carrier information, wireless status, and email-to-SMS/MMS gateway addresses for USA and Canadian phone numbers using the Text@ service. Use when you need to obtain carrier name, determine if a number is wireless, or retrieve email gateway addresses for sending SMS/MMS messages to a phone number.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Verify User Identity Trust Score

Description

Tool to verify user signup legitimacy and detect account creation fraud. Use when you need to check if a new user signup is from a legitimate user or a fraud attempt. Returns a trust score (1-100) and match statistics from cross-referencing user data with Data247's resources. Higher scores indicate legitimate signups; lower scores suggest potential fraud. Providing more user data parameters enables better fraud detection accuracy.

Action Parameters

address
string
city
string
email
string
firstname
string
ip
string
lastname
string
phone
string
state
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Verify Email Address

Description

Tool to verify email address format and mailbox existence. Use when you need to validate that an email address is properly formatted and has a working mailbox. Also identifies free accounts and disposable email addresses.

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Verify Phone Number Active Status

Description

Tool to verify if a phone number is in-service and accepts inbound calls. Use when you need to validate phone number active status with confidence level. Returns whether the phone is active (YES/NO) and verification confidence (HIGH/LOW). Available in 100+ countries excluding USA/Canada.

Action Parameters

phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Verify USA Postal Address

Description

Tool to verify and correct USA postal addresses to USPS standards. Use when you need to validate an address and get corrected components including street, city, state, ZIP, and detailed location data. Returns whether the address is valid and provides USPS-standardized address components.

Action Parameters

address
stringRequired
city
string
state
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired