# Data247

Data247 is a simple, and secure on-demand data platform that provides businesses with a wide-range of data lookup services.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `DATA247`
- **Version:** 20260312_00

## Tools

### Append Email by Name and Address (v2)

**Slug:** `DATA247_APPEND_EMAIL2`

Tool to find email addresses associated with name and postal address using Append247 service. Use when you need to discover the email address for a contact given their name and address details (all fields are optional).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | ZIP code |
| `city` | string | No | City name |
| `fname` | string | No | First name of the person to lookup |
| `lname` | string | No | Last name of the person to lookup |
| `state` | string | No | State code (2-letter abbreviation) |
| `address` | string | No | Street address of the person |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Gender by First Name

**Slug:** `DATA247_APPEND_GENDER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `out` | string | No | Output format - 'json' (default), 'xml', or 'csv'. If not specified, defaults to JSON. |
| `fname` | string | Yes | The first name (given name) to check for probable gender |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Name (CNAM Lookup)

**Slug:** `DATA247_APPEND_NAME`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `out` | string | No | Output format - 'json' (default), 'xml', or 'csv'. If not specified, defaults to JSON. |
| `phone` | string | Yes | The phone number to lookup. Should be a valid US phone number with digits only (e.g., 6178924356). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Phone to Contact

**Slug:** `DATA247_APPEND_PHONE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | Yes | ZIP code. |
| `city` | string | Yes | City name. |
| `state` | string | Yes | State abbreviation (e.g., NY, CA, TX). |
| `address` | string | Yes | Street address of the person. |
| `lastname` | string | Yes | Last name of the person to lookup. |
| `firstname` | string | Yes | First name of the person to lookup. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Profile Data

**Slug:** `DATA247_APPEND_PROFILE`

Tool to retrieve comprehensive consumer profile data including identity, contact information, demographics, property, and vehicle details. Use when you need detailed profile enrichment for a person based on their name and address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | ZIP code. |
| `city` | string | No | City name. |
| `state` | string | No | State abbreviation (e.g., NY, CA, TX). |
| `address` | string | No | Street address of the person. |
| `lastname` | string | No | Last name of the person to lookup. |
| `firstname` | string | No | First name of the person to lookup. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Property Data

**Slug:** `DATA247_APPEND_PROPERTY_DATA`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `out` | string | No | Output format - 'json' (default), 'xml', or 'csv'. If not specified, defaults to JSON. |
| `zip` | string | Yes | ZIP code of the property. |
| `city` | string | Yes | City name where the property is located. |
| `state` | string | Yes | Two-letter state code (e.g., 'CA', 'NY'). |
| `address` | string | Yes | Street address of the property (e.g., '1600 Amphitheatre Parkway'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Reverse Email Lookup

**Slug:** `DATA247_APPEND_REVERSE_EMAIL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to lookup. Must be a valid email format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Reverse Phone Lookup

**Slug:** `DATA247_APPEND_REVERSE_PHONE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | The phone number to lookup. Provide digits only without formatting (e.g., 5551234567). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Reverse Zipcode Lookup

**Slug:** `DATA247_APPEND_REVERSE_ZIPCODE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | Yes | 5 or 9 digit zipcode to lookup. Must be a valid US zipcode. |
| `plus4` | string | No | ZIP+4 code for more precise location (4-digit extension). Optional parameter for enhanced precision. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Append Zipcode by City/State

**Slug:** `DATA247_APPEND_ZIPCODE2`

Tool to lookup zipcode for an address based on city and state. Use when you need to obtain zipcodes for a location specified by city and state, with optional street address for more precise results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | Existing zip code if available (optional) |
| `city` | string | No | City name to lookup zipcode for |
| `state` | string | No | Two-letter state code |
| `address` | string | No | Street address (optional for more precise results) |
| `lastname` | string | No | Last name of contact (optional) |
| `firstname` | string | No | First name of contact (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Account Balance

**Slug:** `DATA247_BALANCE_INQUIRY`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Carrier Type for Phone Number

**Slug:** `DATA247_CARRIER_TYPE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | USA or Canadian phone number to lookup. Provide digits only without formatting (e.g., 2025551234). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Phone to Do-Not-Call List

**Slug:** `DATA247_DNC_ADD`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number to add to the do-not-call list. Provide digits only without formatting (e.g., 5551234567). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Phone Number Against DNC Lists

**Slug:** `DATA247_DNC_CHECK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number to check against DNC lists. Provide digits only without formatting (e.g., 5555555555). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Phone from Do-Not-Call List

**Slug:** `DATA247_DNC_REMOVE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number to remove from the do-not-call list. Provide digits only without formatting (e.g., 5551234567). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Locate IP Address - Get Geolocation Data

**Slug:** `DATA247_LOCATE_IP_ADDRESS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 address to geolocate. Must be a valid IPv4 address format (e.g., '8.8.8.8', '123.456.789.10'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Look Up Carrier Information for USA/Canada

**Slug:** `DATA247_LOOKUP_CARRIER_USA`

Tool to look up carrier information for USA and Canadian phone numbers including carrier name, SMS/MMS gateway addresses, and wireless status. Use when you need to determine if a phone is wireless, get carrier details, or retrieve email-to-SMS/MMS gateway addresses with number portability awareness.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | USA or Canadian phone number to lookup carrier information. Provide digits only without formatting (e.g., 2125551234). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup International Carrier Information

**Slug:** `DATA247_LOOKUP_INTERNATIONAL_CARRIER`

Tool to get carrier information for international phone numbers worldwide. Use when you need to obtain carrier name, wireless status, country, and ISO country code for international numbers. Note: SMS/MMS gateway addresses are not available for international carriers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | International phone number to lookup carrier information. Provide the full international number with country code (e.g., +442071234567 or 442071234567). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Carrier and Gateway Info (Text@ Service)

**Slug:** `DATA247_TEXT_AT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | USA or Canadian phone number to lookup carrier and SMS/MMS gateway information. Provide digits only without formatting (e.g., 2125551234). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trust Phone Number (Check SPAM Risk)

**Slug:** `DATA247_TRUST_PHONE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | The phone number to check for spam risk. Provide digits only without formatting (e.g., 5551234567). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify User Identity Trust Score

**Slug:** `DATA247_TRUST_USER_IDENTITY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IP address of the user during signup. |
| `zip` | string | No | ZIP or postal code provided by the user. |
| `city` | string | No | City name provided by the user. |
| `email` | string | No | Email address provided by the user during signup. |
| `phone` | string | No | Phone number provided by the user. Provide digits only without formatting. |
| `state` | string | No | Two-letter state code for USA addresses. |
| `address` | string | No | Street address provided by the user. |
| `lastname` | string | No | Last name of the user signing up. |
| `firstname` | string | No | First name of the user signing up. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Email Address

**Slug:** `DATA247_VERIFY_EMAIL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify for proper formatting and working mailbox. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Phone Number Active Status

**Slug:** `DATA247_VERIFY_PHONE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | The phone number to verify. Provide digits only without formatting (e.g., 33109758351). Available in 100+ countries excluding USA/Canada. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify USA Postal Address

**Slug:** `DATA247_VERIFY_POSTAL_ADDRESS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | ZIP code (5-digit or ZIP+4). Optional but improves verification accuracy when provided. |
| `city` | string | No | City name. Optional but improves verification accuracy when provided. |
| `state` | string | No | Two-letter state code. Optional but improves verification accuracy when provided. |
| `address` | string | Yes | Street address to verify (e.g., '1600 Pennsylvania Avenue NW') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |