{"openapi":"3.1.0","info":{"title":"ApexVerify Api","version":"1.0.0"},"paths":{"/v1/account/credits":{"get":{"operationId":"account_get_credits_v1_account_credits_get","summary":"Account Credits","description":"Retrieve the current credit balance for the account.","tags":["account"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreditResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/batch":{"get":{"operationId":"batch_listV1BatchGet","summary":"Batch List","description":"List all batch files for the account, including each batch UUID, status, name, and creation date.","tags":["batch"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"from_date","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"}},{"name":"to_date","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchListModelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"operationId":"batch_uploadV1BatchPost","summary":"Batch Upload","description":"Upload a batch file for verification. Accepts a TXT file containing line-return delimited content.","tags":["batch"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_uploadV1BatchPost_Response_200"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"Batch file content to upload for verification."},"name":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the batch."},"description":{"type":["string","null"],"maxLength":2048,"description":"Optional description of the batch"},"type":{"$ref":"#/components/schemas/BatchVerificationTypeEnum","description":"Type of verification to apply to the batch."},"target_country":{"$ref":"#/components/schemas/CountryCodeIso2Enum","description":"Country against which the batch should be processed."},"target_audience":{"$ref":"#/components/schemas/V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetAudience","description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators"},"target_market_industry":{"$ref":"#/components/schemas/V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetMarketIndustry","description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing"},"target_objective":{"$ref":"#/components/schemas/V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetObjective","description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition"},"remove_duplicate":{"type":"boolean","default":true,"description":"Whether duplicate rows should be removed during batch preparation."},"remove_wrong_email_format":{"type":"boolean","default":true,"description":"Whether rows with invalid email formatting should be removed during batch preparation."},"remove_wrong_phone_format":{"type":"boolean","default":true,"description":"Whether rows with invalid phone formatting should be removed during batch preparation."},"use_account_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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."}},"required":["file","name","type","target_country"]}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/batch/{batch_uuid}":{"get":{"operationId":"batch_status_v1_batch__batch_uuid__get","summary":"Batch Status","description":"Retrieve the current status of the batch. Once available, the response also includes execution costs, results, and refund information.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_status_v1_batch__batch_uuid__get_Response_200"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"operationId":"batch_post_v1_batch__batch_uuid__post","summary":"Batch Verification Launch","description":"Start batch verification if the batch status reached ready_for_verification.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPostModelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"402":{"description":"Please reload your credits to proceed with the verification...","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"operationId":"batch_put_v1_batch__batch_uuid__put","summary":"Batch Parameters Update","description":"Update the batch verification parameters before launch, including country, settings, cache options, and other related configuration.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"}}}},"security":[{"APIKeyHeader":[]}]},"delete":{"operationId":"batch_delete_v1_batch__batch_uuid__delete","summary":"Batch Deletion","description":"Delete the corresponding batch before or after verification, but not while processing is in progress.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]},"patch":{"operationId":"batch_patch_v1_batch__batch_uuid__patch","summary":"Batch Preparation & Content Reprocessing","description":"Start parsing and preparing the batch for verification once upload done & all parameters are correctly configured. This operation can be triggered as much as required until parameters match requirements.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPatchModelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/batch/{batch_uuid}/export":{"get":{"operationId":"batch_exportV1BatchBatchUuidExportGet","summary":"Batch Result Export","description":"Export batch results in XLSX format, consistent with the frontend output, or as a JSON dump including data and result content, with optional additional sections such as statistics and details.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"query","required":true,"schema":{"$ref":"#/components/schemas/BatchExportFormatEnum"}},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","default":true}},{"name":"include_statistics","in":"query","required":false,"schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Batch export as JSON or XLSX","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchExportModelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/batch/{batch_uuid}/details":{"get":{"operationId":"batch_detailsV1BatchBatchUuidDetailsGet","summary":"Batch Details","description":"Retrieve detailed information about a batch file for the account, including its UUID, status, name, description, parameters, uploaded content, and related metadata.","tags":["batch"],"parameters":[{"name":"batch_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Batch_detailsV1BatchBatchUuidDetailsGet_Response_200"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/unit":{"post":{"operationId":"unit_post_v1_unit_post","summary":"Unit Verification","description":"Start unit verification to get real-time verification results for a given unit. The verification process can take up to 5 seconds to complete, depending on the complexity of the unit...","tags":["unit"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unit_post_v1_unit_post_Response_200"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitVerificationModelPayload"}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/format":{"post":{"operationId":"format_normalizationV1FormatPost","summary":"Data Format Normalization","description":"Normalize Data Format. Accepts a TXT file containing line-return delimited content.","tags":["format"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatNormalizationModelResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponse"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"Data Format file content to upload for normalization."},"type":{"$ref":"#/components/schemas/BatchVerificationTypeEnum","description":"Type of data to apply to the formatting."},"target_country":{"$ref":"#/components/schemas/CountryCodeIso2Enum","description":"Country against which the format should be processed."}},"required":["file","type","target_country"]}}}}}}},"tags":[{"name":"account"},{"name":"batch"},{"name":"unit"},{"name":"format"}],"servers":[{"url":"https://api.apexverify.com","description":"Production API Server"}],"components":{"schemas":{"AccountCreditResponse":{"type":"object","properties":{"email_credit":{"type":"number","format":"double"},"phone_credit":{"type":"number","format":"double"}},"required":["email_credit","phone_credit"],"title":"AccountCreditResponse"},"BadRequestResponse":{"type":"object","properties":{"message":{"type":"string","default":"Bad Request"}},"title":"BadRequestResponse"},"UnauthorizedResponse":{"type":"object","properties":{"message":{"type":"string","default":"Unauthorized"}},"title":"UnauthorizedResponse"},"ForbiddenResponse":{"type":"object","properties":{"message":{"type":"string","default":"Forbidden"}},"title":"ForbiddenResponse"},"NotFoundResponse":{"type":"object","properties":{"message":{"type":"string","default":"Not Found"}},"title":"NotFoundResponse"},"TooManyRequestsResponse":{"type":"object","properties":{"message":{"type":"string","default":"Too Many Requests"}},"title":"TooManyRequestsResponse"},"InternalServerErrorResponse":{"type":"object","properties":{"message":{"type":"string","default":"Internal Server Error. Please contact support at contact@apexverify.com..."}},"title":"InternalServerErrorResponse"},"BatchStatusEnum":{"type":"string","enum":["parsing_content","ready_for_verification","verification_ongoing","verification_done","internal_error"],"title":"BatchStatusEnum"},"BaseBatch":{"type":"object","properties":{"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/BatchStatusEnum"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["batch_uuid","name","description","status","created_at","updated_at"],"title":"BaseBatch"},"BatchListModelResponse":{"type":"array","items":{"$ref":"#/components/schemas/BaseBatch"},"title":"BatchListModelResponse"},"ValidationErrorLocItems":{"oneOf":[{"type":"string"},{"type":"integer"}],"title":"ValidationErrorLocItems"},"ValidationErrorCtx":{"type":"object","properties":{},"title":"ValidationErrorCtx"},"ValidationError":{"type":"object","properties":{"loc":{"type":"array","items":{"$ref":"#/components/schemas/ValidationErrorLocItems"}},"msg":{"type":"string"},"type":{"type":"string"},"input":{"description":"Any type"},"ctx":{"$ref":"#/components/schemas/ValidationErrorCtx"}},"required":["loc","msg","type"],"title":"ValidationError"},"HTTPValidationError":{"type":"object","properties":{"detail":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}},"title":"HTTPValidationError"},"BatchVerificationTypeEnum":{"type":"string","enum":["email","phone"],"title":"BatchVerificationTypeEnum"},"CountryCodeIso2Enum":{"type":"string","enum":["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"],"title":"CountryCodeIso2Enum"},"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetAudience":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23"],"description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators","title":"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetAudience"},"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetMarketIndustry":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115"],"description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing","title":"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetMarketIndustry"},"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetObjective":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16"],"description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition","title":"V1BatchPostRequestBodyContentMultipartFormDataSchemaTargetObjective"},"Batch_uploadV1BatchPost_Response_200":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Discriminator value: ok"},"batch_uuid":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"}},"required":["status","batch_uuid","created_at"],"description":"ok variant"},{"type":"object","properties":{"status":{"type":"string","enum":["parse_error"],"description":"Discriminator value: parse_error"}},"required":["status"],"description":"parse_error variant"},{"type":"object","properties":{"status":{"type":"string","enum":["error"],"description":"Discriminator value: error"}},"required":["status"],"description":"error variant"}],"discriminator":{"propertyName":"status"},"title":"Batch_uploadV1BatchPost_Response_200"},"BatchSetupVerificationParsingEmail":{"type":"object","properties":{"valid_email":{"type":"integer","default":0},"wrong_email":{"type":"integer","default":0},"duplicate_email":{"type":"integer","default":0}},"title":"BatchSetupVerificationParsingEmail"},"BatchSetupVerificationParsingPhone":{"type":"object","properties":{"valid_phone":{"type":"integer","default":0},"wrong_phone":{"type":"integer","default":0},"duplicate_phone":{"type":"integer","default":0}},"title":"BatchSetupVerificationParsingPhone"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundContent":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationParsingEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationParsingPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundContent"},"BatchSetupVerificationCostEmail":{"type":"object","properties":{"total_email_cost":{"type":"integer"},"net_email_cost":{"type":"number","format":"double"},"email_cache_account_return":{"type":"integer"},"email_cache_global_return":{"type":"integer"}},"required":["total_email_cost","net_email_cost","email_cache_account_return","email_cache_global_return"],"title":"BatchSetupVerificationCostEmail"},"BatchSetupVerificationCostPhone":{"type":"object","properties":{"total_phone_cost":{"type":"integer"},"net_phone_cost":{"type":"number","format":"double"},"phone_cache_account_return":{"type":"integer"},"phone_cache_global_return":{"type":"integer"}},"required":["total_phone_cost","net_phone_cost","phone_cache_account_return","phone_cache_global_return"],"title":"BatchSetupVerificationCostPhone"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundCost":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationCostEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationCostPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundCost"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationParsingEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationParsingPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationCostEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationCostPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationParsingEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationParsingPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent"},"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationCostEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationCostPhone"}],"title":"V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost"},"VerificationStats":{"type":"object","properties":{"total_verification":{"type":["integer","null"],"default":0},"total_verification_valid":{"type":["integer","null"],"default":0},"total_verification_wrong":{"type":["integer","null"],"default":0},"total_verification_unknown":{"type":["integer","null"],"default":0},"total_verification_duplicate":{"type":["integer","null"],"default":0},"total_verification_account_cache":{"type":["integer","null"],"default":0},"total_verification_global_cache":{"type":["integer","null"],"default":0},"total_verification_valid_perc":{"type":["number","null"],"format":"double","default":0},"total_verification_wrong_perc":{"type":["number","null"],"format":"double","default":0},"total_verification_unknown_perc":{"type":["number","null"],"format":"double","default":0},"total_verification_account_cache_perc":{"type":["number","null"],"format":"double","default":0},"total_verification_global_cache_perc":{"type":["number","null"],"format":"double","default":0}},"title":"VerificationStats"},"Batch_status_v1_batch__batch_uuid__get_Response_200":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["parsing_content"],"description":"Discriminator value: parsing_content"}},"required":["status"],"description":"parsing_content variant"},{"type":"object","properties":{"status":{"type":"string","enum":["ready_for_verification"],"description":"Discriminator value: ready_for_verification"},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingReadyForVerificationFoundCost"}},"required":["status","found_content","found_cost"],"description":"ready_for_verification variant"},{"type":"object","properties":{"status":{"type":"string","enum":["verification_ongoing"],"description":"Discriminator value: verification_ongoing"},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost"}},"required":["status","found_content","found_cost"],"description":"verification_ongoing variant"},{"type":"object","properties":{"status":{"type":"string","enum":["verification_done"],"description":"Discriminator value: verification_done"},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost"},"stats":{"$ref":"#/components/schemas/VerificationStats"}},"required":["status","found_content","found_cost","stats"],"description":"verification_done variant"},{"type":"object","properties":{"status":{"type":"string","enum":["internal_error"],"description":"Discriminator value: internal_error"},"message":{"type":"string"}},"required":["status","message"],"description":"internal_error variant"}],"discriminator":{"propertyName":"status"},"title":"Batch_status_v1_batch__batch_uuid__get_Response_200"},"BatchPostRequestStatusResponseEnum":{"type":"string","enum":["ok","error","not_ready_for_verification","verification_already_ongoing","verification_already_done"],"title":"BatchPostRequestStatusResponseEnum"},"BatchPostModelResponse":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/BatchPostRequestStatusResponseEnum"}},"required":["status"],"title":"BatchPostModelResponse"},"PaymentRequiredResponse":{"type":"object","properties":{"message":{"type":"string","default":"Payment Required. Please reload your credits to proceed with the verification..."}},"title":"PaymentRequiredResponse"},"BatchVerificationParametersModelPayloadTargetAudience":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23"],"description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators","title":"BatchVerificationParametersModelPayloadTargetAudience"},"BatchVerificationParametersModelPayloadTargetMarketIndustry":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115"],"description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing","title":"BatchVerificationParametersModelPayloadTargetMarketIndustry"},"BatchVerificationParametersModelPayloadTargetObjective":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16"],"description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition","title":"BatchVerificationParametersModelPayloadTargetObjective"},"BatchVerificationParametersModelPayload":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BatchVerificationTypeEnum","description":"Type of verification to apply to the batch."},"target_country":{"$ref":"#/components/schemas/CountryCodeIso2Enum","description":"Country against which the batch should be processed."},"target_audience":{"$ref":"#/components/schemas/BatchVerificationParametersModelPayloadTargetAudience","description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators"},"target_market_industry":{"$ref":"#/components/schemas/BatchVerificationParametersModelPayloadTargetMarketIndustry","description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing"},"target_objective":{"$ref":"#/components/schemas/BatchVerificationParametersModelPayloadTargetObjective","description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition"},"use_account_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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_duplicate":{"type":"boolean","default":true,"description":"Whether duplicate rows should be removed during batch preparation."},"remove_wrong_email_format":{"type":"boolean","default":true,"description":"Whether rows with invalid email formatting should be removed during batch preparation."},"remove_wrong_phone_format":{"type":"boolean","default":true,"description":"Whether rows with invalid phone formatting should be removed during batch preparation."}},"required":["type","target_country"],"title":"BatchVerificationParametersModelPayload"},"SuccessResponse":{"type":"object","properties":{"message":{"type":"string","default":"Success"}},"title":"SuccessResponse"},"BatchRequestStatusResponseEnum":{"type":"string","enum":["ok","error","parse_error"],"title":"BatchRequestStatusResponseEnum"},"BatchPatchModelResponse":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/BatchRequestStatusResponseEnum"}},"required":["status"],"title":"BatchPatchModelResponse"},"BatchExportFormatEnum":{"type":"string","enum":["xlsx","json"],"title":"BatchExportFormatEnum"},"EmailResultQuality":{"type":"string","enum":["good","bad","risky","unknown"],"title":"EmailResultQuality"},"EmailResultResult":{"type":"string","enum":["ok","invalid","error","unknown"],"title":"EmailResultResult"},"BatchVerificationResultsEmailSerial":{"type":"object","properties":{"email":{"type":"string"},"valid":{"type":"boolean"},"wrong":{"type":"boolean"},"unknown":{"type":"boolean"},"quality":{"$ref":"#/components/schemas/EmailResultQuality"},"result":{"$ref":"#/components/schemas/EmailResultResult"},"is_syntax_error":{"type":"boolean"},"is_free":{"type":"boolean"},"is_role":{"type":"boolean"},"is_disposable":{"type":"boolean"},"is_catch_all":{"type":"boolean"}},"required":["email","valid","wrong","unknown","quality","result","is_syntax_error","is_free","is_role","is_disposable","is_catch_all"],"title":"BatchVerificationResultsEmailSerial"},"PhoneResultNumberType":{"type":"string","enum":["bad_format","mobile","landline","mobile_or_landline","toll_free","premium","shared_cost","voip","stage_and_screen","pager","universal_access_number","personal_number","voicemail_only","msrn","unknown"],"title":"PhoneResultNumberType"},"PhoneResultLiveStatus":{"type":"string","enum":["live","dead","absent_subscriber","no_teleservice_provisioned","not_available_network_only","no_coverage","not_applicable","inconclusive"],"title":"PhoneResultLiveStatus"},"BatchVerificationResultsPhoneSerial":{"type":"object","properties":{"phone":{"type":"string"},"valid":{"type":"boolean"},"wrong":{"type":"boolean"},"unknown":{"type":"boolean"},"type":{"$ref":"#/components/schemas/PhoneResultNumberType"},"status":{"$ref":"#/components/schemas/PhoneResultLiveStatus"},"is_syntax_error":{"type":"boolean"},"is_ported":{"type":"boolean"},"current_network_mcc":{"type":["string","null"]},"current_network_mnc":{"type":["string","null"]},"operator":{"type":["string","null"]}},"required":["phone","valid","wrong","unknown","type","status","is_syntax_error","is_ported"],"title":"BatchVerificationResultsPhoneSerial"},"BatchExportModelResponse":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationResultsEmailSerial"},{"$ref":"#/components/schemas/BatchVerificationResultsPhoneSerial"}],"title":"BatchExportModelResponse"},"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationParsingEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationParsingPhone"}],"title":"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent"},"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationCostEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationCostPhone"}],"title":"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost"},"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationParsingEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationParsingPhone"}],"title":"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent"},"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost":{"oneOf":[{"$ref":"#/components/schemas/BatchSetupVerificationCostEmail"},{"$ref":"#/components/schemas/BatchSetupVerificationCostPhone"}],"title":"V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost"},"Batch_detailsV1BatchBatchUuidDetailsGet_Response_200":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["parsing_content"],"description":"Discriminator value: parsing_content"},"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parameters":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"},{"type":"null"}]}},"required":["status","batch_uuid","name","description","created_at","updated_at"],"description":"parsing_content variant"},{"type":"object","properties":{"status":{"type":"string","enum":["internal_error"],"description":"Discriminator value: internal_error"},"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parameters":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"},{"type":"null"}]}},"required":["status","batch_uuid","name","description","created_at","updated_at"],"description":"internal_error variant"},{"type":"object","properties":{"status":{"type":"string","enum":["ready_for_verification"],"description":"Discriminator value: ready_for_verification"},"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parameters":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"},{"type":"null"}]},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost"}},"required":["status","batch_uuid","name","description","created_at","updated_at","found_content","found_cost"],"description":"ready_for_verification variant"},{"type":"object","properties":{"status":{"type":"string","enum":["verification_ongoing"],"description":"Discriminator value: verification_ongoing"},"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parameters":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"},{"type":"null"}]},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationOngoingFoundCost"}},"required":["status","batch_uuid","name","description","created_at","updated_at","found_content","found_cost"],"description":"verification_ongoing variant"},{"type":"object","properties":{"status":{"type":"string","enum":["verification_done"],"description":"Discriminator value: verification_done"},"batch_uuid":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"parameters":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationParametersModelPayload"},{"type":"null"}]},"found_content":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundContent"},"found_cost":{"$ref":"#/components/schemas/V1BatchBatchUuidDetailsGetResponsesContentApplicationJsonSchemaDiscriminatorMappingVerificationDoneFoundCost"},"stats":{"$ref":"#/components/schemas/VerificationStats"}},"required":["status","batch_uuid","name","description","created_at","updated_at","found_content","found_cost","stats"],"description":"verification_done variant"}],"discriminator":{"propertyName":"status"},"title":"Batch_detailsV1BatchBatchUuidDetailsGet_Response_200"},"UnitVerificationModelPayloadTargetAudience":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23"],"description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators","title":"UnitVerificationModelPayloadTargetAudience"},"UnitVerificationModelPayloadTargetMarketIndustry":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52","53","54","55","56","57","58","59","60","61","62","63","64","65","66","67","68","69","70","71","72","73","74","75","76","77","78","79","80","81","82","83","84","85","86","87","88","89","90","91","92","93","94","95","96","97","98","99","100","101","102","103","104","105","106","107","108","109","110","111","112","113","114","115"],"description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing","title":"UnitVerificationModelPayloadTargetMarketIndustry"},"UnitVerificationModelPayloadTargetObjective":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16"],"description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition","title":"UnitVerificationModelPayloadTargetObjective"},"UnitVerificationModelPayload":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BatchVerificationTypeEnum","description":"Type of verification to apply to the batch."},"target_country":{"$ref":"#/components/schemas/CountryCodeIso2Enum","description":"Country against which the batch should be processed."},"target_audience":{"$ref":"#/components/schemas/UnitVerificationModelPayloadTargetAudience","description":"1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance & Operations Professionals<br>8 = Founders & C-Level Executives<br>9 = Freelancers & Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents & Families<br>20 = Product & Project Managers<br>21 = Real Estate Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 = Students & Educators"},"target_market_industry":{"$ref":"#/components/schemas/UnitVerificationModelPayloadTargetMarketIndustry","description":"1 = Accommodation<br>2 = Accommodation and Food Services<br>3 = Administrative and Support Services<br>4 = Administrative and Support and Waste Management and Remediation Services<br>5 = Agriculture, Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 = Ambulatory Health Care Services<br>8 = Amusement, Gambling, and Recreation Industries<br>9 = Animal Production<br>10 = Apparel Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 = Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except Internet)<br>14 = Building Material and Garden Equipment and Supplies Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing Accessories Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 = Construction<br>19 = Construction of Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation and Related Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting, and Related Services<br>24 = Education and Health Services<br>25 = Educational Services<br>26 = Electrical Equipment, Appliance, and Component Manufacturing<br>27 = Electronics and Appliance Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking Places<br>34 = Food and Beverage Stores<br>35 = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 = Furniture and Related Product Manufacturing<br>39 = Gasoline Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44 = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance Carriers and Related Activities<br>48 = Internet Publishing and Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 = Machinery Manufacturing<br>53 = Management of Companies and Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and Parts Dealers<br>64 = Museums, Historical Sites, and Similar Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 = Other Information Services<br>71 = Other Services (except Public Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 = Pipeline Transportation<br>77 = Plastics and Rubber Products Manufacturing<br>78 = Postal Service<br>79 = Primary Metal Manufacturing<br>80 = Printing and Related Support Activities<br>81 = Private Households<br>82 = Professional and Business Services<br>83 = Professional, Scientific, and Technical Services<br>84 = Publishing Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious, Grantmaking, Civic, Professional, and Similar Organizations<br>89 = Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 = Securities, Commodity Contracts, and Other Financial Investments and Related Activities<br>94 = Service-Providing Industries<br>95 = Social Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture and Forestry<br>99 = Support Activities for Mining<br>100 = Support Activities for Transportation<br>101 = Telecommunications<br>102 = Textile Mills<br>103 = Textile Product Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit and Ground Passenger Transportation<br>106 = Transportation Equipment Manufacturing<br>107 = Transportation and Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and Remediation Services<br>112 = Water Transportation<br>113 = Wholesale Electronic Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 = Wood Product Manufacturing"},"target_objective":{"$ref":"#/components/schemas/UnitVerificationModelPayloadTargetObjective","description":"1 = App Installs / Downloads<br>2 = Audience Building (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 = Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition"},"use_account_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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_cache":{"type":"boolean","default":true,"description":"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_backoff":{"type":"integer","minimum":1,"maximum":180,"default":30,"description":"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."},"unit":{"type":"string","minLength":1,"maxLength":320,"description":"Email, Phone or Address to Verify."}},"required":["type","target_country","unit"],"title":"UnitVerificationModelPayload"},"V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult":{"oneOf":[{"$ref":"#/components/schemas/BatchVerificationResultsEmailSerial"},{"$ref":"#/components/schemas/BatchVerificationResultsPhoneSerial"}],"title":"V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult"},"Unit_post_v1_unit_post_Response_200":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Discriminator value: ok"},"verification_result":{"$ref":"#/components/schemas/V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult"}},"required":["status","verification_result"],"description":"ok variant"},{"type":"object","properties":{"status":{"type":"string","enum":["empty"],"description":"Discriminator value: empty"}},"required":["status"],"description":"empty variant"},{"type":"object","properties":{"status":{"type":"string","enum":["parse_error"],"description":"Discriminator value: parse_error"}},"required":["status"],"description":"parse_error variant"},{"type":"object","properties":{"status":{"type":"string","enum":["error"],"description":"Discriminator value: error"}},"required":["status"],"description":"error variant"}],"discriminator":{"propertyName":"status"},"title":"Unit_post_v1_unit_post_Response_200"},"FormatNormalizationModelResponse":{"type":"object","additionalProperties":{"type":"string"},"title":"FormatNormalizationModelResponse"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}