---
canonical_url: "https://docs.composio.dev/toolkits/apexverify"
markdown_url: "https://docs.composio.dev/toolkits/apexverify.md"
product: "platform"
version: null
last_updated: null
---

# ApexVerify

ApexVerify validates and normalizes email addresses and phone numbers individually or in batches to improve contact-data quality.

- **Category:** people & contact data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `APEXVERIFY`
- **Version:** 20261014_00

## Tools

### Delete Batch

**Slug:** `APEXVERIFY_DELETE_BATCH`

Permanently delete one ApexVerify batch by its exact UUID. Deletion is irreversible and unavailable while the batch is processing; verify the target batch first and deliberately set confirm_deletion=true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_uuid` | string | Yes | Exact UUID of the ApexVerify batch to permanently delete. |
| `confirm_deletion` | boolean | Yes | Must be true to acknowledge permanent deletion of this exact batch. This confirmation is never sent to ApexVerify. |

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

### Export Batch Results

**Slug:** `APEXVERIFY_EXPORT_BATCH_RESULTS`

Export a completed batch as structured JSON for analysis or as a downloadable XLSX workbook. This reads existing results and does not consume verification credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "xlsx") | No | Return structured JSON for analysis or an XLSX workbook as a downloadable file. |
| `batch_uuid` | string | Yes | Completed batch UUID to export. |
| `include_details` | boolean | No | For JSON exports, include per-value verification details. Ignored for XLSX exports. |
| `include_statistics` | boolean | No | For JSON exports, include aggregate verification statistics. Ignored for XLSX exports. |

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

**Slug:** `APEXVERIFY_GET_ACCOUNT_CREDITS`

Return the connected ApexVerify account's available email and phone verification credit balances. Use this before any credit-consuming verification.

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

**Slug:** `APEXVERIFY_GET_BATCH_DETAILS`

Get an ApexVerify batch's status, metadata, parsed-content counts, estimated verification cost, parameters, and final statistics. Repeat this call to monitor preparation or verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_uuid` | string | Yes | Batch UUID returned by Upload Verification Batch or List Batches. |

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

### Launch Batch Verification

**Slug:** `APEXVERIFY_LAUNCH_BATCH_VERIFICATION`

Launch paid verification for a prepared batch. This consumes the batch's estimated net email or phone credits and can fail when credits are insufficient. First inspect Get Batch Details and Get Account Credits, then deliberately set confirm_credit_spend=true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_uuid` | string | Yes | Exact UUID of the prepared batch whose status is ready_for_verification. Obtain it from Upload Verification Batch or List Batches. |
| `confirm_credit_spend` | boolean | Yes | Must be true to acknowledge spending the batch's estimated net email or phone verification credits. This confirmation is validated locally and is never sent to ApexVerify. |

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

### List Batches

**Slug:** `APEXVERIFY_LIST_BATCHES`

List verification batches, optionally restricted by creation time, one offset-controlled page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum batches requested for this page. ApexVerify defaults to 100 and does not document a maximum. |
| `offset` | integer | No | Zero-based number of batches to skip. Pass next_offset from the previous response to continue listing. |
| `to_date` | string | No | Include batches created at or before this ISO 8601 timestamp. |
| `from_date` | string | No | Include batches created at or after this ISO 8601 timestamp. |

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

### Normalize Data File

**Slug:** `APEXVERIFY_NORMALIZE_EMAIL_OR_PHONE_FILE`

Normalize email addresses or phone numbers from a line-delimited TXT file without performing verification or consuming verification credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | UTF-8 TXT file containing one email address or phone number per line. |
| `type` | string ("email" | "phone") | Yes | Kind of values contained in the file. |
| `target_country` | string ("AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AR" | "AS" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BR" | "BT" | "BW" | "BY" | "BZ" | "CA" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GG" | "GH" | "GI" | "GL" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GW" | "GY" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KM" | "KN" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TG" | "TH" | "TJ" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VN" | "VU" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW") | Yes | Supported ISO 3166-1 alpha-2 country code used for normalization. |

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

### Prepare Batch

**Slug:** `APEXVERIFY_PREPARE_BATCH`

Start or repeat asynchronous parsing, deduplication, format cleanup, and verification-cost calculation for an uploaded batch. This idempotent action does not launch paid verification. Poll Get Batch Details until the batch is ready for verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `batch_uuid` | string | Yes | Uploaded batch UUID to prepare. |

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

### Upload Verification Batch

**Slug:** `APEXVERIFY_UPLOAD_BATCH`

Create an ApexVerify verification batch from a line-delimited TXT file. Uploading does not consume verification credits; verification starts only when the batch is launched separately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | UTF-8 .txt file containing one email address or phone number per line, with no more than one million lines. |
| `name` | string | Yes | Batch name, between 1 and 255 characters. |
| `type` | string ("email" | "phone") | Yes | Kind of values in the uploaded file: email or phone. |
| `description` | string | No | Optional batch description, at most 2048 characters. |
| `target_country` | string ("AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AR" | "AS" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BR" | "BT" | "BW" | "BY" | "BZ" | "CA" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GG" | "GH" | "GI" | "GL" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GW" | "GY" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KM" | "KN" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TG" | "TH" | "TJ" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VN" | "VU" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW") | Yes | Supported ISO 3166-1 alpha-2 country code used to interpret the values. |
| `target_audience` | string ("Agency / Consultants" | "Creators & Influencers" | "Customer Support & Success" | "Developers & Technical Leads" | "E-commerce & Retail Managers" | "Enterprise Decision-Makers" | "Finance & Operations Professionals" | "Founders & C-Level Executives" | "Freelancers & Solopreneurs" | "Government & Public Sector Employees" | "HR & Talent Acquisition" | "Healthcare Professionals" | "Hobbyists & Enthusiasts" | "Investors & VCs" | "Job Seekers" | "Legal Professionals" | "Marketing & Sales Professionals" | "Non-Profit Leaders & Staff" | "Parents & Families" | "Product & Project Managers" | "Real Estate Professionals" | "Small-to-Medium Business (SMB) Owners" | "Students & Educators") | No | Target audience. Select the semantic label that best matches the contacts. |
| `remove_duplicate` | boolean | No | Remove duplicate input values during preparation. |
| `target_objective` | string ("App Installs / Downloads" | "Audience Building (Email/Community)" | "Brand Awareness & Recall" | "Customer Acquisition / Sales" | "Free Trial or Freemium Signups" | "Lead Generation (Top/Mid-Funnel)" | "Loyalty & Referral Program Growth" | "Market & Customer Research" | "New Market Entry" | "Partner & Affiliate Recruitment" | "Product Engagement & Feature Adoption" | "Sales-Ready Leads (Bottom-Funnel)" | "Upsell / Cross-sell Revenue" | "User Retention & Churn Reduction" | "Waitlist / Pre-order Signups" | "Website / App Traffic Acquisition") | No | Verification campaign objective. Select the semantic label that best describes the goal. |
| `use_global_cache` | boolean | No | Allow anonymized verification-result reuse across ApexVerify customers. Enabling this grants ApexVerify permission to reuse this batch's results across clients and may receive a 50% credit refund. |
| `use_account_cache` | boolean | No | Allow recent connected-account cached verification results. |
| `target_market_industry` | string ("Accommodation" | "Accommodation and Food Services" | "Administrative and Support Services" | "Administrative and Support and Waste Management and Remediation Services" | "Agriculture, Forestry, Fishing and Hunting" | "Air Transportation" | "Ambulatory Health Care Services" | "Amusement, Gambling, and Recreation Industries" | "Animal Production" | "Apparel Manufacturing" | "Arts, Entertainment, and Recreation" | "Beverage and Tobacco Product Manufacturing" | "Broadcasting (except Internet)" | "Building Material and Garden Equipment and Supplies Dealers" | "Chemical Manufacturing" | "Clothing and Clothing Accessories Stores" | "Computer and Electronic Product Manufacturing" | "Construction" | "Construction of Buildings" | "Couriers and Messengers" | "Credit Intermediation and Related Activities" | "Crop Production" | "Data Processing, Hosting, and Related Services" | "Education and Health Services" | "Educational Services" | "Electrical Equipment, Appliance, and Component Manufacturing" | "Electronics and Appliance Stores" | "Fabricated Metal Product Manufacturing" | "Finance and Insurance" | "Financial Activities" | "Fishing, Hunting and Trapping" | "Food Manufacturing" | "Food Services and Drinking Places" | "Food and Beverage Stores" | "Forestry and Logging" | "Funds, Trusts, and Other Financial Vehicles" | "Furniture and Home Furnishings Stores" | "Furniture and Related Product Manufacturing" | "Gasoline Stations" | "General Merchandise Stores" | "Goods-Producing Industries" | "Health Care and Social Assistance" | "Health and Personal Care Stores" | "Heavy and Civil Engineering Construction" | "Hospitals" | "Information" | "Insurance Carriers and Related Activities" | "Internet Publishing and Broadcasting" | "Leather and Allied Product Manufacturing" | "Leisure and Hospitality" | "Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)" | "Machinery Manufacturing" | "Management of Companies and Enterprises" | "Manufacturing" | "Merchant Wholesalers, Durable Goods" | "Merchant Wholesalers, Nondurable Goods" | "Mining (except Oil and Gas)" | "Mining, Quarrying, and Oil and Gas Extraction" | "Miscellaneous Manufacturing" | "Miscellaneous Store Retailers" | "Monetary Authorities - Central Bank" | "Motion Picture and Sound Recording Industries" | "Motor Vehicle and Parts Dealers" | "Museums, Historical Sites, and Similar Institutions" | "Natural Resources and Mining" | "Nonmetallic Mineral Product Manufacturing" | "Nonstore Retailers" | "Nursing and Residential Care Facilities" | "Oil and Gas Extraction" | "Other Information Services" | "Other Services (except Public Administration)" | "Paper Manufacturing" | "Performing Arts, Spectator Sports, and Related Industries" | "Personal and Laundry Services" | "Petroleum and Coal Products Manufacturing" | "Pipeline Transportation" | "Plastics and Rubber Products Manufacturing" | "Postal Service" | "Primary Metal Manufacturing" | "Printing and Related Support Activities" | "Private Households" | "Professional and Business Services" | "Professional, Scientific, and Technical Services" | "Publishing Industries (except Internet)" | "Rail Transportation" | "Real Estate" | "Real Estate and Rental and Leasing" | "Religious, Grantmaking, Civic, Professional, and Similar Organizations" | "Rental and Leasing Services" | "Repair and Maintenance" | "Retail Trade" | "Scenic and Sightseeing Transportation" | "Securities, Commodity Contracts, and Other Financial Investments and Related Activities" | "Service-Providing Industries" | "Social Assistance" | "Specialty Trade Contractors" | "Sporting Goods, Hobby, Book, and Music Stores" | "Support Activities for Agriculture and Forestry" | "Support Activities for Mining" | "Support Activities for Transportation" | "Telecommunications" | "Textile Mills" | "Textile Product Mills" | "Trade, Transportation, and Utilities" | "Transit and Ground Passenger Transportation" | "Transportation Equipment Manufacturing" | "Transportation and Warehousing" | "Truck Transportation" | "Utilities" | "Warehousing and Storage" | "Waste Management and Remediation Services" | "Water Transportation" | "Wholesale Electronic Markets and Agents and Brokers" | "Wholesale Trade" | "Wood Product Manufacturing") | No | Target market industry. Select the semantic industry label that best matches the contacts. |
| `max_global_cache_backoff` | integer | No | Maximum ApexVerify global-cache age in days, from 1 through 180. |
| `max_account_cache_backoff` | integer | No | Maximum connected-account cache age in days, from 1 through 180. |
| `remove_wrong_email_format` | boolean | No | Remove malformed email values during preparation. |
| `remove_wrong_phone_format` | boolean | No | Remove malformed phone values during preparation. |

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

**Slug:** `APEXVERIFY_VERIFY_EMAIL_OR_PHONE`

Verify one email address or phone number in real time. This consumes the corresponding prepaid verification credit; cache hits may receive a partial refund. Check account credits first and deliberately set confirm_credit_usage=true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("email" | "phone") | Yes | Whether the unit is an email address or phone number. |
| `unit` | string | Yes | The single email address or phone number to verify. |
| `target_country` | string ("AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AO" | "AR" | "AS" | "AT" | "AU" | "AW" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BL" | "BM" | "BN" | "BO" | "BR" | "BT" | "BW" | "BY" | "BZ" | "CA" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CU" | "CV" | "CW" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FK" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GG" | "GH" | "GI" | "GL" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GW" | "GY" | "HK" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KM" | "KN" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MF" | "MG" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "TC" | "TD" | "TG" | "TH" | "TJ" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VC" | "VE" | "VG" | "VN" | "VU" | "WS" | "YE" | "YT" | "ZA" | "ZM" | "ZW") | Yes | Supported ISO 3166-1 alpha-2 country code used to interpret the value, especially phone numbers. |
| `target_audience` | string ("Agency / Consultants" | "Creators & Influencers" | "Customer Support & Success" | "Developers & Technical Leads" | "E-commerce & Retail Managers" | "Enterprise Decision-Makers" | "Finance & Operations Professionals" | "Founders & C-Level Executives" | "Freelancers & Solopreneurs" | "Government & Public Sector Employees" | "HR & Talent Acquisition" | "Healthcare Professionals" | "Hobbyists & Enthusiasts" | "Investors & VCs" | "Job Seekers" | "Legal Professionals" | "Marketing & Sales Professionals" | "Non-Profit Leaders & Staff" | "Parents & Families" | "Product & Project Managers" | "Real Estate Professionals" | "Small-to-Medium Business (SMB) Owners" | "Students & Educators") | No | Target audience. Select the semantic label that best matches the contacts. |
| `target_objective` | string ("App Installs / Downloads" | "Audience Building (Email/Community)" | "Brand Awareness & Recall" | "Customer Acquisition / Sales" | "Free Trial or Freemium Signups" | "Lead Generation (Top/Mid-Funnel)" | "Loyalty & Referral Program Growth" | "Market & Customer Research" | "New Market Entry" | "Partner & Affiliate Recruitment" | "Product Engagement & Feature Adoption" | "Sales-Ready Leads (Bottom-Funnel)" | "Upsell / Cross-sell Revenue" | "User Retention & Churn Reduction" | "Waitlist / Pre-order Signups" | "Website / App Traffic Acquisition") | No | Verification campaign objective. Select the semantic label that best describes the goal. |
| `use_global_cache` | boolean | No | Allow anonymized verification-result reuse across ApexVerify customers. Enabling this grants ApexVerify permission to reuse this result across clients and may receive a 50% credit refund. |
| `use_account_cache` | boolean | No | Allow a recent connected-account cache result. |
| `confirm_credit_usage` | boolean | Yes | Must be true to acknowledge that this call consumes a prepaid email or phone verification credit. This confirmation is never sent to ApexVerify. |
| `target_market_industry` | string ("Accommodation" | "Accommodation and Food Services" | "Administrative and Support Services" | "Administrative and Support and Waste Management and Remediation Services" | "Agriculture, Forestry, Fishing and Hunting" | "Air Transportation" | "Ambulatory Health Care Services" | "Amusement, Gambling, and Recreation Industries" | "Animal Production" | "Apparel Manufacturing" | "Arts, Entertainment, and Recreation" | "Beverage and Tobacco Product Manufacturing" | "Broadcasting (except Internet)" | "Building Material and Garden Equipment and Supplies Dealers" | "Chemical Manufacturing" | "Clothing and Clothing Accessories Stores" | "Computer and Electronic Product Manufacturing" | "Construction" | "Construction of Buildings" | "Couriers and Messengers" | "Credit Intermediation and Related Activities" | "Crop Production" | "Data Processing, Hosting, and Related Services" | "Education and Health Services" | "Educational Services" | "Electrical Equipment, Appliance, and Component Manufacturing" | "Electronics and Appliance Stores" | "Fabricated Metal Product Manufacturing" | "Finance and Insurance" | "Financial Activities" | "Fishing, Hunting and Trapping" | "Food Manufacturing" | "Food Services and Drinking Places" | "Food and Beverage Stores" | "Forestry and Logging" | "Funds, Trusts, and Other Financial Vehicles" | "Furniture and Home Furnishings Stores" | "Furniture and Related Product Manufacturing" | "Gasoline Stations" | "General Merchandise Stores" | "Goods-Producing Industries" | "Health Care and Social Assistance" | "Health and Personal Care Stores" | "Heavy and Civil Engineering Construction" | "Hospitals" | "Information" | "Insurance Carriers and Related Activities" | "Internet Publishing and Broadcasting" | "Leather and Allied Product Manufacturing" | "Leisure and Hospitality" | "Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)" | "Machinery Manufacturing" | "Management of Companies and Enterprises" | "Manufacturing" | "Merchant Wholesalers, Durable Goods" | "Merchant Wholesalers, Nondurable Goods" | "Mining (except Oil and Gas)" | "Mining, Quarrying, and Oil and Gas Extraction" | "Miscellaneous Manufacturing" | "Miscellaneous Store Retailers" | "Monetary Authorities - Central Bank" | "Motion Picture and Sound Recording Industries" | "Motor Vehicle and Parts Dealers" | "Museums, Historical Sites, and Similar Institutions" | "Natural Resources and Mining" | "Nonmetallic Mineral Product Manufacturing" | "Nonstore Retailers" | "Nursing and Residential Care Facilities" | "Oil and Gas Extraction" | "Other Information Services" | "Other Services (except Public Administration)" | "Paper Manufacturing" | "Performing Arts, Spectator Sports, and Related Industries" | "Personal and Laundry Services" | "Petroleum and Coal Products Manufacturing" | "Pipeline Transportation" | "Plastics and Rubber Products Manufacturing" | "Postal Service" | "Primary Metal Manufacturing" | "Printing and Related Support Activities" | "Private Households" | "Professional and Business Services" | "Professional, Scientific, and Technical Services" | "Publishing Industries (except Internet)" | "Rail Transportation" | "Real Estate" | "Real Estate and Rental and Leasing" | "Religious, Grantmaking, Civic, Professional, and Similar Organizations" | "Rental and Leasing Services" | "Repair and Maintenance" | "Retail Trade" | "Scenic and Sightseeing Transportation" | "Securities, Commodity Contracts, and Other Financial Investments and Related Activities" | "Service-Providing Industries" | "Social Assistance" | "Specialty Trade Contractors" | "Sporting Goods, Hobby, Book, and Music Stores" | "Support Activities for Agriculture and Forestry" | "Support Activities for Mining" | "Support Activities for Transportation" | "Telecommunications" | "Textile Mills" | "Textile Product Mills" | "Trade, Transportation, and Utilities" | "Transit and Ground Passenger Transportation" | "Transportation Equipment Manufacturing" | "Transportation and Warehousing" | "Truck Transportation" | "Utilities" | "Warehousing and Storage" | "Waste Management and Remediation Services" | "Water Transportation" | "Wholesale Electronic Markets and Agents and Brokers" | "Wholesale Trade" | "Wood Product Manufacturing") | No | Target market industry. Select the semantic industry label that best matches the contacts. |
| `max_global_cache_backoff` | integer | No | Maximum ApexVerify global-cache age in days (1-180). |
| `max_account_cache_backoff` | integer | No | Maximum connected-account cache age in days (1-180). |

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