mailodds 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1b586b3e8c6fbca5bf39745cc8da155ee85611caafe2f23874eb5c5d9db3f42
-  data.tar.gz: 2d9667abec929403174f215df4439b34ed9052a9e70e3b705358bcca2e4b040b
+  metadata.gz: df5ac8671ac5380f8deb9ac57b952a7a141e351834213acb057da74a52c23567
+  data.tar.gz: 1057007574bcafe015dd61ecb8fe4523da89434fc76d5ed85a4d7e8098d38c4b
 SHA512:
-  metadata.gz: 93cd2e171b2a5f57b9d876d048c016100318e5afdfbf3a9b9fd155110dfaa06f39afa3434e9fd684677d44a776d7707c01c250650cba80e7366c3095ddb9786c
-  data.tar.gz: bf50cd160fba3d70a4278d5870b474b2db5506ac358855600e3772b67f2e67ccf54da8c07eff5f8c4b9bfa01c8e4d53859991049ff9b0bf658cd722aabc9bcea
+  metadata.gz: f6b45ff83a93ffbc5d3cb6341250db4d12514930ee6a85ffe4ef60e4841de9ba4a4c781e0ce2fc52801aa6b9817030ee0b3a1eb02b984232c2afe1f8d8bddb11
+  data.tar.gz: a9b38ba562bf131c311dae3dd3e6acbbb1d45e5817ad68f8e120ce2722a5b003a7b47c73e15d017be3babf702b4adebed5f8c104b435d6904f7adc6177ba90fd

data/README.md

@@ -1,64 +1,217 @@
-# MailOdds SDK for Ruby
+# mailodds
 
-Official Ruby client for the [MailOdds Email Validation API](https://mailodds.com/docs).
+Mailodds - the Ruby gem for the MailOdds Email Validation API
+
+MailOdds provides email validation services to help maintain clean email lists 
+and improve deliverability. The API performs multiple validation checks including 
+format verification, domain validation, MX record checking, and disposable email detection.
+
+## Authentication
+
+All API requests require authentication using a Bearer token. Include your API key 
+in the Authorization header:
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+API keys can be created in the MailOdds dashboard.
+
+## Rate Limits
+
+Rate limits vary by plan:
+- Free: 10 requests/minute
+- Starter: 60 requests/minute  
+- Pro: 300 requests/minute
+- Business: 1000 requests/minute
+- Enterprise: Custom limits
+
+## Response Format
+
+All responses include:
+- `schema_version`: API schema version (currently \"1.0\")
+- `request_id`: Unique request identifier for debugging
+
+Error responses include:
+- `error`: Machine-readable error code
+- `message`: Human-readable error description
+
+
+This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: 1.0.0
+- Package version: 1.0.0
+- Generator version: 7.19.0
+- Build package: org.openapitools.codegen.languages.RubyClientCodegen
+For more information, please visit [https://mailodds.com/contact](https://mailodds.com/contact)
 
 ## Installation
 
+### Build a gem
+
+To build the Ruby code into a gem:
+
 ```shell
-gem install mailodds
+gem build mailodds.gemspec
 ```
 
-Or add to your Gemfile:
+Then either install the gem locally:
 
-```ruby
-gem 'mailodds', '~> 1.0'
+```shell
+gem install ./mailodds-1.0.0.gem
 ```
 
-## Quick Start
+(for development, run `gem install --dev ./mailodds-1.0.0.gem` to install the development dependencies)
 
-```ruby
-require 'mailodds'
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
-Mailodds.configure do |config|
-  config.access_token = 'mo_live_your_api_key'
-end
+Finally add this to the Gemfile:
 
-api = Mailodds::EmailValidationApi.new
-request = Mailodds::ValidateRequest.new(email: 'user@example.com')
-result = api.validate_email(request)
-
-case result.action
-when 'accept'
-  puts 'Safe to send'
-when 'accept_with_caution'
-  puts 'Valid but risky -- flag for review'
-when 'reject'
-  puts 'Do not send'
-when 'retry_later'
-  puts 'Temporary failure -- retry after backoff'
-end
+    gem 'mailodds', '~> 1.0.0'
+
+### Install from Git
+
+If the Ruby gem is hosted at a git repository: https://github.com/mailodds/ruby-sdk, then add the following in the Gemfile:
+
+    gem 'mailodds', :git => 'https://github.com/mailodds/ruby-sdk.git'
+
+### Include the Ruby code directly
+
+Include the Ruby code directly using `-I` as follows:
+
+```shell
+ruby -Ilib script.rb
 ```
 
-## Response Handling
+## Getting Started
 
-Branch on the `action` field for decisioning:
+Please follow the [installation](#installation) procedure and then run the following code:
 
-| Action | Meaning | Recommended |
-|--------|---------|-------------|
-| `accept` | Safe to send | Add to mailing list |
-| `accept_with_caution` | Valid but risky (catch-all, role account) | Flag for review |
-| `reject` | Invalid or disposable | Do not send |
-| `retry_later` | Temporary failure | Retry after backoff |
+```ruby
+# Load the gem
+require 'mailodds'
 
-## Test Mode
+# Setup authorization
+Mailodds.configure do |config|
+  # Configure Bearer authorization: BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+  # Configure a proc to get access tokens in lieu of the static access_token configuration
+  config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' } 
+end
 
-Use an `mo_test_` prefixed API key with test domains for predictable responses without consuming credits.
+api_instance = Mailodds::BulkValidationApi.new
+job_id = 'job_id_example' # String | 
 
-## API Reference
+begin
+  #Cancel a job
+  result = api_instance.cancel_job(job_id)
+  p result
+rescue Mailodds::ApiError => e
+  puts "Exception when calling BulkValidationApi->cancel_job: #{e}"
+end
 
-Full API documentation: https://mailodds.com/docs
-OpenAPI spec: https://mailodds.com/openapi.yaml
+```
 
-## License
+## Documentation for API Endpoints
+
+All URIs are relative to *https://api.mailodds.com/v1*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*Mailodds::BulkValidationApi* | [**cancel_job**](docs/BulkValidationApi.md#cancel_job) | **POST** /v1/jobs/{job_id}/cancel | Cancel a job
+*Mailodds::BulkValidationApi* | [**create_job**](docs/BulkValidationApi.md#create_job) | **POST** /v1/jobs | Create bulk validation job (JSON)
+*Mailodds::BulkValidationApi* | [**create_job_from_s3**](docs/BulkValidationApi.md#create_job_from_s3) | **POST** /v1/jobs/upload/s3 | Create job from S3 upload
+*Mailodds::BulkValidationApi* | [**create_job_upload**](docs/BulkValidationApi.md#create_job_upload) | **POST** /v1/jobs/upload | Create bulk validation job (file upload)
+*Mailodds::BulkValidationApi* | [**delete_job**](docs/BulkValidationApi.md#delete_job) | **DELETE** /v1/jobs/{job_id} | Delete a job
+*Mailodds::BulkValidationApi* | [**get_job**](docs/BulkValidationApi.md#get_job) | **GET** /v1/jobs/{job_id} | Get job status
+*Mailodds::BulkValidationApi* | [**get_job_results**](docs/BulkValidationApi.md#get_job_results) | **GET** /v1/jobs/{job_id}/results | Get job results
+*Mailodds::BulkValidationApi* | [**get_presigned_upload**](docs/BulkValidationApi.md#get_presigned_upload) | **POST** /v1/jobs/upload/presigned | Get S3 presigned upload URL
+*Mailodds::BulkValidationApi* | [**list_jobs**](docs/BulkValidationApi.md#list_jobs) | **GET** /v1/jobs | List validation jobs
+*Mailodds::EmailValidationApi* | [**validate_batch**](docs/EmailValidationApi.md#validate_batch) | **POST** /v1/validate/batch | Validate multiple emails (sync)
+*Mailodds::EmailValidationApi* | [**validate_email**](docs/EmailValidationApi.md#validate_email) | **POST** /v1/validate | Validate single email
+*Mailodds::SuppressionListsApi* | [**add_suppression**](docs/SuppressionListsApi.md#add_suppression) | **POST** /v1/suppression | Add suppression entries
+*Mailodds::SuppressionListsApi* | [**check_suppression**](docs/SuppressionListsApi.md#check_suppression) | **POST** /v1/suppression/check | Check suppression status
+*Mailodds::SuppressionListsApi* | [**get_suppression_stats**](docs/SuppressionListsApi.md#get_suppression_stats) | **GET** /v1/suppression/stats | Get suppression statistics
+*Mailodds::SuppressionListsApi* | [**list_suppression**](docs/SuppressionListsApi.md#list_suppression) | **GET** /v1/suppression | List suppression entries
+*Mailodds::SuppressionListsApi* | [**remove_suppression**](docs/SuppressionListsApi.md#remove_suppression) | **DELETE** /v1/suppression | Remove suppression entries
+*Mailodds::SystemApi* | [**get_telemetry_summary**](docs/SystemApi.md#get_telemetry_summary) | **GET** /v1/telemetry/summary | Get validation telemetry
+*Mailodds::SystemApi* | [**health_check**](docs/SystemApi.md#health_check) | **GET** /health | Health check
+*Mailodds::ValidationPoliciesApi* | [**add_policy_rule**](docs/ValidationPoliciesApi.md#add_policy_rule) | **POST** /v1/policies/{policy_id}/rules | Add rule to policy
+*Mailodds::ValidationPoliciesApi* | [**create_policy**](docs/ValidationPoliciesApi.md#create_policy) | **POST** /v1/policies | Create policy
+*Mailodds::ValidationPoliciesApi* | [**create_policy_from_preset**](docs/ValidationPoliciesApi.md#create_policy_from_preset) | **POST** /v1/policies/from-preset | Create policy from preset
+*Mailodds::ValidationPoliciesApi* | [**delete_policy**](docs/ValidationPoliciesApi.md#delete_policy) | **DELETE** /v1/policies/{policy_id} | Delete policy
+*Mailodds::ValidationPoliciesApi* | [**delete_policy_rule**](docs/ValidationPoliciesApi.md#delete_policy_rule) | **DELETE** /v1/policies/{policy_id}/rules/{rule_id} | Delete rule
+*Mailodds::ValidationPoliciesApi* | [**get_policy**](docs/ValidationPoliciesApi.md#get_policy) | **GET** /v1/policies/{policy_id} | Get policy
+*Mailodds::ValidationPoliciesApi* | [**get_policy_presets**](docs/ValidationPoliciesApi.md#get_policy_presets) | **GET** /v1/policies/presets | Get policy presets
+*Mailodds::ValidationPoliciesApi* | [**list_policies**](docs/ValidationPoliciesApi.md#list_policies) | **GET** /v1/policies | List policies
+*Mailodds::ValidationPoliciesApi* | [**test_policy**](docs/ValidationPoliciesApi.md#test_policy) | **POST** /v1/policies/test | Test policy evaluation
+*Mailodds::ValidationPoliciesApi* | [**update_policy**](docs/ValidationPoliciesApi.md#update_policy) | **PUT** /v1/policies/{policy_id} | Update policy
+
+
+## Documentation for Models
+
+ - [Mailodds::AddPolicyRule201Response](docs/AddPolicyRule201Response.md)
+ - [Mailodds::AddSuppressionRequest](docs/AddSuppressionRequest.md)
+ - [Mailodds::AddSuppressionRequestEntriesInner](docs/AddSuppressionRequestEntriesInner.md)
+ - [Mailodds::AddSuppressionResponse](docs/AddSuppressionResponse.md)
+ - [Mailodds::CheckSuppressionRequest](docs/CheckSuppressionRequest.md)
+ - [Mailodds::CreateJobFromS3Request](docs/CreateJobFromS3Request.md)
+ - [Mailodds::CreateJobRequest](docs/CreateJobRequest.md)
+ - [Mailodds::CreatePolicyFromPresetRequest](docs/CreatePolicyFromPresetRequest.md)
+ - [Mailodds::CreatePolicyRequest](docs/CreatePolicyRequest.md)
+ - [Mailodds::DeleteJob200Response](docs/DeleteJob200Response.md)
+ - [Mailodds::DeletePolicy200Response](docs/DeletePolicy200Response.md)
+ - [Mailodds::DeletePolicyRule200Response](docs/DeletePolicyRule200Response.md)
+ - [Mailodds::ErrorResponse](docs/ErrorResponse.md)
+ - [Mailodds::GetPresignedUploadRequest](docs/GetPresignedUploadRequest.md)
+ - [Mailodds::HealthCheck200Response](docs/HealthCheck200Response.md)
+ - [Mailodds::Job](docs/Job.md)
+ - [Mailodds::JobListResponse](docs/JobListResponse.md)
+ - [Mailodds::JobResponse](docs/JobResponse.md)
+ - [Mailodds::JobSummary](docs/JobSummary.md)
+ - [Mailodds::Pagination](docs/Pagination.md)
+ - [Mailodds::Policy](docs/Policy.md)
+ - [Mailodds::PolicyListResponse](docs/PolicyListResponse.md)
+ - [Mailodds::PolicyListResponseLimits](docs/PolicyListResponseLimits.md)
+ - [Mailodds::PolicyPresetsResponse](docs/PolicyPresetsResponse.md)
+ - [Mailodds::PolicyPresetsResponsePresetsInner](docs/PolicyPresetsResponsePresetsInner.md)
+ - [Mailodds::PolicyResponse](docs/PolicyResponse.md)
+ - [Mailodds::PolicyRule](docs/PolicyRule.md)
+ - [Mailodds::PolicyRuleAction](docs/PolicyRuleAction.md)
+ - [Mailodds::PolicyTestResponse](docs/PolicyTestResponse.md)
+ - [Mailodds::PresignedUploadResponse](docs/PresignedUploadResponse.md)
+ - [Mailodds::PresignedUploadResponseUpload](docs/PresignedUploadResponseUpload.md)
+ - [Mailodds::RemoveSuppression200Response](docs/RemoveSuppression200Response.md)
+ - [Mailodds::RemoveSuppressionRequest](docs/RemoveSuppressionRequest.md)
+ - [Mailodds::ResultsResponse](docs/ResultsResponse.md)
+ - [Mailodds::SuppressionCheckResponse](docs/SuppressionCheckResponse.md)
+ - [Mailodds::SuppressionEntry](docs/SuppressionEntry.md)
+ - [Mailodds::SuppressionListResponse](docs/SuppressionListResponse.md)
+ - [Mailodds::SuppressionStatsResponse](docs/SuppressionStatsResponse.md)
+ - [Mailodds::SuppressionStatsResponseByType](docs/SuppressionStatsResponseByType.md)
+ - [Mailodds::TelemetrySummary](docs/TelemetrySummary.md)
+ - [Mailodds::TelemetrySummaryRates](docs/TelemetrySummaryRates.md)
+ - [Mailodds::TelemetrySummaryTopDomainsInner](docs/TelemetrySummaryTopDomainsInner.md)
+ - [Mailodds::TelemetrySummaryTopReasonsInner](docs/TelemetrySummaryTopReasonsInner.md)
+ - [Mailodds::TelemetrySummaryTotals](docs/TelemetrySummaryTotals.md)
+ - [Mailodds::TestPolicyRequest](docs/TestPolicyRequest.md)
+ - [Mailodds::TestPolicyRequestTestResult](docs/TestPolicyRequestTestResult.md)
+ - [Mailodds::UpdatePolicyRequest](docs/UpdatePolicyRequest.md)
+ - [Mailodds::ValidateBatch200Response](docs/ValidateBatch200Response.md)
+ - [Mailodds::ValidateBatch200ResponseSummary](docs/ValidateBatch200ResponseSummary.md)
+ - [Mailodds::ValidateBatchRequest](docs/ValidateBatchRequest.md)
+ - [Mailodds::ValidateRequest](docs/ValidateRequest.md)
+ - [Mailodds::ValidationResponse](docs/ValidationResponse.md)
+ - [Mailodds::ValidationResponsePolicyApplied](docs/ValidationResponsePolicyApplied.md)
+ - [Mailodds::ValidationResponseSuppressionMatch](docs/ValidationResponseSuppressionMatch.md)
+ - [Mailodds::ValidationResult](docs/ValidationResult.md)
+
+
+## Documentation for Authorization
+
+
+Authentication schemes defined for the API:
+### BearerAuth
+
+- **Type**: Bearer authentication
 
-MIT

data/ci/Dockerfile

@@ -0,0 +1,6 @@
+FROM docker.io/library/ruby:3.3-slim
+RUN apt-get update -qq && apt-get install -y build-essential libcurl4-openssl-dev && rm -rf /var/lib/apt/lists/*
+WORKDIR /sdk
+COPY . .
+RUN gem build mailodds.gemspec && gem install mailodds-*.gem
+CMD ["ruby", "ci/smoke_test.rb"]

data/ci/smoke_test.rb

@@ -0,0 +1,78 @@
+# SDK smoke test -- validates build-from-source and API integration using the SDK client.
+require 'mailodds'
+
+api_key = ENV['MAILODDS_TEST_KEY']
+abort('ERROR: MAILODDS_TEST_KEY not set') if api_key.nil? || api_key.empty?
+
+Mailodds.configure do |c|
+  c.access_token = api_key
+  c.base_path = ''
+end
+
+api = Mailodds::EmailValidationApi.new
+
+$passed = 0
+$failed = 0
+
+def check(label, expected, actual)
+  if expected == actual
+    $passed += 1
+  else
+    $failed += 1
+    puts "  FAIL: #{label} expected=#{expected.inspect} got=#{actual.inspect}"
+  end
+end
+
+cases = [
+  ['test@deliverable.mailodds.com', 'valid', 'accept', nil],
+  ['test@invalid.mailodds.com', 'invalid', 'reject', 'smtp_rejected'],
+  ['test@risky.mailodds.com', 'catch_all', 'accept_with_caution', 'catch_all_detected'],
+  ['test@disposable.mailodds.com', 'do_not_mail', 'reject', 'disposable'],
+  ['test@role.mailodds.com', 'do_not_mail', 'reject', 'role_account'],
+  ['test@timeout.mailodds.com', 'unknown', 'retry_later', 'smtp_unreachable'],
+  ['test@freeprovider.mailodds.com', 'valid', 'accept', nil],
+]
+
+cases.each do |email, exp_status, exp_action, exp_sub|
+  domain = email.split('@')[1].split('.')[0]
+  begin
+    req = Mailodds::ValidateRequest.new(email: email)
+    resp = api.validate_email(req)
+    check("#{domain}.status", exp_status, resp.status)
+    check("#{domain}.action", exp_action, resp.action)
+    check("#{domain}.sub_status", exp_sub, resp.sub_status)
+  rescue => e
+    $failed += 1
+    puts "  FAIL: #{domain} #{e.class}: #{e.message}"
+  end
+end
+
+# Error handling: 401 with bad key
+begin
+  bad_config = Mailodds::Configuration.new { |c| c.access_token = 'invalid_key'; c.base_path = '' }
+  bad_api = Mailodds::EmailValidationApi.new(Mailodds::ApiClient.new(bad_config))
+  bad_api.validate_email(Mailodds::ValidateRequest.new(email: 'test@deliverable.mailodds.com'))
+  $failed += 1
+  puts '  FAIL: error.401 no exception raised'
+rescue Mailodds::ApiError => e
+  check('error.401', 401, e.code)
+end
+
+# Error handling: 400/422 with missing email
+begin
+  api.validate_email(Mailodds::ValidateRequest.new(email: ''))
+  $failed += 1
+  puts '  FAIL: error.400 no exception raised'
+rescue Mailodds::ApiError => e
+  if [400, 422].include?(e.code)
+    $passed += 1
+  else
+    $failed += 1
+    puts "  FAIL: error.400 expected=400|422 got=#{e.code}"
+  end
+end
+
+total = $passed + $failed
+result = $failed == 0 ? 'PASS' : 'FAIL'
+puts "\n#{result}: Ruby SDK (#{$passed}/#{total})"
+exit($failed == 0 ? 0 : 1)

data/docs/EmailValidationApi.md

@@ -4,9 +4,79 @@ All URIs are relative to *https://api.mailodds.com/v1*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**validate_batch**](EmailValidationApi.md#validate_batch) | **POST** /v1/validate/batch | Validate multiple emails (sync) |
 | [**validate_email**](EmailValidationApi.md#validate_email) | **POST** /v1/validate | Validate single email |
 
 
+## validate_batch
+
+> <ValidateBatch200Response> validate_batch(validate_batch_request)
+
+Validate multiple emails (sync)
+
+Validate up to 100 email addresses synchronously. For larger lists, use the bulk jobs API.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mailodds'
+# setup authorization
+Mailodds.configure do |config|
+  # Configure Bearer authorization: BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mailodds::EmailValidationApi.new
+validate_batch_request = Mailodds::ValidateBatchRequest.new({emails: ['emails_example']}) # ValidateBatchRequest | 
+
+begin
+  # Validate multiple emails (sync)
+  result = api_instance.validate_batch(validate_batch_request)
+  p result
+rescue Mailodds::ApiError => e
+  puts "Error when calling EmailValidationApi->validate_batch: #{e}"
+end
+```
+
+#### Using the validate_batch_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ValidateBatch200Response>, Integer, Hash)> validate_batch_with_http_info(validate_batch_request)
+
+```ruby
+begin
+  # Validate multiple emails (sync)
+  data, status_code, headers = api_instance.validate_batch_with_http_info(validate_batch_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ValidateBatch200Response>
+rescue Mailodds::ApiError => e
+  puts "Error when calling EmailValidationApi->validate_batch_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **validate_batch_request** | [**ValidateBatchRequest**](ValidateBatchRequest.md) |  |  |
+
+### Return type
+
+[**ValidateBatch200Response**](ValidateBatch200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## validate_email
 
 > <ValidationResponse> validate_email(validate_request)

data/docs/ErrorResponse.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **schema_version** | **String** |  | [optional] |
 | **error** | **String** | Machine-readable error code |  |
-| **message** | **String** | Human-readable error message |  |
+| **message** | **String** | Human-readable error message | [optional] |
 
 ## Example
 

data/docs/ValidateBatch200Response.md

@@ -0,0 +1,24 @@
+# Mailodds::ValidateBatch200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **schema_version** | **String** |  | [optional] |
+| **total** | **Integer** |  | [optional] |
+| **summary** | [**ValidateBatch200ResponseSummary**](ValidateBatch200ResponseSummary.md) |  | [optional] |
+| **results** | [**Array<ValidationResponse>**](ValidationResponse.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'mailodds'
+
+instance = Mailodds::ValidateBatch200Response.new(
+  schema_version: null,
+  total: null,
+  summary: null,
+  results: null
+)
+```
+

data/docs/ValidateBatch200ResponseSummary.md

@@ -0,0 +1,26 @@
+# Mailodds::ValidateBatch200ResponseSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **valid** | **Integer** |  | [optional] |
+| **invalid** | **Integer** |  | [optional] |
+| **catch_all** | **Integer** |  | [optional] |
+| **unknown** | **Integer** |  | [optional] |
+| **do_not_mail** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'mailodds'
+
+instance = Mailodds::ValidateBatch200ResponseSummary.new(
+  valid: null,
+  invalid: null,
+  catch_all: null,
+  unknown: null,
+  do_not_mail: null
+)
+```
+

data/docs/ValidateBatchRequest.md

@@ -0,0 +1,22 @@
+# Mailodds::ValidateBatchRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **emails** | **Array<String>** | List of emails to validate |  |
+| **depth** | **String** |  | [optional][default to 'enhanced'] |
+| **policy_id** | **Integer** | Optional policy ID | [optional] |
+
+## Example
+
+```ruby
+require 'mailodds'
+
+instance = Mailodds::ValidateBatchRequest.new(
+  emails: null,
+  depth: null,
+  policy_id: null
+)
+```
+

data/docs/ValidateRequest.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **email** | **String** | Email address to validate |  |
+| **depth** | **String** | Validation depth. 'standard' skips SMTP verification. | [optional][default to 'enhanced'] |
 | **policy_id** | **Integer** | Optional policy ID to use instead of default policy | [optional] |
 
 ## Example
@@ -14,6 +15,7 @@ require 'mailodds'
 
 instance = Mailodds::ValidateRequest.new(
   email: null,
+  depth: null,
   policy_id: null
 )
 ```

data/docs/ValidationResponse.md

@@ -4,18 +4,25 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **schema_version** | **String** |  | [optional] |
+| **schema_version** | **String** |  |  |
 | **email** | **String** |  |  |
 | **status** | **String** | Validation status |  |
-| **sub_status** | **String** | Detailed status reason | [optional] |
 | **action** | **String** | Recommended action |  |
-| **domain** | **String** |  | [optional] |
-| **mx_found** | **Boolean** |  | [optional] |
-| **smtp_check** | **Boolean** |  | [optional] |
-| **disposable** | **Boolean** |  | [optional] |
-| **role_account** | **Boolean** |  | [optional] |
-| **free_provider** | **Boolean** |  | [optional] |
+| **sub_status** | **String** | Detailed status reason. Omitted when none. | [optional] |
+| **domain** | **String** |  |  |
+| **mx_found** | **Boolean** | Whether MX records were found for the domain |  |
+| **mx_host** | **String** | Primary MX hostname. Omitted when MX not resolved. | [optional] |
+| **smtp_check** | **Boolean** | Whether SMTP verification passed. Omitted when SMTP not checked. | [optional] |
+| **catch_all** | **Boolean** | Whether domain is catch-all. Omitted when SMTP not checked. | [optional] |
+| **disposable** | **Boolean** | Whether domain is a known disposable email provider |  |
+| **role_account** | **Boolean** | Whether address is a role account (e.g., info@, admin@) |  |
+| **free_provider** | **Boolean** | Whether domain is a known free email provider (e.g., gmail.com) |  |
+| **depth** | **String** | Validation depth used for this check |  |
+| **processed_at** | **Time** | ISO 8601 timestamp of validation |  |
+| **suggested_email** | **String** | Typo correction suggestion. Omitted when no typo detected. | [optional] |
+| **retry_after_ms** | **Integer** | Suggested retry delay in milliseconds. Present only for retry_later action. | [optional] |
 | **suppression_match** | [**ValidationResponseSuppressionMatch**](ValidationResponseSuppressionMatch.md) |  | [optional] |
+| **policy_applied** | [**ValidationResponsePolicyApplied**](ValidationResponsePolicyApplied.md) |  | [optional] |
 
 ## Example
 
@@ -26,15 +33,22 @@ instance = Mailodds::ValidationResponse.new(
   schema_version: 1.0,
   email: null,
   status: null,
-  sub_status: null,
   action: null,
+  sub_status: null,
   domain: null,
   mx_found: null,
+  mx_host: null,
   smtp_check: null,
+  catch_all: null,
   disposable: null,
   role_account: null,
   free_provider: null,
-  suppression_match: null
+  depth: null,
+  processed_at: null,
+  suggested_email: null,
+  retry_after_ms: null,
+  suppression_match: null,
+  policy_applied: null
 )
 ```
 

data/docs/ValidationResponsePolicyApplied.md

@@ -0,0 +1,24 @@
+# Mailodds::ValidationResponsePolicyApplied
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **policy_id** | **Integer** |  | [optional] |
+| **policy_name** | **String** |  | [optional] |
+| **rule_id** | **Integer** |  | [optional] |
+| **rule_type** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'mailodds'
+
+instance = Mailodds::ValidationResponsePolicyApplied.new(
+  policy_id: null,
+  policy_name: null,
+  rule_id: null,
+  rule_type: null
+)
+```
+

data/docs/ValidationResponseSuppressionMatch.md

@@ -4,9 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **matched** | **Boolean** |  | [optional] |
 | **match_type** | **String** |  | [optional] |
 | **match_value** | **String** |  | [optional] |
+| **reason** | **String** |  | [optional] |
 
 ## Example
 
@@ -14,9 +14,9 @@
 require 'mailodds'
 
 instance = Mailodds::ValidationResponseSuppressionMatch.new(
-  matched: null,
   match_type: null,
-  match_value: null
+  match_value: null,
+  reason: null
 )
 ```
 

data/git_push.sh

@@ -14,12 +14,12 @@ if [ "$git_host" = "" ]; then
 fi
 
 if [ "$git_user_id" = "" ]; then
-    git_user_id="mailodds"
+    git_user_id="GIT_USER_ID"
     echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
 fi
 
 if [ "$git_repo_id" = "" ]; then
-    git_repo_id="ruby-sdk"
+    git_repo_id="GIT_REPO_ID"
     echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
 fi