@opusdns/api 0.157.0 → 0.159.0

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-arrays.d.ts

@@ -21,7 +21,7 @@
  * This file is auto-generated from the OpenAPI specification.
  * Do not edit manually.
  */
-import { DomainDnssecData, DomainDnssecDataCreate, OrganizationAttribute, OrganizationAttributeUpdate, IpRestriction, TldResponseShort, RegistryHandleAttributeType, ContactAttributeDefinition, ContactRoleAttributeRequirement, PostalAddressType, ContactConfigBase, DnsChange, DnsRecordCreate, DnsRecord, DnsRrsetCreate, DnsRecordPatchOp, DnsRrset, DnsRrsetPatchOp, DomainAvailabilityCheck, ContactHandle, Nameserver, BrowserStatsBucket, GeoStatsBucket, TimeSeriesBucket, DomainForwardPatchOp, PlatformStatsBucket, HttpRedirectList, ReferrerStatsBucket, StatusCodeStatsBucket, UserAgentStatsBucket, VisitsByKeyBucket, DomainForward, DeletePolicyType, SyncOperationType, DomainContact, DomainHost, DomainSearchSuggestionWithPrice, DomainStatus, DomainClientStatus, EmailForwardAliasCreate, EmailForwardLogEvent, EmailForwardAlias, EmailForward, PriceInfo, ValidationError, LaunchPhaseBase, LocalPresenceRequirementType, DomainContactType, OrganizationAttribute2, User, OrganizationAttributeCreate, UserCreate, BillingTransaction, ContactSchema, DnsZone, DomainForwardZone, Domain, EmailForwardLog, EmailForwardZone, EventResponse, Invoice, ObjectLog, Organization, RequestHistory, UserPublic, Period, Permission, PremiumAffectsType, Relation, TldBase, PostTransferRequirements, UserAttributeBase, DomainAvailability } from './schemas.d';
+import { DomainDnssecData, DomainDnssecDataCreate, OrganizationAttribute, OrganizationAttributeUpdate, IpRestriction, TldResponseShort, RegistryHandleAttributeType, ContactAttributeDefinition, ContactRoleAttributeRequirement, PostalAddressType, ContactConfigBase, DnsChange, DnsRecordCreate, DnsRecord, DnsRrsetCreate, DnsRecordPatchOp, DnsRrset, DnsRrsetPatchOp, DomainAvailabilityCheck, ContactHandle, Nameserver, BrowserStatsBucket, GeoStatsBucket, TimeSeriesBucket, DomainForwardPatchOp, PlatformStatsBucket, HttpRedirectList, ReferrerStatsBucket, StatusCodeStatsBucket, UserAgentStatsBucket, VisitsByKeyBucket, DomainForward, DeletePolicyType, SyncOperationType, DomainContact, DomainHost, DomainSearchSuggestionWithPrice, DomainStatus, DomainClientStatus, EmailForwardAliasCreate, EmailForwardLogEvent, EmailForwardAliasMetrics, EmailForwardAlias, EmailForward, PriceInfo, ValidationError, LaunchPhaseBase, LocalPresenceRequirementType, DomainContactType, OrganizationAttribute2, User, OrganizationAttributeCreate, UserCreate, BillingTransaction, ContactSchema, DnsZone, DomainForwardZone, Domain, EmailForwardLog, EmailForwardZone, EventResponse, Invoice, ObjectLog, Organization, RequestHistory, UserPublic, Period, Permission, PremiumAffectsType, Relation, TldBase, PostTransferRequirements, UserAttributeBase, DomainAvailability } from './schemas.d';
 
 /**
  * DomainDnssecDataResponse
@@ -597,6 +597,20 @@ export type EmailForwardAliasCreateArray = EmailForwardAliasCreate[];
  * @see {@link EmailForwardLogEvent} - The individual EmailForwardLogEvent type definition
  */
 export type EmailForwardLogEventArray = EmailForwardLogEvent[];
+/**
+ * EmailForwardAliasMetrics
+ *
+ * @remarks
+ * Array type for EmailForwardAliasMetrics objects. Used when the API returns a collection of EmailForwardAliasMetrics instances.
+ *
+ * @example
+ * ```typescript
+ * const items: EmailForwardAliasMetricsArray = await api.getEmailForwardAliasMetricss();
+ * ```
+ *
+ * @see {@link EmailForwardAliasMetrics} - The individual EmailForwardAliasMetrics type definition
+ */
+export type EmailForwardAliasMetricsArray = EmailForwardAliasMetrics[];
 /**
  * EmailForwardAlias
  *

package/src/helpers/schemas.d.ts

@@ -1818,6 +1818,22 @@ export type EmailForwardAlias = components['schemas']['EmailForwardAlias'];
  * @see {@link components} - The OpenAPI components schema definition
  */
 export type EmailForwardAliasCreate = components['schemas']['EmailForwardAliasCreate'];
+/**
+ * EmailForwardAliasMetrics
+ *
+ * @remarks
+ * Type alias for the `EmailForwardAliasMetrics` OpenAPI schema.
+ * This type represents emailforwardaliasmetrics data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getEmailForwardAliasMetrics();
+ * const item: EmailForwardAliasMetrics = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type EmailForwardAliasMetrics = components['schemas']['EmailForwardAliasMetrics'];
 /**
  * EmailForwardAliasUpdate
  *
@@ -1883,37 +1899,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

@@ -2705,6 +2705,30 @@ components:
       - forward_to
       title: EmailForwardAliasCreate
       type: object
+    EmailForwardAliasMetrics:
+      properties:
+        alias:
+          description: Email alias address
+          title: Alias
+          type: string
+        by_status:
+          additionalProperties:
+            type: integer
+          description: Log counts grouped by status
+          propertyNames:
+            $ref: '#/components/schemas/EmailForwardLogStatus'
+          title: By Status
+          type: object
+        total_logs:
+          description: Total number of logs for this alias
+          title: Total Logs
+          type: integer
+      required:
+      - alias
+      - total_logs
+      - by_status
+      title: EmailForwardAliasMetrics
+      type: object
     EmailForwardAliasUpdate:
       properties:
         forward_to:
@@ -2755,10 +2779,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 +2893,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 +2904,110 @@ components:
       - synced_on
       title: EmailForwardLogSortField
       type: string
+    EmailForwardLogStatus:
+      enum:
+      - QUEUED
+      - DELIVERED
+      - REFUSED
+      - SOFT-BOUNCE
+      - HARD-BOUNCE
+      title: EmailForwardLogStatus
+      type: string
+    EmailForwardMetrics:
+      properties:
+        alias_count:
+          anyOf:
+          - type: integer
+          - type: 'null'
+          description: Number of aliases
+          title: Alias Count
+        by_alias:
+          anyOf:
+          - items:
+              $ref: '#/components/schemas/EmailForwardAliasMetrics'
+            type: array
+          - type: 'null'
+          description: Metrics breakdown per alias
+          title: By Alias
+        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
+        include_aliases:
+          anyOf:
+          - type: boolean
+          - type: 'null'
+          description: Whether alias breakdown is included
+          title: Include Aliases
+        start_time:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Start time filter (RFC3339)
+          title: Start Time
+      required:
+      - domain
+      title: EmailForwardMetricsFilters
+      type: object
+    EmailForwardMetricsRates:
+      properties:
+        bounce_rate:
+          description: Bounce rate percentage
+          title: Bounce Rate
+          type: number
+        delivery_rate:
+          description: Delivery rate percentage
+          title: Delivery Rate
+          type: number
+        queued_rate:
+          description: Queued rate percentage
+          title: Queued Rate
+          type: number
+        refused_rate:
+          description: Refused rate percentage
+          title: Refused Rate
+          type: number
+      required:
+      - delivery_rate
+      - refused_rate
+      - queued_rate
+      - bounce_rate
+      title: EmailForwardMetricsRates
+      type: object
     EmailForwardResponse:
       properties:
         aliases:
@@ -6539,7 +6657,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-01-14-103335
+  version: 2026-01-15-095407
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -6608,7 +6726,7 @@ paths:
         required: false
         schema:
           anyOf:
-          - $ref: '#/components/schemas/EmailForwardLogFinalStatus'
+          - $ref: '#/components/schemas/EmailForwardLogStatus'
           - type: 'null'
           title: Final Status
       - in: query
@@ -6698,7 +6816,7 @@ paths:
         required: false
         schema:
           anyOf:
-          - $ref: '#/components/schemas/EmailForwardLogFinalStatus'
+          - $ref: '#/components/schemas/EmailForwardLogStatus'
           - type: 'null'
           title: Final Status
       - in: query
@@ -12695,6 +12813,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