Batch Parameters Update

View as Markdown
Update the batch verification parameters before launch, including country, settings, cache options, and other related configuration.

Authentication

X-API-Keystring
API Key authentication via header

Path parameters

batch_uuidstringRequiredformat: "uuid"

Request

This endpoint expects an object.
typeenumRequired
Type of verification to apply to the batch.
Allowed values:
target_countryenumRequired
Country against which the batch should be processed.
target_audienceenumOptional

1 = Agency / Consultants
2 = Creators & Influencers
3 = Customer Support & Success
4 = Developers & Technical Leads
5 = E-commerce & Retail Managers
6 = Enterprise Decision-Makers
7 = Finance & Operations Professionals
8 = Founders & C-Level Executives
9 = Freelancers & Solopreneurs
10 = Government & Public Sector Employees
11 = HR & Talent Acquisition
12 = Healthcare Professionals
13 = Hobbyists & Enthusiasts
14 = Investors & VCs
15 = Job Seekers
16 = Legal Professionals
17 = Marketing & Sales Professionals
18 = Non-Profit Leaders & Staff
19 = Parents & Families
20 = Product & Project Managers
21 = Real Estate Professionals
22 = Small-to-Medium Business (SMB) Owners
23 = Students & Educators

target_market_industryenumOptional

1 = Accommodation
2 = Accommodation and Food Services
3 = Administrative and Support Services
4 = Administrative and Support and Waste Management and Remediation Services
5 = Agriculture, Forestry, Fishing and Hunting
6 = Air Transportation
7 = Ambulatory Health Care Services
8 = Amusement, Gambling, and Recreation Industries
9 = Animal Production
10 = Apparel Manufacturing
11 = Arts, Entertainment, and Recreation
12 = Beverage and Tobacco Product Manufacturing
13 = Broadcasting (except Internet)
14 = Building Material and Garden Equipment and Supplies Dealers
15 = Chemical Manufacturing
16 = Clothing and Clothing Accessories Stores
17 = Computer and Electronic Product Manufacturing
18 = Construction
19 = Construction of Buildings
20 = Couriers and Messengers
21 = Credit Intermediation and Related Activities
22 = Crop Production
23 = Data Processing, Hosting, and Related Services
24 = Education and Health Services
25 = Educational Services
26 = Electrical Equipment, Appliance, and Component Manufacturing
27 = Electronics and Appliance Stores
28 = Fabricated Metal Product Manufacturing
29 = Finance and Insurance
30 = Financial Activities
31 = Fishing, Hunting and Trapping
32 = Food Manufacturing
33 = Food Services and Drinking Places
34 = Food and Beverage Stores
35 = Forestry and Logging
36 = Funds, Trusts, and Other Financial Vehicles
37 = Furniture and Home Furnishings Stores
38 = Furniture and Related Product Manufacturing
39 = Gasoline Stations
40 = General Merchandise Stores
41 = Goods-Producing Industries
42 = Health Care and Social Assistance
43 = Health and Personal Care Stores
44 = Heavy and Civil Engineering Construction
45 = Hospitals
46 = Information
47 = Insurance Carriers and Related Activities
48 = Internet Publishing and Broadcasting
49 = Leather and Allied Product Manufacturing
50 = Leisure and Hospitality
51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)
52 = Machinery Manufacturing
53 = Management of Companies and Enterprises
54 = Manufacturing
55 = Merchant Wholesalers, Durable Goods
56 = Merchant Wholesalers, Nondurable Goods
57 = Mining (except Oil and Gas)
58 = Mining, Quarrying, and Oil and Gas Extraction
59 = Miscellaneous Manufacturing
60 = Miscellaneous Store Retailers
61 = Monetary Authorities - Central Bank
62 = Motion Picture and Sound Recording Industries
63 = Motor Vehicle and Parts Dealers
64 = Museums, Historical Sites, and Similar Institutions
65 = Natural Resources and Mining
66 = Nonmetallic Mineral Product Manufacturing
67 = Nonstore Retailers
68 = Nursing and Residential Care Facilities
69 = Oil and Gas Extraction
70 = Other Information Services
71 = Other Services (except Public Administration)
72 = Paper Manufacturing
73 = Performing Arts, Spectator Sports, and Related Industries
74 = Personal and Laundry Services
75 = Petroleum and Coal Products Manufacturing
76 = Pipeline Transportation
77 = Plastics and Rubber Products Manufacturing
78 = Postal Service
79 = Primary Metal Manufacturing
80 = Printing and Related Support Activities
81 = Private Households
82 = Professional and Business Services
83 = Professional, Scientific, and Technical Services
84 = Publishing Industries (except Internet)
85 = Rail Transportation
86 = Real Estate
87 = Real Estate and Rental and Leasing
88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations
89 = Rental and Leasing Services
90 = Repair and Maintenance
91 = Retail Trade
92 = Scenic and Sightseeing Transportation
93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities
94 = Service-Providing Industries
95 = Social Assistance
96 = Specialty Trade Contractors
97 = Sporting Goods, Hobby, Book, and Music Stores
98 = Support Activities for Agriculture and Forestry
99 = Support Activities for Mining
100 = Support Activities for Transportation
101 = Telecommunications
102 = Textile Mills
103 = Textile Product Mills
104 = Trade, Transportation, and Utilities
105 = Transit and Ground Passenger Transportation
106 = Transportation Equipment Manufacturing
107 = Transportation and Warehousing
108 = Truck Transportation
109 = Utilities
110 = Warehousing and Storage
111 = Waste Management and Remediation Services
112 = Water Transportation
113 = Wholesale Electronic Markets and Agents and Brokers
114 = Wholesale Trade
115 = Wood Product Manufacturing

target_objectiveenumOptional

1 = App Installs / Downloads
2 = Audience Building (Email/Community)
3 = Brand Awareness & Recall
4 = Customer Acquisition / Sales
5 = Free Trial or Freemium Signups
6 = Lead Generation (Top/Mid-Funnel)
7 = Loyalty & Referral Program Growth
8 = Market & Customer Research
9 = New Market Entry
10 = Partner & Affiliate Recruitment
11 = Product Engagement & Feature Adoption
12 = Sales-Ready Leads (Bottom-Funnel)
13 = Upsell / Cross-sell Revenue
14 = User Retention & Churn Reduction
15 = Waitlist / Pre-order Signups
16 = Website / App Traffic Acquisition

use_account_cachebooleanOptionalDefaults to true

You can choose to enable or disable your account cache. If enabled, we may reuse your previous verification results to speed up processing and improve efficiency. When your account cache is used, you’ll receive a 50% credit refund for those verifications. You can enable both the account cache and the global cache, or disable both. Our system will always check your account cache first, then the global cache.

max_account_cache_backoffintegerOptional1-180Defaults to 30

Set the maximum number of days our system should look back to find matching verification results for this file. Min: 1 (only today) - Max: 180 days.

use_global_cachebooleanOptionalDefaults to true

You can choose to enable or disable the global cache. When the global cache is used, you’ll receive a 50% credit refund for the related verifications. If enabled, your verification results will be shared anonymously with other users, and you’ll also gain access to anonymized results from other companies. This shared data is fully abstracted and anonymized, no personal or identifiable information is exposed. By enabling this option, you give us permission to reuse previous verification results across different clients to improve efficiency and reduce redundancy.

max_global_cache_backoffintegerOptional1-180Defaults to 30

Set the maximum number of days our system should look back to find matching verification results for this file. Min: 1 (only today) - Max: 180 days.

remove_duplicatebooleanOptionalDefaults to true
Whether duplicate rows should be removed during batch preparation.
remove_wrong_email_formatbooleanOptionalDefaults to true
Whether rows with invalid email formatting should be removed during batch preparation.
remove_wrong_phone_formatbooleanOptionalDefaults to true
Whether rows with invalid phone formatting should be removed during batch preparation.

Response

Successful Response
messagestringDefaults to Success

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error