# Realphonevalidation

RealPhoneValidation offers real-time phone number validation services, providing information on connectivity, phone type, carrier, and more.

- **Category:** phone & sms
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `REALPHONEVALIDATION`
- **Version:** 20260312_00

## Tools

### Check Phone Fraud Risk

**Slug:** `REALPHONEVALIDATION_CHECK_FRAUD`

Tool to check phone number for fraud risk using Fraud Check API. Provides a phone risk score and many actionable data points including phone type, carrier, location, and recommendation (block, flag, allow). Use when you need to identify possible fraudulent phone numbers. US numbers only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to 'json'. XML output is not supported by this tool. |

#### 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 |

### Email Verification

**Slug:** `REALPHONEVALIDATION_EMAIL_VERIFY`

Tool to validate an email address and check connectivity and disposability. Use after gathering an email to ensure it's deliverable and not disposable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify |
| `token` | string | Yes | Unique API token provided by RealPhoneValidation |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to 'json' |

#### 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 |

### DNC Lookup

**Slug:** `REALPHONEVALIDATION_LOOKUP_DNC`

Tool to check Do Not Call list status for US phone numbers. Determines if number is on National, State, or DMA Do Not Call lists, identifies cell vs landline, and checks for known TCPA litigators. Requires SAN number from FTC.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `token` | string | Yes | Your RealValidation API token |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to XML if omitted |

#### 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 Active Status

**Slug:** `REALPHONEVALIDATION_RPV_ACTIVE`

Tool to determine if a phone number is active on a valid phone service provider. Use after collecting the user's phone number for real-time verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `token` | string | Yes | Unique API token provided by RealPhoneValidation |
| `output` | string ("json" | "xml") | No | Response format. JSON or XML. XML output is not supported by this tool. |

#### 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 |

### Reassigned Number Lookup

**Slug:** `REALPHONEVALIDATION_RPV_REASSIGNED_NUMBER_LOOKUP`

Tool to check if a phone number has been reassigned since a given consent date. Use when verifying number ownership status after obtaining user consent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number (digits only) |
| `token` | string | Yes | RealPhoneValidation API token |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to 'json'. |
| `contact_date` | string | Yes | Date you received permission to contact in YYYY-MM-DD 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 |

### Scrub Plus Phone Numbers

**Slug:** `REALPHONEVALIDATION_RPV_SCRUB_PLUS`

Tool to scrub a phone number for connection status and type. Use to validate a US phone number's status and line type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number. Accepts formats like '7275555555', '727-555-5555', '(727) 555-5555', or '+17275555555' |
| `token` | string | Yes | API token provided by RealPhoneValidation |

#### 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 |

### Wireless ID

**Slug:** `REALPHONEVALIDATION_RPV_WIRELESS_ID`

Tool to identify whether a US phone number is landline or wireless. Use when conducting TCPA compliance checks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `token` | string | Yes | Your RealValidation API token |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml' |

#### 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 |

### Validate Phone Number (Scrub)

**Slug:** `REALPHONEVALIDATION_VALIDATE_PHONE_SCRUB`

Tool to validate US phone numbers using budget-friendly Scrub API. Determines connectivity status quickly (under 2 seconds). Best for organizations with large lists/databases on tight budgets that only need connection status. Optional Iscell and Carrier fields available for additional charge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `token` | string | Yes | Unique API token provided by RealPhoneValidation |
| `output` | string ("json" | "xml") | No | Response format. JSON or XML. XML output is not supported by this tool. |

#### 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 |

### Validate Phone Turbo Standard

**Slug:** `REALPHONEVALIDATION_VALIDATE_PHONE_TURBO_STANDARD`

Tool to perform real-time US phone validation using Turbo Standard API. Provides connection status and phone type (Mobile, Landline, VoIP). Optimized for web forms and apps when only connection status and phone type are needed. Faster than Turbo V3 when only basic validation is required. Returns results in about 2 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `token` | string | Yes | Unique API token provided by RealValidation |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to XML if omitted |

#### 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 |

### Validate Phone Turbo V3

**Slug:** `REALPHONEVALIDATION_VALIDATE_PHONE_TURBO_V3`

Tool to perform comprehensive real-time phone validation using Turbo V3 API. Returns connection status, phone type (landline, cell, VoIP), carrier ID, caller name (when available), and caller type (consumer, business). Use when complete phone data overview is required in web forms. US numbers only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | 10-digit US phone number, numeric digits only |
| `output` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to XML if omitted. |

#### 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 |