From 7121c75db4ae8070b1da1fda5e099efee907aec0 Mon Sep 17 00:00:00 2001 From: Ivan Yurchanka Date: Mon, 30 Mar 2026 18:53:53 +0200 Subject: [PATCH 1/4] Update `compliance_status` field in email sending spec with detailed descriptions and possible values --- specs/email-sending.openapi.yml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml index db3ff35..6943d63 100644 --- a/specs/email-sending.openapi.yml +++ b/specs/email-sending.openapi.yml @@ -1514,6 +1514,24 @@ components: type: boolean compliance_status: type: string + description: | + Indicates the compliance verification status of the sending domain. The domain must reach `compliant` status before you can send emails in production. + + Possible values: + + - `initial` - Domain has just been created and no verification steps have been completed yet. + - `unverified_dns` - DNS records have not been verified. Add the required DNS records and verify them to proceed. + - `demo` - Domain is in demo mode with limited sending capabilities. Complete the compliance review to unlock full sending. + - `missing_company_info` - Company information is incomplete. Go to your [account settings](https://mailtrap.io/accounts) and fill in the required company details. + - `pending` - Domain has been submitted for compliance review and is awaiting processing. + - `under_review` - Domain is currently being reviewed by the Mailtrap compliance team. + - `compliant` - Domain has passed compliance review and is fully approved for sending. + - `non_compliant` - Domain did not pass the compliance review. Check your email for details and re-submit after addressing the issues. + - `suspended` - Domain has been suspended due to a compliance violation. Contact [Mailtrap Support](mailto:support@mailtrap.io) for assistance. + + {% hint style="info" %} + To check and manage your domain compliance status, visit the [Sending Domains](https://mailtrap.io/sending/domains) page in the Mailtrap dashboard. + {% endhint %} enum: - initial - unverified_dns From 4626747b56f9a3a22f6c8b6fe7636a775272cc03 Mon Sep 17 00:00:00 2001 From: Ivan Yurchanka Date: Tue, 31 Mar 2026 12:04:11 +0200 Subject: [PATCH 2/4] Add missing compliance statuses --- specs/email-sending.openapi.yml | 40 ++++++++++++++++++++++++--------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml index 6943d63..2be16cb 100644 --- a/specs/email-sending.openapi.yml +++ b/specs/email-sending.openapi.yml @@ -1515,19 +1515,35 @@ components: compliance_status: type: string description: | - Indicates the compliance verification status of the sending domain. The domain must reach `compliant` status before you can send emails in production. + Indicates the compliance verification status of the sending domain. + The domain must reach `compliant` status before you can send emails + in production. Possible values: - - `initial` - Domain has just been created and no verification steps have been completed yet. - - `unverified_dns` - DNS records have not been verified. Add the required DNS records and verify them to proceed. - - `demo` - Domain is in demo mode with limited sending capabilities. Complete the compliance review to unlock full sending. - - `missing_company_info` - Company information is incomplete. Go to your [account settings](https://mailtrap.io/accounts) and fill in the required company details. - - `pending` - Domain has been submitted for compliance review and is awaiting processing. - - `under_review` - Domain is currently being reviewed by the Mailtrap compliance team. - - `compliant` - Domain has passed compliance review and is fully approved for sending. - - `non_compliant` - Domain did not pass the compliance review. Check your email for details and re-submit after addressing the issues. - - `suspended` - Domain has been suspended due to a compliance violation. Contact [Mailtrap Support](mailto:support@mailtrap.io) for assistance. + - `demo` - A demo domain provided by Mailtrap. Can only send emails + to the account owner. + - `exhausted` - A demo domain that has used up its sending + allowance. Cannot send emails. + - `unverified_dns` - Domain DNS records have not been verified yet. + Add and verify the required DNS records before sending. + - `missing_company_info` - Account is missing required company + information. Fill in the company details to proceed. + - `initial` - Domain is verified and undergoing automatic + compliance review (takes up to 2 minutes). + - `pending` - Automatic review required additional information. + Fill in the compliance questionnaire to continue. + - `pending_cc` - Compliance questionnaire was submitted but credit + card identity verification is still needed. + - `under_review` - Compliance questionnaire submitted and manual + review is in progress. Can take up to one business day. + - `non_compliant` - Domain did not pass compliance checks. Sending + is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) + for details. + - `compliant` - Domain has passed all compliance checks and is + ready to send emails. + - `suspended` - Domain sending has been suspended. Check the reason + in your dashboard and resolve the issue. {% hint style="info" %} To check and manage your domain compliance status, visit the [Sending Domains](https://mailtrap.io/sending/domains) page in the Mailtrap dashboard. @@ -1538,10 +1554,12 @@ components: - demo - missing_company_info - pending + - pending_cc - under_review + - compliant - non_compliant - suspended - - compliant + - exhausted dns_verified: type: boolean dns_verified_at: From b93e8ff63e88126f17316df047926e7c48cc64b9 Mon Sep 17 00:00:00 2001 From: Ivan Yurchanka Date: Tue, 31 Mar 2026 12:16:26 +0200 Subject: [PATCH 3/4] Add next steps --- specs/email-sending.openapi.yml | 38 ++++++++++----------------------- 1 file changed, 11 insertions(+), 27 deletions(-) diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml index 2be16cb..7ae8169 100644 --- a/specs/email-sending.openapi.yml +++ b/specs/email-sending.openapi.yml @@ -1521,33 +1521,17 @@ components: Possible values: - - `demo` - A demo domain provided by Mailtrap. Can only send emails - to the account owner. - - `exhausted` - A demo domain that has used up its sending - allowance. Cannot send emails. - - `unverified_dns` - Domain DNS records have not been verified yet. - Add and verify the required DNS records before sending. - - `missing_company_info` - Account is missing required company - information. Fill in the company details to proceed. - - `initial` - Domain is verified and undergoing automatic - compliance review (takes up to 2 minutes). - - `pending` - Automatic review required additional information. - Fill in the compliance questionnaire to continue. - - `pending_cc` - Compliance questionnaire was submitted but credit - card identity verification is still needed. - - `under_review` - Compliance questionnaire submitted and manual - review is in progress. Can take up to one business day. - - `non_compliant` - Domain did not pass compliance checks. Sending - is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) - for details. - - `compliant` - Domain has passed all compliance checks and is - ready to send emails. - - `suspended` - Domain sending has been suspended. Check the reason - in your dashboard and resolve the issue. - - {% hint style="info" %} - To check and manage your domain compliance status, visit the [Sending Domains](https://mailtrap.io/sending/domains) page in the Mailtrap dashboard. - {% endhint %} + - `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner. + - `exhausted` - A demo domain that has used up its sending allowance. Cannot send emails. + - `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/sending/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide. + - `missing_company_info` - Account is missing required company information. Go to [Company Information](https://mailtrap.io/account-management?current_tab=company_information) and fill in the required details. + - `initial` - Domain is verified and undergoing automatic compliance review. No action needed — typically completes within 2 minutes. + - `pending` - Automatic review required additional information. Open your domain on the [Sending Domains](https://mailtrap.io/sending/domains) page and fill in the compliance questionnaire. + - `pending_cc` - Compliance questionnaire was submitted but credit card identity verification is still needed. Open your domain on the [Sending Domains](https://mailtrap.io/sending/domains) page and enter card details. The charged amount is refunded immediately and the card is not stored. + - `under_review` - Compliance questionnaire submitted and manual review is in progress. No action needed — this can take up to one business day. + - `non_compliant` - Domain did not pass compliance checks. Sending is not allowed. Contact [Mailtrap Support](mailto:support@mailtrap.io) for details and next steps. + - `compliant` - Domain has passed all compliance checks and is ready to send emails. + - `suspended` - Domain sending has been suspended. Contact [Mailtrap Support](mailto:support@mailtrap.io) to resolve the issue. enum: - initial - unverified_dns From cdc3b9a3ec9b272320b2dfff765780ca2602f9e1 Mon Sep 17 00:00:00 2001 From: Ivan Yurchanka Date: Tue, 31 Mar 2026 12:25:54 +0200 Subject: [PATCH 4/4] Clean up possible values --- specs/email-sending.openapi.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml index 7ae8169..a9d7c7d 100644 --- a/specs/email-sending.openapi.yml +++ b/specs/email-sending.openapi.yml @@ -1519,8 +1519,6 @@ components: The domain must reach `compliant` status before you can send emails in production. - Possible values: - - `demo` - A demo domain provided by Mailtrap. Can only send emails to the account owner. - `exhausted` - A demo domain that has used up its sending allowance. Cannot send emails. - `unverified_dns` - Domain DNS records have not been verified yet. Open your domain on the [Sending Domains](https://mailtrap.io/sending/domains) page and follow the [Sending Domain Setup](https://docs.mailtrap.io/email-api-smtp/setup/sending-domain) guide.