@opusdns/api 0.157.0 → 0.158.0

package/package.json

@@ -3,7 +3,7 @@
     "@opusdns/api-spec-ts-generator": "^0.19.0"
   },
   "name": "@opusdns/api",
-  "version": "0.157.0",
+  "version": "0.158.0",
   "description": "TypeScript types for the OpusDNS OpenAPI specification",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/helpers/constants.ts

@@ -21,7 +21,7 @@
  * ```
  */
 
-import { AllocationMethodType, AttributeType, BillingTransactionAction, BillingTransactionProductType, BillingTransactionSortField, BillingTransactionStatus, ContactSortField, Currency, DeletePolicyType, DnsChangeAction, DnsRrsetType, DnssecAlgorithm, DnssecDigestType, DnssecModeType, DnssecRecordType, DnssecStatus, DomainAttributeKey, DomainAvailabilityStatus, DomainClientStatus, DomainContactType, DomainForwardSortField, DomainForwardZoneSortField, DomainSortField, DomainStatus, EmailForwardLogFinalStatus, EmailForwardLogSortField, EmailForwardSortField, EmailForwardZoneSortField, EmailVerificationStatus, EventObjectType, EventSortField, EventSubtype, EventType, GrantType, HostStatus, HttpProtocol, InvoiceResponsePaymentStatus, InvoiceResponseStatus, InvoiceResponseType, LaunchPhaseType, LocalPresenceRequirementType, MetricsGrouping, ObjectEventType, ObjectLogSortField, OrganizationStatus, PatchOp, PeriodUnit, Permission, PostTransferRequirements, PostalAddressType, PremiumAffectsType, PremiumSourceType, Protocol, RedirectCode, RegistrantChangeType, RegistryHandleAttributeType, Relation, RenewalMode, RequestHistorySortField, ReservedSourceType, SortOrder, SyncOperationType, TLDType, TimeRange, TransferAckType, UserStatus, VerificationType, ZoneSortField } from './schemas';
+import { AllocationMethodType, AttributeType, BillingTransactionAction, BillingTransactionProductType, BillingTransactionSortField, BillingTransactionStatus, ContactSortField, Currency, DeletePolicyType, DnsChangeAction, DnsRrsetType, DnssecAlgorithm, DnssecDigestType, DnssecModeType, DnssecRecordType, DnssecStatus, DomainAttributeKey, DomainAvailabilityStatus, DomainClientStatus, DomainContactType, DomainForwardSortField, DomainForwardZoneSortField, DomainSortField, DomainStatus, EmailForwardLogSortField, EmailForwardLogStatus, EmailForwardSortField, EmailForwardZoneSortField, EmailVerificationStatus, EventObjectType, EventSortField, EventSubtype, EventType, GrantType, HostStatus, HttpProtocol, InvoiceResponsePaymentStatus, InvoiceResponseStatus, InvoiceResponseType, LaunchPhaseType, LocalPresenceRequirementType, MetricsGrouping, ObjectEventType, ObjectLogSortField, OrganizationStatus, PatchOp, PeriodUnit, Permission, PostTransferRequirements, PostalAddressType, PremiumAffectsType, PremiumSourceType, Protocol, RedirectCode, RegistrantChangeType, RegistryHandleAttributeType, Relation, RenewalMode, RequestHistorySortField, ReservedSourceType, SortOrder, SyncOperationType, TLDType, TimeRange, TransferAckType, UserStatus, VerificationType, ZoneSortField } from './schemas';
 
 /**
  * AllocationMethodType. Auto-generated enum for AllocationMethodType
@@ -1340,120 +1340,120 @@ export const DOMAIN_STATUS_VALUES = [
 ] as const satisfies [string, ...string[]] | DomainStatus[];
 
 /**
- * EmailForwardLogFinalStatus. Auto-generated enum for EmailForwardLogFinalStatus
+ * EmailForwardLogSortField. Auto-generated enum for EmailForwardLogSortField
  *
  * @remarks
- * This constant provides both object and array forms for the EmailForwardLogFinalStatus enum.
+ * This constant provides both object and array forms for the EmailForwardLogSortField enum.
  * The object form allows key-value access, while the array form enables iteration and validation.
  *
  * @example
  * ```typescript
  * // Using the object form for key-value access
- * const status = EMAIL_FORWARD_LOG_FINAL_STATUS.SUCCESS;
+ * const status = EMAIL_FORWARD_LOG_SORT_FIELD.SUCCESS;
  * 
  * // Using the array form for iteration
- * const allStatuses = EMAIL_FORWARD_LOG_FINAL_STATUS_VALUES;
+ * const allStatuses = EMAIL_FORWARD_LOG_SORT_FIELD_VALUES;
  * console.log(`Available statuses: ${allStatuses.join(', ')}`);
  * ```
  *
- * @see {@link EmailForwardLogFinalStatus} - The TypeScript type definition
+ * @see {@link EmailForwardLogSortField} - The TypeScript type definition
  */
-export const EMAIL_FORWARD_LOG_FINAL_STATUS = {
-  QUEUED: "QUEUED",
-  DELIVERED: "DELIVERED",
-  REFUSED: "REFUSED",
-  SOFT_BOUNCE: "SOFT-BOUNCE",
-  HARD_BOUNCE: "HARD-BOUNCE",
-} as const satisfies Record<string, EmailForwardLogFinalStatus>;
+export const EMAIL_FORWARD_LOG_SORT_FIELD = {
+  LOG_ID: "log_id",
+  SENDER_EMAIL: "sender_email",
+  RECIPIENT_EMAIL: "recipient_email",
+  FORWARD_EMAIL: "forward_email",
+  FINAL_STATUS: "final_status",
+  CREATED_ON: "created_on",
+  SYNCED_ON: "synced_on",
+} as const satisfies Record<string, EmailForwardLogSortField>;
 
 /**
- * Array of all EmailForwardLogFinalStatus enum values
+ * Array of all EmailForwardLogSortField enum values
  *
  * @remarks
- * This constant provides a array containing all valid EmailForwardLogFinalStatus enum values.
+ * This constant provides a array containing all valid EmailForwardLogSortField enum values.
  * Useful for iteration, validation, and generating dynamic UI components.
  *
  * @example
  * ```typescript
  * // Iterating through all values
- * for (const value of EMAIL_FORWARD_LOG_FINAL_STATUS_VALUES) {
+ * for (const value of EMAIL_FORWARD_LOG_SORT_FIELD_VALUES) {
  *   console.log(`Processing: ${value}`);
  * }
  * 
  * // Validation
- * const isValid = EMAIL_FORWARD_LOG_FINAL_STATUS_VALUES.includes(someValue);
+ * const isValid = EMAIL_FORWARD_LOG_SORT_FIELD_VALUES.includes(someValue);
  * ```
  *
- * @see {@link EmailForwardLogFinalStatus} - The TypeScript type definition
- * @see {@link EMAIL_FORWARD_LOG_FINAL_STATUS} - The object form of this enum
+ * @see {@link EmailForwardLogSortField} - The TypeScript type definition
+ * @see {@link EMAIL_FORWARD_LOG_SORT_FIELD} - The object form of this enum
  */
-export const EMAIL_FORWARD_LOG_FINAL_STATUS_VALUES = [
-  'QUEUED',
-  'DELIVERED',
-  'REFUSED',
-  'SOFT-BOUNCE',
-  'HARD-BOUNCE'
-] as const satisfies [string, ...string[]] | EmailForwardLogFinalStatus[];
+export const EMAIL_FORWARD_LOG_SORT_FIELD_VALUES = [
+  'log_id',
+  'sender_email',
+  'recipient_email',
+  'forward_email',
+  'final_status',
+  'created_on',
+  'synced_on'
+] as const satisfies [string, ...string[]] | EmailForwardLogSortField[];
 
 /**
- * EmailForwardLogSortField. Auto-generated enum for EmailForwardLogSortField
+ * EmailForwardLogStatus. Auto-generated enum for EmailForwardLogStatus
  *
  * @remarks
- * This constant provides both object and array forms for the EmailForwardLogSortField enum.
+ * This constant provides both object and array forms for the EmailForwardLogStatus enum.
  * The object form allows key-value access, while the array form enables iteration and validation.
  *
  * @example
  * ```typescript
  * // Using the object form for key-value access
- * const status = EMAIL_FORWARD_LOG_SORT_FIELD.SUCCESS;
+ * const status = EMAIL_FORWARD_LOG_STATUS.SUCCESS;
  * 
  * // Using the array form for iteration
- * const allStatuses = EMAIL_FORWARD_LOG_SORT_FIELD_VALUES;
+ * const allStatuses = EMAIL_FORWARD_LOG_STATUS_VALUES;
  * console.log(`Available statuses: ${allStatuses.join(', ')}`);
  * ```
  *
- * @see {@link EmailForwardLogSortField} - The TypeScript type definition
+ * @see {@link EmailForwardLogStatus} - The TypeScript type definition
  */
-export const EMAIL_FORWARD_LOG_SORT_FIELD = {
-  LOG_ID: "log_id",
-  SENDER_EMAIL: "sender_email",
-  RECIPIENT_EMAIL: "recipient_email",
-  FORWARD_EMAIL: "forward_email",
-  FINAL_STATUS: "final_status",
-  CREATED_ON: "created_on",
-  SYNCED_ON: "synced_on",
-} as const satisfies Record<string, EmailForwardLogSortField>;
+export const EMAIL_FORWARD_LOG_STATUS = {
+  QUEUED: "QUEUED",
+  DELIVERED: "DELIVERED",
+  REFUSED: "REFUSED",
+  SOFT_BOUNCE: "SOFT-BOUNCE",
+  HARD_BOUNCE: "HARD-BOUNCE",
+} as const satisfies Record<string, EmailForwardLogStatus>;
 
 /**
- * Array of all EmailForwardLogSortField enum values
+ * Array of all EmailForwardLogStatus enum values
  *
  * @remarks
- * This constant provides a array containing all valid EmailForwardLogSortField enum values.
+ * This constant provides a array containing all valid EmailForwardLogStatus enum values.
  * Useful for iteration, validation, and generating dynamic UI components.
  *
  * @example
  * ```typescript
  * // Iterating through all values
- * for (const value of EMAIL_FORWARD_LOG_SORT_FIELD_VALUES) {
+ * for (const value of EMAIL_FORWARD_LOG_STATUS_VALUES) {
  *   console.log(`Processing: ${value}`);
  * }
  * 
  * // Validation
- * const isValid = EMAIL_FORWARD_LOG_SORT_FIELD_VALUES.includes(someValue);
+ * const isValid = EMAIL_FORWARD_LOG_STATUS_VALUES.includes(someValue);
  * ```
  *
- * @see {@link EmailForwardLogSortField} - The TypeScript type definition
- * @see {@link EMAIL_FORWARD_LOG_SORT_FIELD} - The object form of this enum
+ * @see {@link EmailForwardLogStatus} - The TypeScript type definition
+ * @see {@link EMAIL_FORWARD_LOG_STATUS} - The object form of this enum
  */
-export const EMAIL_FORWARD_LOG_SORT_FIELD_VALUES = [
-  'log_id',
-  'sender_email',
-  'recipient_email',
-  'forward_email',
-  'final_status',
-  'created_on',
-  'synced_on'
-] as const satisfies [string, ...string[]] | EmailForwardLogSortField[];
+export const EMAIL_FORWARD_LOG_STATUS_VALUES = [
+  'QUEUED',
+  'DELIVERED',
+  'REFUSED',
+  'SOFT-BOUNCE',
+  'HARD-BOUNCE'
+] as const satisfies [string, ...string[]] | EmailForwardLogStatus[];
 
 /**
  * EmailForwardSortField. Auto-generated enum for EmailForwardSortField

package/src/helpers/keys.ts

@@ -119,6 +119,9 @@ import { EmailForwardAliasUpdate } from './schemas';
 import { EmailForwardCreate } from './schemas';
 import { EmailForwardLog } from './schemas';
 import { EmailForwardLogEvent } from './schemas';
+import { EmailForwardMetrics } from './schemas';
+import { EmailForwardMetricsFilters } from './schemas';
+import { EmailForwardMetricsRates } from './schemas';
 import { EmailForward } from './schemas';
 import { EmailForwardZone } from './schemas';
 import { EventResponse } from './schemas';
@@ -11562,11 +11565,10 @@ export const KEY_EMAIL_FORWARD_LOG_DOMAIN: keyof EmailForwardLog = 'domain';
  */
 export const KEY_EMAIL_FORWARD_LOG_EVENTS: keyof EmailForwardLog = 'events';
 /**
- * Final Status
+ * final_status property
  *
  * Final status of the email (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE, HARD-BOUNCE)
  *
- * @type {string}
  *
  *
  * @remarks
@@ -12149,6 +12151,371 @@ export const KEYS_EMAIL_FORWARD_LOG_EVENT = [
   KEY_EMAIL_FORWARD_LOG_EVENT_STATUS,
 ] as const satisfies (keyof EmailForwardLogEvent)[];
 
+/**
+ * By Status
+ *
+ * Log counts grouped by status (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE, HARD-BOUNCE)
+ *
+ * @type {object}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `by_status` property of EmailForwardMetrics objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetrics[KEY_EMAIL_FORWARD_METRICS_BY_STATUS];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_BY_STATUS;
+ * const value = emailforwardmetrics[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetrics} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_BY_STATUS: keyof EmailForwardMetrics = 'by_status';
+/**
+ * filters property
+ *
+ * Applied filters
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `filters` property of EmailForwardMetrics objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetrics[KEY_EMAIL_FORWARD_METRICS_FILTERS];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_FILTERS;
+ * const value = emailforwardmetrics[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetrics} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_FILTERS: keyof EmailForwardMetrics = 'filters';
+/**
+ * rates property
+ *
+ * Rate percentages for each status
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `rates` property of EmailForwardMetrics objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetrics[KEY_EMAIL_FORWARD_METRICS_RATES];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_RATES;
+ * const value = emailforwardmetrics[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetrics} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_RATES: keyof EmailForwardMetrics = 'rates';
+/**
+ * Total Logs
+ *
+ * Total number of email forward logs
+ *
+ * @type {integer}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `total_logs` property of EmailForwardMetrics objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetrics[KEY_EMAIL_FORWARD_METRICS_TOTAL_LOGS];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_TOTAL_LOGS;
+ * const value = emailforwardmetrics[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetrics} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_TOTAL_LOGS: keyof EmailForwardMetrics = 'total_logs';
+
+/**
+ * Array of all EmailForwardMetrics property keys
+ *
+ * @remarks
+ * This constant provides a readonly array containing all valid property keys for EmailForwardMetrics objects.
+ * Useful for iteration, validation, and generating dynamic UI components.
+ *
+ * @example
+ * ```typescript
+ * // Iterating through all keys
+ * for (const key of KEYS_EMAIL_FORWARD_METRICS) {
+ *   console.log(`Property: ${key}, Value: ${emailforwardmetrics[key]}`);
+ * }
+ * 
+ * // Validation
+ * const isValidKey = KEYS_EMAIL_FORWARD_METRICS.includes(someKey);
+ * ```
+ *
+ * @see {@link EmailForwardMetrics} - The TypeScript type definition
+ */
+export const KEYS_EMAIL_FORWARD_METRICS = [
+  KEY_EMAIL_FORWARD_METRICS_BY_STATUS,
+  KEY_EMAIL_FORWARD_METRICS_FILTERS,
+  KEY_EMAIL_FORWARD_METRICS_RATES,
+  KEY_EMAIL_FORWARD_METRICS_TOTAL_LOGS,
+] as const satisfies (keyof EmailForwardMetrics)[];
+
+/**
+ * Domain
+ *
+ * Domain name
+ *
+ * @type {string}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `domain` property of EmailForwardMetricsFilters objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsfilters[KEY_EMAIL_FORWARD_METRICS_FILTERS_DOMAIN];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_FILTERS_DOMAIN;
+ * const value = emailforwardmetricsfilters[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsFilters} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_FILTERS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_FILTERS_DOMAIN: keyof EmailForwardMetricsFilters = 'domain';
+/**
+ * End Time
+ *
+ * End time filter (RFC3339)
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `end_time` property of EmailForwardMetricsFilters objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsfilters[KEY_EMAIL_FORWARD_METRICS_FILTERS_END_TIME];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_FILTERS_END_TIME;
+ * const value = emailforwardmetricsfilters[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsFilters} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_FILTERS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_FILTERS_END_TIME: keyof EmailForwardMetricsFilters = 'end_time';
+/**
+ * Start Time
+ *
+ * Start time filter (RFC3339)
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `start_time` property of EmailForwardMetricsFilters objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsfilters[KEY_EMAIL_FORWARD_METRICS_FILTERS_START_TIME];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_FILTERS_START_TIME;
+ * const value = emailforwardmetricsfilters[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsFilters} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_FILTERS} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_FILTERS_START_TIME: keyof EmailForwardMetricsFilters = 'start_time';
+
+/**
+ * Array of all EmailForwardMetricsFilters property keys
+ *
+ * @remarks
+ * This constant provides a readonly array containing all valid property keys for EmailForwardMetricsFilters objects.
+ * Useful for iteration, validation, and generating dynamic UI components.
+ *
+ * @example
+ * ```typescript
+ * // Iterating through all keys
+ * for (const key of KEYS_EMAIL_FORWARD_METRICS_FILTERS) {
+ *   console.log(`Property: ${key}, Value: ${emailforwardmetricsfilters[key]}`);
+ * }
+ * 
+ * // Validation
+ * const isValidKey = KEYS_EMAIL_FORWARD_METRICS_FILTERS.includes(someKey);
+ * ```
+ *
+ * @see {@link EmailForwardMetricsFilters} - The TypeScript type definition
+ */
+export const KEYS_EMAIL_FORWARD_METRICS_FILTERS = [
+  KEY_EMAIL_FORWARD_METRICS_FILTERS_DOMAIN,
+  KEY_EMAIL_FORWARD_METRICS_FILTERS_END_TIME,
+  KEY_EMAIL_FORWARD_METRICS_FILTERS_START_TIME,
+] as const satisfies (keyof EmailForwardMetricsFilters)[];
+
+/**
+ * Delivered
+ *
+ * Delivery rate percentage
+ *
+ * @type {number}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `delivered` property of EmailForwardMetricsRates objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsrates[KEY_EMAIL_FORWARD_METRICS_RATES_DELIVERED];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_RATES_DELIVERED;
+ * const value = emailforwardmetricsrates[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsRates} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_RATES} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_RATES_DELIVERED: keyof EmailForwardMetricsRates = 'delivered';
+/**
+ * Hard Bounce
+ *
+ * Hard bounce rate percentage
+ *
+ * @type {number}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `hard_bounce` property of EmailForwardMetricsRates objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsrates[KEY_EMAIL_FORWARD_METRICS_RATES_HARD_BOUNCE];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_RATES_HARD_BOUNCE;
+ * const value = emailforwardmetricsrates[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsRates} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_RATES} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_RATES_HARD_BOUNCE: keyof EmailForwardMetricsRates = 'hard_bounce';
+/**
+ * Refused
+ *
+ * Refused rate percentage
+ *
+ * @type {number}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `refused` property of EmailForwardMetricsRates objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsrates[KEY_EMAIL_FORWARD_METRICS_RATES_REFUSED];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_RATES_REFUSED;
+ * const value = emailforwardmetricsrates[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsRates} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_RATES} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_RATES_REFUSED: keyof EmailForwardMetricsRates = 'refused';
+/**
+ * Soft Bounce
+ *
+ * Soft bounce rate percentage
+ *
+ * @type {number}
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `soft_bounce` property of EmailForwardMetricsRates objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = emailforwardmetricsrates[KEY_EMAIL_FORWARD_METRICS_RATES_SOFT_BOUNCE];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_EMAIL_FORWARD_METRICS_RATES_SOFT_BOUNCE;
+ * const value = emailforwardmetricsrates[propertyName];
+ * ```
+ *
+ * @see {@link EmailForwardMetricsRates} - The TypeScript type definition
+ * @see {@link KEYS_EMAIL_FORWARD_METRICS_RATES} - Array of all keys for this type
+ */
+export const KEY_EMAIL_FORWARD_METRICS_RATES_SOFT_BOUNCE: keyof EmailForwardMetricsRates = 'soft_bounce';
+
+/**
+ * Array of all EmailForwardMetricsRates property keys
+ *
+ * @remarks
+ * This constant provides a readonly array containing all valid property keys for EmailForwardMetricsRates objects.
+ * Useful for iteration, validation, and generating dynamic UI components.
+ *
+ * @example
+ * ```typescript
+ * // Iterating through all keys
+ * for (const key of KEYS_EMAIL_FORWARD_METRICS_RATES) {
+ *   console.log(`Property: ${key}, Value: ${emailforwardmetricsrates[key]}`);
+ * }
+ * 
+ * // Validation
+ * const isValidKey = KEYS_EMAIL_FORWARD_METRICS_RATES.includes(someKey);
+ * ```
+ *
+ * @see {@link EmailForwardMetricsRates} - The TypeScript type definition
+ */
+export const KEYS_EMAIL_FORWARD_METRICS_RATES = [
+  KEY_EMAIL_FORWARD_METRICS_RATES_DELIVERED,
+  KEY_EMAIL_FORWARD_METRICS_RATES_HARD_BOUNCE,
+  KEY_EMAIL_FORWARD_METRICS_RATES_REFUSED,
+  KEY_EMAIL_FORWARD_METRICS_RATES_SOFT_BOUNCE,
+] as const satisfies (keyof EmailForwardMetricsRates)[];
+
 /**
  * Aliases
  *

package/src/helpers/requests.d.ts

@@ -3589,6 +3589,59 @@ export type PATCH_EmailForwardsEmailForwardIdEnable_Request = {
  */
 export type PATCH_EmailForwardsEmailForwardIdEnable_Request_Path = PATCH_EmailForwardsEmailForwardIdEnable_Request['parameters']['path'];
 
+/**
+ * Request type for GET EmailForwardsEmailForwardIdMetrics endpoint
+ *
+ * Retrieve email forward metrics
+ * Retrieves metrics and statistics for a specific email forward, including delivery rates and status counts.
+ *
+ * @remarks
+ * This type defines the complete request structure for the GET EmailForwardsEmailForwardIdMetrics endpoint.
+ * It includes all parameters (query, path) and request body types as defined in the OpenAPI specification.
+ * Use this type to ensure type safety when making API requests to this endpoint.
+ *
+ * @example
+ * Use this type to ensure type safety when making API requests to this endpoint.
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsEmailForwardIdMetrics_Request_Query} - Query parameters type
+ * @see {@link GET_EmailForwardsEmailForwardIdMetrics_Request_Path} - Path parameters type
+ * @see {@link GET_EmailForwardsEmailForwardIdMetrics_Request_Body} - Request body type
+ */
+export type GET_EmailForwardsEmailForwardIdMetrics_Request = {
+  parameters: {
+    query: operations['get_email_forward_metrics_v1_email_forwards__email_forward_id__metrics_get']['parameters']['query'];
+    path: operations['get_email_forward_metrics_v1_email_forwards__email_forward_id__metrics_get']['parameters']['path'];
+  };
+}
+/**
+ * Query parameters for GET /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @remarks
+ * This type defines the query parameters for the GET /v1/email-forwards/{email_forward_id}/metrics endpoint.
+ * It provides type safety for all query parameters as defined in the OpenAPI specification.
+ *
+ * @example
+ * Use this type to ensure type safety for query parameters.
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ */
+export type GET_EmailForwardsEmailForwardIdMetrics_Request_Query = GET_EmailForwardsEmailForwardIdMetrics_Request['parameters']['query'];
+/**
+ * Path parameters for GET /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @remarks
+ * This type defines the path parameters for the GET /v1/email-forwards/{email_forward_id}/metrics endpoint.
+ * It provides type safety for all path parameters as defined in the OpenAPI specification.
+ *
+ * @example
+ * Use this type to ensure type safety for path parameters.
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ */
+export type GET_EmailForwardsEmailForwardIdMetrics_Request_Path = GET_EmailForwardsEmailForwardIdMetrics_Request['parameters']['path'];
+
 /**
  * Request type for GET Events endpoint
  *

package/src/helpers/responses.d.ts

@@ -34,7 +34,7 @@
 
 import { DomainDnssecDataArray, OrganizationAttribute2Array, IpRestrictionArray, TldResponseShortArray } from './schemas-arrays.d';
 
-import { Pagination_EmailForwardLog, HTTPValidationError, Pagination_ObjectLog, Pagination_RequestHistory, Problem, DomainAvailabilityList, Pagination_ContactSchema, ContactSchema, ContactVerification, Contact, Pagination_DnsZone, DnsZone, DnsChanges, DomainForwardZone, EmailForwardZone, Pagination_DomainForwardZone, Pagination_EmailForwardZone, DnsZoneSummary, Pagination_DomainForward, DomainForward, DomainForwardSet, DomainForwardMetrics, DomainForwardBrowserStats, DomainForwardGeoStats, DomainForwardPlatformStats, DomainForwardReferrerStats, DomainForwardStatusCodeStats, DomainForwardMetricsTimeSeries, DomainForwardUserAgentStats, DomainForwardVisitsByKey, DomainSearch, Pagination_Domain, Domain, DomainRenew, DomainRestore, DomainCheck, DomainSummary, DomainWithdraw, RequestAuthcode, DomainTransit, RequestAuthcode2, Pagination_EmailForward, EmailForward, EmailForwardAlias, Pagination_Event, EventSchema, Pagination_Organization, Organization, OrganizationWithBillingData, Pagination_Invoice, GetPrices, Pagination_BillingTransaction, BillingTransaction, IpRestriction, Pagination_UserPublic, TldSpecification, UserPublic, UserPublicWithAttributes, PermissionSet, RelationSet, UserWithRelationPermissions } from './schemas.d';
+import { Pagination_EmailForwardLog, HTTPValidationError, Pagination_ObjectLog, Pagination_RequestHistory, Problem, DomainAvailabilityList, Pagination_ContactSchema, ContactSchema, ContactVerification, Contact, Pagination_DnsZone, DnsZone, DnsChanges, DomainForwardZone, EmailForwardZone, Pagination_DomainForwardZone, Pagination_EmailForwardZone, DnsZoneSummary, Pagination_DomainForward, DomainForward, DomainForwardSet, DomainForwardMetrics, DomainForwardBrowserStats, DomainForwardGeoStats, DomainForwardPlatformStats, DomainForwardReferrerStats, DomainForwardStatusCodeStats, DomainForwardMetricsTimeSeries, DomainForwardUserAgentStats, DomainForwardVisitsByKey, DomainSearch, Pagination_Domain, Domain, DomainRenew, DomainRestore, DomainCheck, DomainSummary, DomainWithdraw, RequestAuthcode, DomainTransit, RequestAuthcode2, Pagination_EmailForward, EmailForward, EmailForwardAlias, EmailForwardMetrics, Pagination_Event, EventSchema, Pagination_Organization, Organization, OrganizationWithBillingData, Pagination_Invoice, GetPrices, Pagination_BillingTransaction, BillingTransaction, IpRestriction, Pagination_UserPublic, TldSpecification, UserPublic, UserPublicWithAttributes, PermissionSet, RelationSet, UserWithRelationPermissions } from './schemas.d';
 
 /**
  * Response types for GET ArchiveEmailForwardLogsAliasesByEmailForwardAliasId endpoint
@@ -6728,6 +6728,116 @@ export type PATCH_EmailForwardsByEmailForwardIdEnable_Response_404 = Problem
  */
 export type PATCH_EmailForwardsByEmailForwardIdEnable_Response_422 = HTTPValidationError
 
+/**
+ * Response types for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * Retrieve email forward metrics
+ * Retrieves metrics and statistics for a specific email forward, including delivery rates and status counts.
+ *
+ * @remarks
+ * This type defines all possible response structures for the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * Each response code maps to a specific response type as defined in the OpenAPI specification.
+ * Use this type to ensure type safety when handling API responses from this endpoint.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response_200} - 200 response type
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response_401} - 401 response type
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response_403} - 403 response type
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response_404} - 404 response type
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response_422} - 422 response type
+ *
+
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response = GET_EmailForwardsByEmailForwardIdMetrics_Response_200 | GET_EmailForwardsByEmailForwardIdMetrics_Response_401 | GET_EmailForwardsByEmailForwardIdMetrics_Response_403 | GET_EmailForwardsByEmailForwardIdMetrics_Response_404 | GET_EmailForwardsByEmailForwardIdMetrics_Response_422;
+
+/**
+ * 200 response for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 200 status code
+ * of the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response} - The main response type definition
+ * @see {@link EmailForwardMetrics} - The actual schema type definition
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response_200 = EmailForwardMetrics
+
+/**
+ * 401 response for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 401 status code
+ * of the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response} - The main response type definition
+ * @see {@link Problem} - The actual schema type definition
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response_401 = Problem
+
+/**
+ * 403 response for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 403 status code
+ * of the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response} - The main response type definition
+ * @see {@link Problem} - The actual schema type definition
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response_403 = Problem
+
+/**
+ * 404 response for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 404 status code
+ * of the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response} - The main response type definition
+ * @see {@link Problem} - The actual schema type definition
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response_404 = Problem
+
+/**
+ * 422 response for GET EmailForwardsByEmailForwardIdMetrics endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 422 status code
+ * of the GET EmailForwardsByEmailForwardIdMetrics endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/email-forwards/{email_forward_id}/metrics
+ *
+ * @see {@link GET_EmailForwardsByEmailForwardIdMetrics_Response} - The main response type definition
+ * @see {@link HTTPValidationError} - The actual schema type definition
+ */
+export type GET_EmailForwardsByEmailForwardIdMetrics_Response_422 = HTTPValidationError
+
 /**
  * Response types for GET Events endpoint
  *

package/src/helpers/schemas.d.ts

@@ -1883,37 +1883,85 @@ export type EmailForwardLog = components['schemas']['EmailForwardLog'];
  */
 export type EmailForwardLogEvent = components['schemas']['EmailForwardLogEvent'];
 /**
- * EmailForwardLogFinalStatus
+ * EmailForwardLogSortField
  *
  * @remarks
- * Type alias for the `EmailForwardLogFinalStatus` OpenAPI schema.
- * This type represents emailforwardlogfinalstatus data structures used in API requests and responses.
+ * Type alias for the `EmailForwardLogSortField` OpenAPI schema.
+ * This type represents emailforwardlogsortfield data structures used in API requests and responses.
  *
  * @example
  * ```typescript
- * const response = await api.getEmailForwardLogFinalStatus();
- * const item: EmailForwardLogFinalStatus = response.results;
+ * const response = await api.getEmailForwardLogSortField();
+ * const item: EmailForwardLogSortField = response.results;
  * ```
  *
  * @see {@link components} - The OpenAPI components schema definition
  */
-export type EmailForwardLogFinalStatus = components['schemas']['EmailForwardLogFinalStatus'];
+export type EmailForwardLogSortField = components['schemas']['EmailForwardLogSortField'];
 /**
- * EmailForwardLogSortField
+ * EmailForwardLogStatus
  *
  * @remarks
- * Type alias for the `EmailForwardLogSortField` OpenAPI schema.
- * This type represents emailforwardlogsortfield data structures used in API requests and responses.
+ * Type alias for the `EmailForwardLogStatus` OpenAPI schema.
+ * This type represents emailforwardlogstatus data structures used in API requests and responses.
  *
  * @example
  * ```typescript
- * const response = await api.getEmailForwardLogSortField();
- * const item: EmailForwardLogSortField = response.results;
+ * const response = await api.getEmailForwardLogStatus();
+ * const item: EmailForwardLogStatus = response.results;
  * ```
  *
  * @see {@link components} - The OpenAPI components schema definition
  */
-export type EmailForwardLogSortField = components['schemas']['EmailForwardLogSortField'];
+export type EmailForwardLogStatus = components['schemas']['EmailForwardLogStatus'];
+/**
+ * EmailForwardMetrics
+ *
+ * @remarks
+ * Type alias for the `EmailForwardMetrics` OpenAPI schema.
+ * This type represents emailforwardmetrics data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getEmailForwardMetrics();
+ * const item: EmailForwardMetrics = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type EmailForwardMetrics = components['schemas']['EmailForwardMetrics'];
+/**
+ * EmailForwardMetricsFilters
+ *
+ * @remarks
+ * Type alias for the `EmailForwardMetricsFilters` OpenAPI schema.
+ * This type represents emailforwardmetricsfilters data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getEmailForwardMetricsFilters();
+ * const item: EmailForwardMetricsFilters = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type EmailForwardMetricsFilters = components['schemas']['EmailForwardMetricsFilters'];
+/**
+ * EmailForwardMetricsRates
+ *
+ * @remarks
+ * Type alias for the `EmailForwardMetricsRates` OpenAPI schema.
+ * This type represents emailforwardmetricsrates data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getEmailForwardMetricsRates();
+ * const item: EmailForwardMetricsRates = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type EmailForwardMetricsRates = components['schemas']['EmailForwardMetricsRates'];
 /**
  * EmailForwardResponse
  *

package/src/openapi.yaml

@@ -2755,10 +2755,9 @@ components:
           title: Events
           type: array
         final_status:
+          $ref: '#/components/schemas/EmailForwardLogStatus'
           description: Final status of the email (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE,
             HARD-BOUNCE)
-          title: Final Status
-          type: string
         forward_email:
           description: Forward destination email address
           title: Forward Email
@@ -2870,15 +2869,6 @@ components:
       - status
       title: EmailForwardLogEvent
       type: object
-    EmailForwardLogFinalStatus:
-      enum:
-      - QUEUED
-      - DELIVERED
-      - REFUSED
-      - SOFT-BOUNCE
-      - HARD-BOUNCE
-      title: EmailForwardLogFinalStatus
-      type: string
     EmailForwardLogSortField:
       enum:
       - log_id
@@ -2890,6 +2880,90 @@ components:
       - synced_on
       title: EmailForwardLogSortField
       type: string
+    EmailForwardLogStatus:
+      enum:
+      - QUEUED
+      - DELIVERED
+      - REFUSED
+      - SOFT-BOUNCE
+      - HARD-BOUNCE
+      title: EmailForwardLogStatus
+      type: string
+    EmailForwardMetrics:
+      properties:
+        by_status:
+          additionalProperties:
+            type: integer
+          description: Log counts grouped by status (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE,
+            HARD-BOUNCE)
+          propertyNames:
+            $ref: '#/components/schemas/EmailForwardLogStatus'
+          title: By Status
+          type: object
+        filters:
+          $ref: '#/components/schemas/EmailForwardMetricsFilters'
+          description: Applied filters
+        rates:
+          $ref: '#/components/schemas/EmailForwardMetricsRates'
+          description: Rate percentages for each status
+        total_logs:
+          description: Total number of email forward logs
+          title: Total Logs
+          type: integer
+      required:
+      - total_logs
+      - by_status
+      - rates
+      - filters
+      title: EmailForwardMetrics
+      type: object
+    EmailForwardMetricsFilters:
+      properties:
+        domain:
+          description: Domain name
+          title: Domain
+          type: string
+        end_time:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: End time filter (RFC3339)
+          title: End Time
+        start_time:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Start time filter (RFC3339)
+          title: Start Time
+      required:
+      - domain
+      title: EmailForwardMetricsFilters
+      type: object
+    EmailForwardMetricsRates:
+      properties:
+        delivered:
+          description: Delivery rate percentage
+          title: Delivered
+          type: number
+        hard_bounce:
+          description: Hard bounce rate percentage
+          title: Hard Bounce
+          type: number
+        refused:
+          description: Refused rate percentage
+          title: Refused
+          type: number
+        soft_bounce:
+          description: Soft bounce rate percentage
+          title: Soft Bounce
+          type: number
+      required:
+      - delivered
+      - refused
+      - soft_bounce
+      - hard_bounce
+      title: EmailForwardMetricsRates
+      type: object
     EmailForwardResponse:
       properties:
         aliases:
@@ -6539,7 +6613,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-01-14-103335
+  version: 2026-01-15-094311
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -6608,7 +6682,7 @@ paths:
         required: false
         schema:
           anyOf:
-          - $ref: '#/components/schemas/EmailForwardLogFinalStatus'
+          - $ref: '#/components/schemas/EmailForwardLogStatus'
           - type: 'null'
           title: Final Status
       - in: query
@@ -6698,7 +6772,7 @@ paths:
         required: false
         schema:
           anyOf:
-          - $ref: '#/components/schemas/EmailForwardLogFinalStatus'
+          - $ref: '#/components/schemas/EmailForwardLogStatus'
           - type: 'null'
           title: Final Status
       - in: query
@@ -12695,6 +12769,95 @@ paths:
       summary: Enable email forwarding
       tags:
       - email_forward
+  /v1/email-forwards/{email_forward_id}/metrics:
+    get:
+      description: Retrieves metrics and statistics for a specific email forward,
+        including delivery rates and status counts.
+      operationId: get_email_forward_metrics_v1_email_forwards__email_forward_id__metrics_get
+      parameters:
+      - in: path
+        name: email_forward_id
+        required: true
+        schema:
+          examples:
+          - email_forward_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^email_forward_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Email Forward Id
+          type: string
+          x-typeid-prefix: email_forward
+      - in: query
+        name: start_time
+        required: false
+        schema:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          title: Start Time
+      - in: query
+        name: end_time
+        required: false
+        schema:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          title: End Time
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EmailForwardMetrics'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '403':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_PERMISSION_DENIED
+                detail: Insufficient permissions to perform this action
+                status: 403
+                title: Permission Denied
+                type: permission-denied
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Forbidden
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_EMAIL_FORWARD_NOT_FOUND
+                detail: 'Email forward not found for hostname: Additional error context.'
+                status: 404
+                title: Email Forward Error
+                type: email-forward-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Retrieve email forward metrics
+      tags:
+      - email_forward
   /v1/events:
     get:
       description: Retrieves a paginated list of events for the organization

package/src/schema.d.ts

@@ -1198,6 +1198,26 @@ export interface paths {
         patch: operations["enable_email_forward_v1_email_forwards__email_forward_id__enable_patch"];
         trace?: never;
     };
+    "/v1/email-forwards/{email_forward_id}/metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve email forward metrics
+         * @description Retrieves metrics and statistics for a specific email forward, including delivery rates and status counts.
+         */
+        get: operations["get_email_forward_metrics_v1_email_forwards__email_forward_id__metrics_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/events": {
         parameters: {
             query?: never;
@@ -3551,11 +3571,8 @@ export interface components {
              * @description List of processing events
              */
             events?: components["schemas"]["EmailForwardLogEvent"][];
-            /**
-             * Final Status
-             * @description Final status of the email (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE, HARD-BOUNCE)
-             */
-            final_status: string;
+            /** @description Final status of the email (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE, HARD-BOUNCE) */
+            final_status: components["schemas"]["EmailForwardLogStatus"];
             /**
              * Forward Email
              * @description Forward destination email address
@@ -3658,15 +3675,75 @@ export interface components {
             status: string;
         };
         /**
-         * EmailForwardLogFinalStatus
+         * EmailForwardLogSortField
          * @enum {string}
          */
-        EmailForwardLogFinalStatus: "QUEUED" | "DELIVERED" | "REFUSED" | "SOFT-BOUNCE" | "HARD-BOUNCE";
+        EmailForwardLogSortField: "log_id" | "sender_email" | "recipient_email" | "forward_email" | "final_status" | "created_on" | "synced_on";
         /**
-         * EmailForwardLogSortField
+         * EmailForwardLogStatus
          * @enum {string}
          */
-        EmailForwardLogSortField: "log_id" | "sender_email" | "recipient_email" | "forward_email" | "final_status" | "created_on" | "synced_on";
+        EmailForwardLogStatus: "QUEUED" | "DELIVERED" | "REFUSED" | "SOFT-BOUNCE" | "HARD-BOUNCE";
+        /** EmailForwardMetrics */
+        EmailForwardMetrics: {
+            /**
+             * By Status
+             * @description Log counts grouped by status (QUEUED, DELIVERED, REFUSED, SOFT-BOUNCE, HARD-BOUNCE)
+             */
+            by_status: {
+                [key: string]: number;
+            };
+            /** @description Applied filters */
+            filters: components["schemas"]["EmailForwardMetricsFilters"];
+            /** @description Rate percentages for each status */
+            rates: components["schemas"]["EmailForwardMetricsRates"];
+            /**
+             * Total Logs
+             * @description Total number of email forward logs
+             */
+            total_logs: number;
+        };
+        /** EmailForwardMetricsFilters */
+        EmailForwardMetricsFilters: {
+            /**
+             * Domain
+             * @description Domain name
+             */
+            domain: string;
+            /**
+             * End Time
+             * @description End time filter (RFC3339)
+             */
+            end_time?: string | null;
+            /**
+             * Start Time
+             * @description Start time filter (RFC3339)
+             */
+            start_time?: string | null;
+        };
+        /** EmailForwardMetricsRates */
+        EmailForwardMetricsRates: {
+            /**
+             * Delivered
+             * @description Delivery rate percentage
+             */
+            delivered: number;
+            /**
+             * Hard Bounce
+             * @description Hard bounce rate percentage
+             */
+            hard_bounce: number;
+            /**
+             * Refused
+             * @description Refused rate percentage
+             */
+            refused: number;
+            /**
+             * Soft Bounce
+             * @description Soft bounce rate percentage
+             */
+            soft_bounce: number;
+        };
         /** EmailForwardResponse */
         EmailForwardResponse: {
             /** Aliases */
@@ -6024,7 +6101,7 @@ export interface operations {
                 sort_order?: components["schemas"]["SortOrder"];
                 page_size?: number;
                 page?: number;
-                final_status?: components["schemas"]["EmailForwardLogFinalStatus"] | null;
+                final_status?: components["schemas"]["EmailForwardLogStatus"] | null;
                 start_time?: Date | null;
                 end_time?: Date | null;
             };
@@ -6063,7 +6140,7 @@ export interface operations {
                 sort_order?: components["schemas"]["SortOrder"];
                 page_size?: number;
                 page?: number;
-                final_status?: components["schemas"]["EmailForwardLogFinalStatus"] | null;
+                final_status?: components["schemas"]["EmailForwardLogStatus"] | null;
                 start_time?: Date | null;
                 end_time?: Date | null;
             };
@@ -10922,6 +10999,88 @@ export interface operations {
             };
         };
     };
+    get_email_forward_metrics_v1_email_forwards__email_forward_id__metrics_get: {
+        parameters: {
+            query?: {
+                start_time?: Date | null;
+                end_time?: Date | null;
+            };
+            header?: never;
+            path: {
+                email_forward_id: TypeId<"email_forward">;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EmailForwardMetrics"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_AUTHENTICATION",
+                     *       "detail": "Additional error context.",
+                     *       "status": 401,
+                     *       "title": "Authentication Error",
+                     *       "type": "authentication"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_PERMISSION_DENIED",
+                     *       "detail": "Insufficient permissions to perform this action",
+                     *       "status": 403,
+                     *       "title": "Permission Denied",
+                     *       "type": "permission-denied"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_EMAIL_FORWARD_NOT_FOUND",
+                     *       "detail": "Email forward not found for hostname: Additional error context.",
+                     *       "status": 404,
+                     *       "title": "Email Forward Error",
+                     *       "type": "email-forward-not-found"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     get_events_v1_events_get: {
         parameters: {
             query?: {