openapi: 3.1.0 info: title: Alerts description: >- Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configured to trigger an alert. A channel describes the delivery method for an alert. Every configured alert consists of an event type / channel pair. This level of granularity allows alerting to be configured to your exact preference. version: 0.0.1 servers: - url: https://api.mailgun.net description: US Mailgun - url: https://api.eu.mailgun.net description: EU Mailgun tags: - name: Alerts x-displayName: Alerts - name: Bounce Classification x-displayName: Bounce Classification - name: Domains x-displayName: Domains - name: IP Blocklist Monitoring x-displayName: IP Blocklist Monitoring - name: Email Preview description: >- This API provides functionality to create and manage email preview tests, as well as create shareable links. x-displayName: Email Preview - name: Domain Blocklist Monitoring description: >- Blocklist Monitoring enables you to keep an eye on your reputation. Monitor your domains against our curated list of blocklist providers to make sure you aren't being blocked. x-displayName: Domain Blocklist Monitoring - name: Spam Traps Monitoring description: >- Our spam trap monitoring service surfaces how much of your email is being sent to known spam traps. x-displayName: Spam Traps Monitoring - name: openapi-spamtraps_other x-displayName: other - name: Inbox Placement description: >- Inbox Placement testing allows you to see the likely deliverability of your email campaigns. x-displayName: Inbox Placement - name: Email Health Score x-displayName: Email Health Score - name: DMARC Reports description: >- DMARC reporting provides valuable insights into your infrastructure, helping you identify potential issues like senders, misconfigured email servers, or phishing attempts. x-displayName: DMARC Reports - name: Google Postmaster Tools description: This API provides access to Google Postmaster data. x-displayName: Google Postmaster Tools - name: Microsoft SNDS description: This API provides access to Microsoft SNDS data. x-displayName: Microsoft SNDS - name: openapi-reputationanalytics_other x-displayName: other paths: /v1/alerts/events: get: tags: - Alerts summary: List events description: The current list of events that you can chose to receive alerts for. operationId: GET-v1-alerts-events responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-ListAlertsEventsResp examples: Example: value: events: - ip_listed - ip_delisted default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/settings/events: post: tags: - Alerts summary: Add Alert description: >- Use this endpoint to add new alert settings record. ### Webhooks This section covers details around consuming Mailgun Optimize alerts via webhooks. If you are familiar with Mailgun Send webhooks, there is a lot of overlapping similarity, however, there are also a few minor nuances to account for. #### Securing Webhooks HMAC is used to verified to integrity as well as the authenticity of received webhooks. To verify the origin of a webhook: 1. Encode the webhook’s entire POST request body with the HMAC algorithm (using your webhook signing key and SHA256 digest mode) 2. Compare the resulting hexdigest to the signature provided in the POST request’s X-Sign header. NOTE: If you’re consuming Mailgun Send webhooks, please note that your Mailgun Send webhook signing key differs from your Mailgun Optimize alerts webhook signing key. Your Mailgun Optimize alerts webhook signing key is available within the Mailgun Optimize UI. #### Webhook URL Validation When adding or updating a webhook URL for alerts, we will ensure the endpoint is reachable by sending a GET request to the provided URL. If a 200 response is not returned from your endpoint, the request will be rejected and your alert setting will not be saved. We intentionally chose to send a GET request instead of a POST when validating URLs so that your webhook endpoint does not have to account for test requests. Additionally, when a POST request is sent to your webhook URL, if a 2xx is not returned, we will attempt retries via an exponential backoff strategy for up to ~8 hours. If the max retry count is reached, the alert will be disabled and the related alert settings record’s disabled_at field will be populated. operationId: POST-v1-alerts-settings-events requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-mutateEventSettingReq examples: Example: value: event_type: ip_listed channel: webhook settings: url: https://yourwebhookurl.com required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-EventSettings examples: Example: value: id: 00000000-0000-0000-0000-000000000000 event_type: ip_listed channel: webhook settings: url: https://yourwebhookurl.com '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse '409': description: A 409 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/settings/events/{id}: put: tags: - Alerts summary: Update Alert description: >- Use this endpoint to update an existing alert setting record. NOTE: When updating a webhook alert, we will ensure the endpoint is reachable by sending a GET request to the provided URL. If a 200 response is not returned, a 400 will be returned and the alert setting update will be rejected. operationId: PUT-v1-alerts-settings-events--id- parameters: - name: id in: path description: The settings ID. required: true schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-mutateEventSettingReq examples: Example: value: event_type: ip_delisted channel: email settings: emails: - recipient-a@example.com - recipient-b@example.com required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: settings updated '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] delete: tags: - Alerts summary: Remove Alert operationId: DELETE-v1-alerts-settings-events--id- parameters: - name: id in: path description: The settings ID. required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: settings deleted default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/settings: get: tags: - Alerts summary: List Alerts description: >- This endpoint returns a list of all configured alert settings for your account. operationId: GET-v1-alerts-settings responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-SettingsResponse examples: Example: value: events: - id: 00000000-0000-0000-0000-000000000000 event_type: ip_listed channel: webhook settings: url: https://example.com/delisted_hook - id: 00000000-0000-0000-0000-000000000000 event_type: ip_delisted channel: webhook settings: url: https://yourwebhookurl.com disabled_at: '2006-01-02T22:04:05Z' - id: 00000000-0000-0000-0000-000000000000 event_type: ip_delisted channel: email settings: emails: - recipient-1@example.com - recipient-2@example.com webhooks: {} slack: {} default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/settings/slack: put: tags: - Alerts summary: Update Slack settings operationId: PUT-v1-alerts-settings-slack requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-Slack required: true responses: '204': description: A 204 response default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] delete: tags: - Alerts summary: Delete Slack settings description: >- Delete Slack settings and Slack event settings for the Mailgun account. To revoke the Slack access token, use DELETE /v1/alerts/slack/oauth. To completely remove the Slack App from Slack Workspace, go into App Configuration in Slack. operationId: DELETE-v1-alerts-settings-slack responses: '204': description: A 204 response default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/settings/webhooks/signing_key: put: tags: - Alerts summary: Reset Webhook Signing Key operationId: PUT-v1-alerts-settings-webhooks-signing-key responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-ResetWebhooksSigningKeyResp default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/webhooks/test: post: tags: - Alerts summary: Test webhook description: Sends test webhook request to specified url with dummy data. operationId: POST-v1-alerts-webhooks-test requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-TestWebhookRequest examples: Example: value: event_type: some-event url: https://some-webhook-url.com/webhook required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/email/test: post: tags: - Alerts summary: Test message description: Sends test message to emails with dummy data. operationId: POST-v1-alerts-email-test requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-TestEmailRequest examples: Example: value: event_type: some-event emails: - email1@example.com - email2@example.com required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/slack/test: post: tags: - Alerts summary: Test message description: Sends test message to slack channels with dummy data. operationId: POST-v1-alerts-slack-test requestBody: content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-TestSlackRequest examples: Example: value: event_type: some-event channel_ids: - C0123 - C0456 required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/slack/oauth: delete: tags: - Alerts summary: Revoke Slack access token description: >- Revoke Slack access token, delete Slack settings and Slack event settings. NOTE: All Mailgun accounts connected to the same Slack workspace share the same token. To completely remove the Slack App from Slack Workspace, go into App Configuration in Slack. operationId: DELETE-v1-alerts-slack-oauth responses: '204': description: A 204 response default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/alerts/slack/channels/{id}: get: tags: - Alerts summary: Get Slack channel description: Returns Slack channel. operationId: GET-v1-alerts-slack-channels--id- parameters: - name: id in: path description: The Slack channel ID. required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-SlackChannel examples: Example: value: id: C012AB3CD name: general '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: token should have 'xoxb-' prefix '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: 'missing_scope: please reconnect the Slack App' '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: no settings security: - basicAuth: [] /v1/alerts/slack/channels: get: tags: - Alerts summary: List Slack channels description: List Slack channels for the connected Slack workspace. operationId: GET-v1-alerts-slack-channels responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-ListSlackChannelsResp examples: Example: value: items: - id: C012AB3CD name: general '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: token should have 'xoxb-' prefix '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: 'missing_scope: please reconnect the Slack App' '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: no settings security: - basicAuth: [] /v1/bounce-classification/stats: get: tags: - Bounce Classification summary: List statistics, ordered by total bounces description: >- e.g. /v1/bounce-classification/stats?group=domain.name&group=entity-id&group=rule-id&group=subaccount.id&limit=10 operationId: GET-v1-bounce-classification-stats parameters: - name: group in: query description: >- Group response by fields: subaccount.id, domain.name, entity-id, rule-id schema: type: string - name: limit in: query description: Limits the number of items returned in a response schema: type: integer - name: include_subaccounts in: query description: Include subaccounts schema: type: boolean default: false responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListStatsResp examples: Example: value: items: - subaccount: id: subaccount_id domain: name: example.com rule-id: 55ff entity-id: spamhaus short-explanation: You're listed on Spamhaus! bounced: total: 4 _duration: 0s security: - basicAuth: [] patch: tags: - Bounce Classification summary: Dismiss bounces from GET /v1/bounce-classification/stats operationId: PATCH-v1-bounce-classification-stats parameters: - name: domain.name in: query description: The sender domain name schema: type: string - name: entity-id in: query description: The entity ID(Email Service Entity or Spam Filter / BL) schema: type: string - name: rule-id in: query description: Rule ID schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-UpdateStatsReq examples: Example: value: is-dismissed: true required: true responses: '204': description: A 204 response deprecated: true security: - basicAuth: [] /v1/bounce-classification/domains: get: tags: - Bounce Classification summary: List domains statistic per account operationId: GET-v1-bounce-classification-domains parameters: - name: limit in: query description: Limits the number of items returned in a response schema: type: integer - name: skip in: query description: Skips N items in a response schema: type: integer - name: query in: query description: 'Query filter, e.g.: ''domain.name:example.com''' schema: type: string - name: include_subaccounts in: query description: Include subaccounts schema: type: boolean default: false responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListAccountStatsResp examples: Example: value: items: - domain: name: mailgun.net bounced: total: 4 total: 1 security: - basicAuth: [] /v1/bounce-classification/domains/{domain}/entities: get: tags: - Bounce Classification summary: List statistic per domain operationId: GET-v1-bounce-classification-domains--domain--entities parameters: - name: domain in: path description: The sender domain name required: true schema: type: string - name: include_subaccounts in: query description: Include subaccounts schema: type: boolean default: false responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListDomainStatsResp examples: Example: value: items: - entity-id: gmail entity-name: Gmail bounced: total: 1 - entity-id: hotmail entity-name: Microsoft (Hotmail) bounced: total: 3 security: - basicAuth: [] /v1/bounce-classification/domains/{domain}/entities/{entity-id}/rules: get: tags: - Bounce Classification summary: List statistic per entity operationId: GET-v1-bounce-classification-domains--domain--entities--entity-id--rules parameters: - name: domain in: path description: The sender domain name required: true schema: type: string - name: entity-id in: path description: The entity ID(Email Service Entity or Spam Filter / BL) required: true schema: type: string - name: include_subaccounts in: query description: Include subaccounts schema: type: boolean default: false responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListEntityStatsResp examples: Example: value: items: - rule-id: 55ff category: ESPBLOCK severity: PERMANENT sample-text: '5.4.1 recipient address rejected: access denied.' explanation: Access denied bounced: total: 3 '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/bounce-classification/domains/{domain}/events: get: tags: - Bounce Classification summary: List Bounce Logs description: 'Deprecated: use /v1/analytics/logs' operationId: GET-v1-bounce-classification-domains--domain--events parameters: - name: domain in: path description: The sender domain name required: true schema: type: string - name: rule-id in: query description: Optional if 'page' is passed schema: type: string - name: entity-id in: query description: The entity ID(Email Service Entity or Spam Filter / BL) schema: type: string - name: sort in: query description: Sort field and order. Default is '@timestamp:asc' schema: type: string - name: page in: query description: Encoded paging information, provided via 'next', 'previous' links schema: type: string - name: limit in: query description: Limits the number of items returned in a response schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListEventsResp examples: Example: value: items: - i-classification: reason: ESPBLOCK delivery-status: message: '5.4.1 recipient address rejected: access denied.' envelope: sending-ip: 1.2.3.4 '@timestamp': 2006-01-02T15:04:05Z07:00 paging: previous: https://url1 first: https://url2 next: https://url3 last: https://url4 _from: '0001-01-01T00:00:00Z' '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-scaffold-httpapi-GenericResponse deprecated: true security: - basicAuth: [] /v1/bounce-classification/config/entities: get: tags: - Bounce Classification summary: List entities operationId: GET-v1-bounce-classification-config-entities responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Entities examples: Example: {} security: - basicAuth: [] /v1/bounce-classification/config/rules: get: tags: - Bounce Classification summary: List rules operationId: GET-v1-bounce-classification-config-rules responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Rules examples: Example: {} security: - basicAuth: [] /v1/inboxready/domains: get: tags: - Domains summary: Returns Domains on Mailgun Optimize services description: >- Will return details on an Mailgun Optimize Domain. If no Domain is provided, then a list of all Mailgun Optimize Domains on an account will be returned. operationId: GET-v1-inboxready-domains parameters: - name: limit in: query description: Limit schema: type: integer - name: domain in: query description: Domain name schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-DomainListResponse examples: Example: value: items: - name: domain.tld verified: verified_at: 123456789 status: pending services: service_name: false txt_record: IR-hashed-txt-record-key paging: previous: https://.... first: https://.... next: https://.... last: https://.... default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] post: tags: - Domains summary: Add a single domain to an account operationId: POST-v1-inboxready-domains parameters: - name: domain in: query description: Domain name required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-AddDomainResponse examples: Example: value: message: The domain has been added domain: name: domain.tld verified: verified_at: 123456789 status: pending services: service_name: false txt_record: IR-hashed-txt-record-key default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] delete: tags: - Domains summary: Deletes a single domain from an account operationId: DELETE-v1-inboxready-domains parameters: - name: domain in: query description: Domain name required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-DeleteDomainResponse examples: Example: value: message: domain.tld has been removed from Mailgun Optimize default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/inboxready/domains/verify: put: tags: - Domains summary: Queues a domain to be processed for verification operationId: PUT-v1-inboxready-domains-verify parameters: - name: domain in: query description: Domain name required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse examples: Example: value: message: Domain pending verification '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse examples: Example: value: message: No domain provided '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse examples: Example: value: message: Domain not found default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/inboxready/ip_addresses: get: tags: - IP Blocklist Monitoring summary: Lists monitored IP addresses operationId: GET-v1-inboxready-ip-addresses parameters: - name: limit in: query description: Limit schema: type: integer default: 100 responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-ListIPAddressesResp examples: Example: value: items: - ip: 127.0.0.1 ip_pool: swimming description: this is a description state: listed listed: - list: b.barracudacentral.org delist_requested_at: 0001-01-01 00:00:00 +0000 UTC first_seen: 2021-06-14 13:46:52 +0000 UTC last_seen: 2022-06-14 13:46:52 +0000 UTC comments: - >- http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] post: tags: - IP Blocklist Monitoring summary: Register an IP address operationId: POST-v1-inboxready-ip-addresses requestBody: content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-CreateIPAddressReq examples: Example: value: UpdateIPAddressReq: {} required: true responses: '201': description: A 201 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress examples: Example: value: - ip: 127.0.0.1 ippool: swimming description: this is a description state: listed listed: - list: b.barracudacentral.org delistrequestedat: '0001-01-01T00:00:00Z' firstseen: '2021-06-14T13:46:52Z' lastseen: '2022-06-14T13:46:52Z' comments: - >- http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1 name: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '409': description: A 409 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v1/inboxready/ip_addresses/{ip}: get: tags: - IP Blocklist Monitoring summary: Get the IP address operationId: GET-v1-inboxready-ip-addresses--ip- parameters: - name: ip in: path description: IP address required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress examples: Example: value: - ip: 127.0.0.1 ippool: swimming description: this is a description state: listed listed: - list: b.barracudacentral.org delistrequestedat: '0001-01-01T00:00:00Z' firstseen: '2021-06-14T13:46:52Z' lastseen: '2022-06-14T13:46:52Z' comments: - >- http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1 name: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] put: tags: - IP Blocklist Monitoring summary: Update the IP address operationId: PUT-v1-inboxready-ip-addresses--ip- parameters: - name: ip in: path description: IP address required: true schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-UpdateIPAddressReq required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress examples: Example: value: - ip: 127.0.0.1 ippool: swimming description: this is a description state: listed listed: - list: b.barracudacentral.org delistrequestedat: '0001-01-01T00:00:00Z' firstseen: '2021-06-14T13:46:52Z' lastseen: '2022-06-14T13:46:52Z' comments: - >- http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1 name: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] delete: tags: - IP Blocklist Monitoring summary: Removes IP from monitoring operationId: DELETE-v1-inboxready-ip-addresses--ip- parameters: - name: ip in: path description: IP address required: true schema: type: string responses: '204': description: A 204 response '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: description of the error '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: IP Blocklist monitoring not enabled '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: ip address not found security: - basicAuth: [] /v1/preview/tests/clients: get: tags: - Email Preview summary: List Clients description: Returns a list of clients that can perform an email preview. operationId: GET-v1-preview-tests-clients responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientsResponse examples: Example: value: clients: android10_gmailapp_pixel4_dm: id: android10_gmailapp_pixel4_dm client: Gmail App Pixel 4 os: Android 10 (Dark Mode) category: Mobile browser: '' rotate: false imageblocking: false free: false default: true extension: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests: get: tags: - Email Preview summary: List Emailpreview Tests description: >- Returns a list of email preview tests.

**WARNING:** _This endpoint is deprecated in favor of our [V2 endpoint](https://documentation.mailgun.com/docs/inboxready/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/GET-v2-preview-tests)._ operationId: GET-v1-preview-tests responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse examples: Example: value: - id: '' date: 0 type: '' subject: '' headers: '': '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] post: tags: - Email Preview summary: Create Emailpreview Test description: >- Creates a new email preview test.

**WARNING:** _This endpoint is deprecated in favor of our [V2 endpoint](https://documentation.mailgun.com/docs/inboxready/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/POST-v2-preview-tests)._ operationId: POST-v1-preview-tests requestBody: content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest examples: Example: value: subject: some subject url: https://example.com content_checking: {} required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse examples: Example: value: id: gmail '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests/{test_id}/results: get: tags: - Email Preview summary: Get Test Results description: Returns the results for the specified email preview test. operationId: GET-v1-preview-tests--test-id--results parameters: - name: test_id in: path description: Test to get results for required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse examples: Example: value: android10_gmailapp_pixel4_dm: id: android10_gmailapp_pixel4_dm displayname: Gmail App Pixel 4 client: Gmail App os: Android 10 (Dark Mode) category: Mobile browser: '' screenshots: default: https://images.emailonacid.com/123 thumbnail: https://images.emailonacid.com/1234 fullthumbnail: >- https://images.emailonacid.com/90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257 status: Complete statusdetails: submitted: 1741804257 completed: 1741804276 bouncecode: '' bouncemessage: '' android10_gmailapp_pixel4_lm: id: android10_gmailapp_pixel4_lm displayname: Gmail App Pixel 4 client: Gmail App os: Android 10 category: Mobile browser: '' screenshots: default: >- https://images.emailonacid.com/YXB479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257 thumbnail: >- https://images.emailonacid.com/YXBpLzRRZVp3Z0479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257 fullthumbnail: >- https://images.emailonacid.com/YXBpLzRRZVp3ZzlBbmJydjVEZjBUOW9obUxpU1RUQmpe=d90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257 status: Complete statusdetails: submitted: 1741804257 completed: 1741804275 bouncecode: '' bouncemessage: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests/{test_id}: get: tags: - Email Preview summary: Get Emailpreview Test Info description: >- Returns test info.

**WARNING:** _This endpoint is deprecated in favor of our [V2 endpoint](https://documentation.mailgun.com/docs/inboxready/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/GET-v2-preview-tests--test-id-)._ operationId: GET-v1-preview-tests--test-id- parameters: - name: test_id in: path description: Test to get the content of required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] delete: tags: - Email Preview summary: Delete Emailpreview Test description: >- Deletes the specified test.

**WARNING:** _This endpoint is deprecated in favor of our [V2 endpoint](https://documentation.mailgun.com/docs/inboxready/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/DELETE-v2-preview-tests--test-id-)._ operationId: DELETE-v1-preview-tests--test-id- parameters: - name: test_id in: path description: Test to delete required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests/{test_id}/results/reprocess: put: tags: - Email Preview summary: Reprocess Emailpreview Test description: Reprocesses the test for the passed clients. operationId: PUT-v1-preview-tests--test-id--results-reprocess parameters: - name: test_id in: path description: Test to reprocess required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessTestResponse examples: Example: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests/{test_id}/content: get: tags: - Email Preview summary: Get Test Content (empty) description: Gets HTML content of the passed test. operationId: GET-v1-preview-tests--test-id--content parameters: - name: test_id in: path description: Test to get the content of required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/tests/{test_id}/content/{content}: get: tags: - Email Preview summary: Get Test Content description: Gets HTML content of the passed test. operationId: GET-v1-preview-tests--test-id--content--content- parameters: - name: test_id in: path description: Test to get the content of required: true schema: type: string - name: content in: path description: 'Content to get: inlinecss or textonly' schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/address: post: tags: - Email Preview summary: Generate Preview Address description: Returns or generates an account's email preview address. operationId: POST-v1-preview-address responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-address-PreviewAddressResponse '500': description: A 500 response content: application/json: schema: $ref: '#/components/schemas/Email_Preview_API_string' 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v2/preview/tests: get: tags: - Email Preview summary: List/Search Tests V2 description: >- This call returns a list of Email Tests along with metadata about each test. Email Tests are stored for 90 days. When query parameters are provided, only the tests matching the specified criteria will be returned; otherwise, all available tests are returned. The response structure remains identical in both cases. operationId: GET-v2-preview-tests parameters: - name: customer_id in: query description: Filter tests by the provided customer ID. schema: type: string - name: from in: query description: >- The starting point of your test date range. Accepts formats like '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'. schema: type: string - name: to in: query description: >- The ending point of your test date range. Accepts formats like '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'. schema: type: string - name: subject in: query description: >- The "subject" field of returned tests must contain the exact string. This search is case-insensitive. schema: type: string - name: headers in: query description: >- Enterprise users can use this field in a KV array of x-headers submitted with the test. This is an AND match, meaning all headers must be present to return. schema: type: string - name: results in: query description: >- The number of results to return. Must be between 1 and 200. The default value is 50. schema: type: integer - name: page in: query description: >- The page number. If you submit a number higher than the number of pages in the data, an empty array will be returned. The default value is 1. schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse examples: Example: value: - id: DdbNga1MdL3N7sO19v5MAmpOKIqFrLg9cgpCIgS4othXJ date: 1739876826 type: email-test subject: subject headers: {} - id: pDdLWjbj3ZbAnHkTbg3QG27mFyoc62OAH1WJXgmb0uNT4 date: 1739874606 type: email-test subject: '' headers: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] post: tags: - Email Preview summary: Create Email Preview Test V2 description: >- This call creates a new email test and submits it to our system for processing.
All requests must contain a subject property and one source property (either html or url). All other properties are optional. In the following table, each property and its default value is shown.
If content-checking variables (such as those for link validation, image validation, or accessibility) are set in the body of the request, the endpoint will run content-checking on the email content.
The response will include an id property that should be used to request the results or trigger further processes on the email content.
For enterprise customers, the response will also include the customer_id and reference_id that were submitted with the test. operationId: POST-v2-preview-tests requestBody: content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest examples: Example: value: subject: Example subject html: ... transfer_encoding: base64 charset: utf-8 customer_id: '1' clients: - client1 - client2 content_checking: link_validation: true image_validation: true accessibility: true required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse examples: Example: value: id: exampleTestID customer_id: '1' warnings: - name: InvalidClient message: >- A client ID you have requested (ipadpro_11_15, ipadpro_12_15, iphonese2_15, iphone11pro_15, iphone12promax_15, iphone13promax_15) could not be found. It may be that the code does not exist or that it is no longer supported. content_checking: link_validation: items: id: 67b469d74b911fa30a4d782e links: self: /v1/inspect/links/67b469d74b911fa30a4d782e image_validation: items: id: 67b469d74b911fa30a4d782e links: self: /v1/inspect/images/67b469d74b911fa30a4d782e accessibility: items: id: 67b469d74b911fa30a4d782e links: self: /v1/inspect/accessibility/67b469d74b911fa30a4d782e '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v2/preview/tests/{test_id}/results/{client_id}: get: tags: - Email Preview summary: Get Test Results by client ID V2 description: >- This call returns detailed results for screenshots including their upload locations, send times, completion times, and information about bounces, if any. is a test ID returned from test creation or the get test list functions. The is required and restricts the returned data exclusively to the specified client. If the client is not present in the test or is invalid, an error will be returned. operationId: GET-v2-preview-tests--test-id--results--client-id- parameters: - name: test_id in: path description: Test to get results for required: true schema: type: string - name: client_id in: path description: Client to get results for required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse examples: Example: value: android10_gmailapp_pixel4_dm: id: android10_gmailapp_pixel4_dm displayname: Gmail App Pixel 4 client: Gmail App os: Android 10 (Dark Mode) category: Mobile browser: '' screenshots: default: https://images.emailonacid.com/123 thumbnail: https://images.emailonacid.com/1234 fullthumbnail: >- https://images.emailonacid.com/90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257 status: Complete statusdetails: submitted: 1741804257 completed: 1741804276 bouncecode: '' bouncemessage: '' '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v2/preview/tests/{test_id}: get: tags: - Email Preview summary: Get Emailpreview Test Information V2 description: >- Retrieves detailed information about a specific test, including the subject, submission time (in UNIX timestamp format), processing statuses, and any content checking results. The response includes one to three properties containing arrays of clients: completed (clients that have successfully uploaded screenshots), processing (clients that are still being processed by our system), and bounced (clients that were bounced by the destination and cannot be retried). Additionally, the system will automatically requeue screenshots if they remain in processing for more than three minutes. operationId: GET-v2-preview-tests--test-id- parameters: - name: test_id in: path description: The ID of the test to retrieve required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse examples: Example: value: subject: Example Subject date: 1739876826 completed: - client1 processing: - client2 bounced: - client3 content_checking: link_validation: items: links: {} image_validation: items: id: 67b469d74b911fa30a4d782e links: self: /v1/inspect/images/67b469d74b911fa30a4d782e accessibility: items: links: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] delete: tags: - Email Preview summary: Delete Emailpreview Test V2 description: >- Deletes the specified test and its content checking. Once it is deleted, it cannot be recovered. operationId: DELETE-v2-preview-tests--test-id- parameters: - name: test_id in: path description: Test to delete required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse examples: Example: value: success: true '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v2/preview/tests/{test_id}/exports/{job_id}: get: tags: - Email Preview summary: Retrieve Export Job Details for Email Preview Test Screenshots description: >- Retrieves the status and details of an export job created to collect screenshots for an Email Preview Test. Provide both the test ID and the job ID to fetch the export job information. operationId: GET-v2-preview-tests--test-id--exports--job-id- parameters: - name: test_id in: path description: Unique identifier of the Email Preview Test required: true schema: type: string - name: job_id in: path description: Unique identifier of the export job required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking examples: Example: value: job_id: 67b469d74b911fa30a4d782e test_id: 98b469d74b956fa30a4d125f clients: - android11_gmailapp_pixel5_dm - android12_gmailapp_pixel6_dm job_status: Completed zip_url: https://example.com/export.zip '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v2/preview/tests/{test_id}/exports: get: tags: - Email Preview summary: Retrieve Export Job Details for Email Preview Test Screenshots description: >- Retrieves the status and details of an export job created to collect screenshots for an Email Preview Test. Provide the test ID to fetch the latest export job information. operationId: GET-v2-preview-tests--test-id--exports parameters: - name: test_id in: path description: Unique identifier of the Email Preview Test required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking examples: Example: value: job_id: 67b469d74b911fa30a4d782e test_id: 98b469d74b956fa30a4d125f clients: - android11_gmailapp_pixel5_dm - android12_gmailapp_pixel6_dm job_status: Completed zip_url: https://example.com/export.zip '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] post: tags: - Email Preview summary: Create Export Job for Email Preview Test Screenshots description: >- Initiates an export job that collects screenshots for a specified Email Preview Test. Provide the list of client IDs whose screenshots you want to export. The job status can be monitored using the job ID returned in the response. operationId: POST-v2-preview-tests--test-id--exports parameters: - name: test_id in: path description: >- Unique identifier of the Email Preview Test to export screenshots for required: true schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateZipExport examples: Example: value: clients: - android11_gmailapp_pixel5_dm - android12_gmailapp_pixel6_dm required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking examples: Example: value: job_id: 67b469d74b911fa30a4d782e test_id: 98b469d74b956fa30a4d125f clients: - android11_gmailapp_pixel5_dm - android12_gmailapp_pixel6_dm job_status: Processing '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '401': description: A 401 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse security: - basicAuth: [] /v1/preview/sharing: post: tags: - Email Preview summary: Create PreviewShare description: Create a shareable link to an email preview test. operationId: POST-v1-preview-sharing requestBody: content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-api-CreatePreviewSharingRequest examples: Example: value: test_id: some-id required: true responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: record created '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/preview/sharing/{test_id}: get: tags: - Email Preview summary: Get PreviewShare description: Returns PreviewShare record by TID. operationId: GET-v1-preview-sharing--test-id- parameters: - name: test_id in: path description: Test to get required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse examples: Example: value: test_id: some-test-id url_uuid: some-uuid url: share.mailgun.com/email-previews/some-uuid enabled: true expires_at: 0001-01-01 00:00:00 +0000 UTC '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] put: tags: - Email Preview summary: Update PreviewShare description: Updates PreviewShare record enabled field. operationId: PUT-v1-preview-sharing--test-id- parameters: - name: test_id in: path description: Test to update required: true schema: type: string - name: url_uuid in: query description: UUID to update required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: record updated '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] delete: tags: - Email Preview summary: Delete PreviewShare description: Delete PreviewShare record by TID. operationId: DELETE-v1-preview-sharing--test-id- parameters: - name: test_id in: path description: Test to delete required: true schema: type: string - name: url_uuid in: query description: UUID to delete required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: record deleted '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/preview/sharing/{test_id}/rotate: post: tags: - Email Preview summary: Rotate PreviewShare description: Re-generates the uuid and share url, and resets the expiration. operationId: POST-v1-preview-sharing--test-id--rotate parameters: - name: test_id in: path description: Test to rotate required: true schema: type: string - name: url_uuid in: query description: UUID to rotate required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse examples: Example: value: test_id: some-test-id url_uuid: some-new-uuid url: share.mailgun.com/email-previews/some-new-uuid enabled: true expires_at: 0001-01-01 00:00:00 +0000 UTC '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/preview/sharing/public/{id}: get: tags: - Email Preview summary: Returns PreviewShare record by UUID. operationId: GET-v1-preview-sharing-public--id- parameters: - name: id in: path description: UUID to get required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-api-PreviewTestResultsResponse examples: Example: value: subject: some test date: 1 results: [] '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse 4xx: description: A 4xx response content: application/json: schema: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError security: - basicAuth: [] /v1/monitoring/domains: get: tags: - Domain Blocklist Monitoring summary: Get Monitored Domains description: Gets all domains that are being monitored for blocklisting operationId: api.(*HealthController).GetMonitoredDomainsRecords-fm-5 responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_DomainsResponse examples: Example: value: domains: - domain: yourdomain.com state: heathly updated_at: 2023-09-06 18:45:51 +0000 UTC - domain: yourotherdomain.com listed: - first_seen: 2023-01-02 02:14:27 +0000 UTC last_seen: 2023-09-06 18:45:51 +0000 UTC list: dbl.spamhaus.org name: Spamhaus DBL state: listed updated_at: 2023-09-06 18:45:51 +0000 UTC '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse examples: Example: value: message: reason for bad request security: - basicAuth: [] /v1/monitoring/domains/events: get: tags: - Domain Blocklist Monitoring summary: Get All Events description: Get all events for all domains monitored operationId: api.RegisterHealthController.PageHandler.func1-6 responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_EventsResponse examples: Example: value: events: - domain: yourotherdomain.com event: listed list: Spamhaus DBL name: Spamhaus DBL timestamp: 0001-01-01 00:00:00 +0000 UTC - domain: yourdomain.com event: delisted list: Spamhaus DBL name: Spamhaus DBL timestamp: 0001-01-01 00:00:00 +0000 UTC - domain: yourdomain.com event: listed list: Spamhaus DBL name: Spamhaus DBL timestamp: 0001-01-01 00:00:00 +0000 UTC '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse examples: Example: value: message: reason for bad request security: - basicAuth: [] /v1/monitoring/domains/{domain}/blocklists: get: tags: - Domain Blocklist Monitoring summary: Get Lists Domain is Listed in description: Get blocklists that the domain is listed in operationId: api.(*HealthController).GetListedIn-fm-7 parameters: - name: domain in: path description: The domain name required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_BlocklistResponse examples: Example: value: blocklists: - comments: - '' first_seen: 2023-01-02 02:14:27 +0000 UTC last_seen: 2023-09-06 18:45:51 +0000 UTC list: Spamhaus DBL name: Spamhaus DBL - comments: - '' first_seen: 2023-01-02 02:14:27 +0000 UTC last_seen: 2023-09-06 18:45:51 +0000 UTC list: SURBL name: SURBL '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse examples: Example: value: message: reason for bad request security: - basicAuth: [] /v1/monitoring/domains/{domain}/events: get: tags: - Domain Blocklist Monitoring summary: Get Events for Domain description: Get events for a specific domain operationId: api.RegisterHealthController.PageHandler.func2-8 parameters: - name: domain in: path description: The domain name required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_EventsResponse examples: Example: value: events: - domain: yourdomain.com event: delisted list: Spamhaus DBL name: Spamhaus DBL timestamp: 0001-01-01 00:00:00 +0000 UTC - domain: yourdomain.com event: listed list: Spamhaus DBL name: Spamhaus DBL timestamp: 0001-01-01 00:00:00 +0000 UTC '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse examples: Example: value: message: reason for bad request security: - basicAuth: [] /v1/spamtraps/totals: get: summary: Get Spam Trap Hits Total operationId: GET-v1-spamtraps-totals parameters: - name: start in: query description: >- The start date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: end in: query description: >- The end date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: sortby in: query description: >- Acceptable values include date, totals, domain, subject, ip, and from. Defaults to date. schema: type: string - name: groupby in: query description: >- Use this field to group results. Acceptable values include domain, subject, ip, and from. schema: type: string - name: subject in: query description: Use this field to filter results by email subject. schema: type: string - name: domain in: query description: Use this field to filter results by domain(s). schema: type: string - name: ip in: query description: Use this field to filter results by ip(s). schema: type: string - name: from in: query description: Use this field to filter results by sender email address. schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-GroupedTotalsResponse examples: Example: value: paging: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse tags: - openapi-spamtraps_other security: - basicAuth: [] /v1/spamtraps/filters: get: summary: Get Spam Trap Filters description: >- Get a list of domain, ip, subject, From that hit spamtraps, like spamtraps totals but no counts operationId: GET-v1-spamtraps-filters parameters: - name: start in: query description: >- The start date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: end in: query description: >- The end date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: sortby in: query description: >- Acceptable values include date, totals, domain, subject, ip, and from. Defaults to date. schema: type: string - name: groupby in: query description: >- Use this field to group results. Acceptable values include domain, subject, ip, and from. schema: type: string - name: subject in: query description: Use this field to filter results by email subject. schema: type: string - name: domain in: query description: Use this field to filter results by domain(s). schema: type: string - name: ip in: query description: Use this field to filter results by ip(s). schema: type: string - name: from in: query description: Use this field to filter results by sender email address. schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-FiltersResponse examples: Example: value: items: - example.com - domain.com paging: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse tags: - openapi-spamtraps_other security: - basicAuth: [] /v1/spamtraps: get: tags: - Spam Traps Monitoring summary: Get Spam Trap Hits description: >- Use this endpoint to understand how much of your mail being sent to known spam traps. This endpoint returns daily spam trap hit counts for a provided timerange, categorized by trap type. operationId: GET-v1-spamtraps parameters: - name: start in: query description: >- The start date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: end in: query description: >- The end date in UTC (format YYYY-MM-DD) of the timeframe for which you wish to see data. required: true schema: type: string - name: sortby in: query description: >- Acceptable values include date, totals, domain, subject, ip, and from. Defaults to date. schema: type: string - name: groupby in: query description: >- Use this field to group results. Acceptable values include domain, subject, ip, and from. schema: type: string - name: subject in: query description: Use this field to filter results by email subject. schema: type: string - name: domain in: query description: Use this field to filter results by domain(s). schema: type: string - name: ip in: query description: Use this field to filter results by ip(s). schema: type: string - name: from in: query description: Use this field to filter results by sender email address. schema: type: string - name: limit in: query description: Limits the number of items returned in a request required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-DatedTotalsResponse examples: Example: value: items: - date: '2022-01-01' pristine: 34 recycled: 258 typo: 178 total: 470 - date: '2022-01-02' pristine: 32 recycled: 75 typo: 150 total: 257 paging: {} '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: reason for bad request security: - basicAuth: [] /v4/inbox/seedlists: get: tags: - Inbox Placement summary: List Seed Lists operationId: GET-v4-inbox-seedlists parameters: - name: time_after in: query schema: type: string - name: time_before in: query schema: type: string - name: name in: query schema: type: string - name: cursor in: query schema: type: string - name: sort in: query schema: type: string - name: offset in: query schema: type: integer - name: ascending in: query schema: type: boolean - name: limit in: query schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: value: items: - kid: '' id: '' accountid: '' createdat: '0001-01-01T00:00:00Z' updatedat: '0001-01-01T00:00:00Z' lastresult: '0001-01-01T00:00:00Z' targetemail: '' sendingdomains: [] touched: false testprefix: '' seedfilter: '' providerfilter: [] mailinglist: '' previousmailinglist: '' createdts: 0 tags: {} stats: {} seedquality: 0 isautogenerated: false version: 0 originseedsemails: [] regenneeded: false regenat: '0001-01-01T00:00:00Z' total: 1 security: - basicAuth: [] post: tags: - Inbox Placement summary: Generate a New Seed List operationId: POST-v4-inbox-seedlists parameters: - name: sending_domains in: query description: Deprecated. schema: type: string - name: name in: query schema: type: string - name: provider_filter in: query description: Array of provider domains. Omitting means all providers. schema: type: string - name: remote_id in: query schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-KeyBox examples: Example: value: created_at: 0001-01-01 00:00:00 +0000 UTC updated_at: 0001-01-01 00:00:00 +0000 UTC last_result_at: 0001-01-01 00:00:00 +0000 UTC regen_at: 0001-01-01 00:00:00 +0000 UTC security: - basicAuth: [] /v4/inbox/seedlists/a: get: tags: - Inbox Placement summary: List Available Attributes for Seed Lists operationId: GET-v4-inbox-seedlists-a responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/seedlists/a/{attribute}: get: tags: - Inbox Placement summary: Get List of Values for Seed List Attribute operationId: GET-v4-inbox-seedlists-a--attribute- parameters: - name: attribute in: path required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/seedlists/_filters: get: tags: - Inbox Placement summary: Get List of Available Seed List Filters operationId: GET-v4-inbox-seedlists--filters responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/seedlists/{address}: get: tags: - Inbox Placement summary: Get Seed List operationId: GET-v4-inbox-seedlists--address- parameters: - name: address in: path required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError security: - basicAuth: [] put: tags: - Inbox Placement summary: Update Seed List operationId: PUT-v4-inbox-seedlists--address- parameters: - name: address in: path required: true schema: type: string - name: name in: query schema: type: string - name: provider_filter in: query description: Array of provider domains. Omitting means no changes. schema: type: string - name: regen in: query description: Regenerate the mailing_list. schema: type: boolean - name: sending_domains in: query description: Deprecated. schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-KeyBox examples: Example: value: created_at: 0001-01-01 00:00:00 +0000 UTC updated_at: 0001-01-01 00:00:00 +0000 UTC last_result_at: 0001-01-01 00:00:00 +0000 UTC regen_at: 0001-01-01 00:00:00 +0000 UTC '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError security: - basicAuth: [] delete: tags: - Inbox Placement summary: Delete a Seed List operationId: DELETE-v4-inbox-seedlists--address- parameters: - name: address in: path required: true schema: type: string responses: '200': description: A 200 response '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError security: - basicAuth: [] /v4/inbox/results: get: tags: - Inbox Placement summary: List Results description: Get the details for all placement test results. operationId: GET-v4-inbox-results parameters: - name: sender in: query schema: type: string - name: subject in: query schema: type: string - name: provider in: query schema: type: string - name: target_email in: query schema: type: string - name: time_after in: query schema: type: string - name: time_before in: query schema: type: string - name: cursor in: query schema: type: string - name: sort in: query schema: type: string - name: offset in: query schema: type: integer - name: ascending in: query schema: type: boolean - name: limit in: query schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: value: items: - basictestresult: rid: '' id: '' accountid: '' keyboxid: '' keyboxemail: '' subject: '' sender: '' prefix: '' createdat: '0001-01-01T00:00:00Z' updatedat: '0001-01-01T00:00:00Z' status: '' createdts: 0 headers: {} campaignid: '' sharingenabled: false sharingid: '' sharingexpiry: '0001-01-01T00:00:00Z' box: kid: '' id: '' accountid: '' createdat: '0001-01-01T00:00:00Z' updatedat: '0001-01-01T00:00:00Z' lastresult: '0001-01-01T00:00:00Z' targetemail: '' sendingdomains: [] touched: false testprefix: '' seedfilter: '' providerfilter: [] mailinglist: '' previousmailinglist: '' createdts: 0 tags: {} stats: {} seedquality: 0 isautogenerated: false version: 0 originseedsemails: [] regenneeded: false regenat: '0001-01-01T00:00:00Z' seedresults: [] spamassassin: isspam: false score: 0 required: 0 rules: [] stats: {} storagekey: '' body: '' total: 1 security: - basicAuth: [] /v4/inbox/results/a: get: tags: - Inbox Placement summary: List Available Attributes for Results description: The attributes that can have values listed (for autocomplete). operationId: GET-v4-inbox-results-a responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/results/a/{attribute}: get: tags: - Inbox Placement summary: Get List of Values for a Result Attribute description: For the given attribute list the known values (for autocomplete). operationId: GET-v4-inbox-results-a--attribute- parameters: - name: attribute in: path required: true schema: type: string - name: sender in: query schema: type: string - name: subject in: query schema: type: string - name: provider in: query schema: type: string - name: target_email in: query schema: type: string - name: time_after in: query schema: type: string - name: time_before in: query schema: type: string - name: cursor in: query schema: type: string - name: sort in: query schema: type: string - name: offset in: query schema: type: integer - name: ascending in: query schema: type: boolean - name: limit in: query schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/results/_filters: get: tags: - Inbox Placement summary: List available filters for Results description: The filters that can be used when querying for results. operationId: GET-v4-inbox-results--filters responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} security: - basicAuth: [] /v4/inbox/results/{result}: get: tags: - Inbox Placement summary: Get Result Details description: Get the details for a single result. operationId: GET-v4-inbox-results--result- parameters: - name: result in: path required: true schema: type: string - name: provider in: query schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response examples: Example: {} '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] delete: tags: - Inbox Placement summary: Delete Result description: Delete the result and all associated information. operationId: DELETE-v4-inbox-results--result- parameters: - name: result in: path required: true schema: type: string - name: provider in: query schema: type: string responses: '200': description: A 200 response '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v4/inbox/sharing/{result}: get: tags: - Inbox Placement summary: Get Result Sharing Status description: The sharing status of a result. operationId: GET-v4-inbox-sharing--result- parameters: - name: result in: path required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo examples: Example: value: expires_at: 0001-01-01 00:00:00 +0000 UTC '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] put: tags: - Inbox Placement summary: Update Result Sharing Status description: Change the sharing status of a result or create a new share URL operationId: PUT-v4-inbox-sharing--result- parameters: - name: result in: path required: true schema: type: string - name: enabled in: query required: true schema: type: boolean responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo examples: Example: value: expires_at: 0001-01-01 00:00:00 +0000 UTC '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v4/inbox/sharing/public/{shareid}: get: tags: - Inbox Placement summary: Get Result by a Share ID description: Get a result by the share ID. operationId: GET-v4-inbox-sharing-public--shareid- parameters: - name: shareid in: path required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-TestResult examples: Example: value: BasicTestResult: created_at: 0001-01-01 00:00:00 +0000 UTC updated_at: 0001-01-01 00:00:00 +0000 UTC sharing_expires_at: 0001-01-01 00:00:00 +0000 UTC spamassassin: {} '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v4/inbox/tests: post: tags: - Inbox Placement summary: Run Inbox Placement Test description: >- Create and run a new inbox placement test. Either 'html' or 'template_name' field should be provided. 'variables' are [Template variables](https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/#templates), which could be used in html or template. You can use next recipient variables inside Template variables, which will be filled for every seed automatically: %recipient.first_name%, %recipient.last_name%. operationId: POST-v4-inbox-tests requestBody: content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-CreateTestReq examples: Example: value: from: First Last subject: Buy our elephants html: >- Hello {{first_name}} {{last_name}}. Visit our new shop at {{address}}. Our elephants are the best. template_name: template1 variables: address: 108, Robinson Ave, Richmond first_name: '%recipient.first_name%' last_name: '%recipient.last_name%' seed_list: ibp-123@mailgun.com provider_filter: - gmail.com - hotmail.com required: true responses: '202': description: A 202 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-SpyCreateTestResp examples: Example: value: result_id: uuid4 links: results: https://api.mailgun.net/v4/inbox/results/uuid4 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse security: - basicAuth: [] /v4/inbox/providers: get: tags: - Inbox Placement summary: List Email Providers description: List all available email providers. operationId: GET-v4-inbox-providers responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-ListProvidersResp examples: Example: value: items: - PublicProvider: domain: example.com display_name: Example region: Global created_at: 0001-01-01 00:00:00 +0000 UTC updated_at: 0001-01-01 00:00:00 +0000 UTC unsupported_authentications: {} security: - basicAuth: [] /v1/maverick-score/total: get: tags: - Email Health Score summary: Get Email Health score and rates for account and subaccounts operationId: GET-v1-maverick-score-total responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-GetScoreResp examples: Example: value: score: 37 rates: bounce_rate: 9 complaint_rate: 19 trap_rate: 3 full_mailbox_rate: 3 bad_failure_rate: 29 counters: delivered: 100500 '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError examples: Example: value: Reason: Subscribe to an Mailgun Optimize plan '422': description: A 422 response content: application/json: schema: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError examples: Example: value: Reason: reason security: - basicAuth: [] /v1/maverick-score/grouped: get: tags: - Email Health Score summary: List Email Health score and rates grouped by domains/ips/subaccounts description: >- Show domains/ips/subdomains that sent more than 10,000 messages and have at least one delivery. operationId: GET-v1-maverick-score-grouped parameters: - name: skip in: query description: Skips N items in a response. schema: type: integer default: 0 - name: limit in: query description: Limits the number of items returned in a response. schema: type: integer maximum: 100 minimum: 1 default: 10 - name: group in: query description: The key to group score by. schema: type: string enum: - domain - ip - subaccount default: domain x-enumDescriptions: domain: Group by domain ip: Group by IP subaccount: Group by subaccount - name: query in: query description: 'Query filter, e.g.: ''domain:example.com''' schema: type: string - name: sort in: query description: >- Supports the following syntax 'sort=field:direction'. 'direction' must be one of asc, desc. Default 'direction' is asc. schema: type: string enum: - domain:asc - domain:desc - ip:asc - ip:desc - subaccount:asc - subaccount:desc - score:asc - score:desc - bounce_rate:asc - bounce_rate:desc - complaint_rate:asc - complaint_rate:desc - trap_rate:asc - trap_rate:desc - full_mailbox_rate:asc - full_mailbox_rate:desc - bad_failure_rate:asc - bad_failure_rate:desc - delivered:asc - delivered:desc responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-ListScoreResp examples: Example: value: items: - group_key: a.example.com score: 37 rates: bounce_rate: 9 complaint_rate: 19 trap_rate: 3 full_mailbox_rate: 3 bad_failure_rate: 29 counters: delivered: 100500 total: 1 '403': description: A 403 response content: application/json: schema: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError examples: Example: value: Reason: Subscribe to an Mailgun Optimize plan security: - basicAuth: [] /v1/dmarc/records/{domain}: get: tags: - DMARC Reports summary: Retrieves the DMARC DNS records to be used for configuration operationId: GET-v1-dmarc-records-domain- parameters: - $ref: '#/components/parameters/DMARC_Reports_domain' responses: '200': $ref: '#/components/responses/DMARC_Reports_records_200' security: - basicAuth: [] /v1/dmarc/setup: get: tags: - DMARC Reports summary: Checks if DMARC has been setup for user operationId: GET-v1-dmarc-setup- responses: '200': $ref: '#/components/responses/DMARC_Reports_setupCheck_200' security: - basicAuth: [] /v1/dmarc/referral: post: tags: - DMARC Reports summary: Gets referral link to redsift operationId: POST-v1-dmarc-referral- requestBody: $ref: '#/components/requestBodies/DMARC_Reports_refer_req' responses: '200': $ref: '#/components/responses/DMARC_Reports_referral_200' security: - basicAuth: [] /v1/dmarc/domains: get: tags: - DMARC Reports summary: Retrieves the list of domains that have DMARC monitoring. operationId: GET-v1-dmarc-domains- parameters: - $ref: '#/components/parameters/DMARC_Reports_fromParam' - $ref: '#/components/parameters/DMARC_Reports_toParam' responses: '200': $ref: '#/components/responses/DMARC_Reports_domainList_200' security: - basicAuth: [] /v1/dmarc/domains/{domain}: get: tags: - DMARC Reports summary: Retrieve DMARC reporting data for a domain. operationId: GET-v1-dmarc-domains-domain- parameters: - $ref: '#/components/parameters/DMARC_Reports_domain' - $ref: '#/components/parameters/DMARC_Reports_fromParam' - $ref: '#/components/parameters/DMARC_Reports_toParam' responses: '200': $ref: '#/components/responses/DMARC_Reports_domain_200' '404': description: Not found | Domain not managed by this account security: - basicAuth: [] /v1/dmarc/domains/{domain}/s/{source}: get: tags: - DMARC Reports summary: Retrieve DMARC reporting data from a specific source. operationId: GET-v1-dmarc-domains-domain-s-source- parameters: - $ref: '#/components/parameters/DMARC_Reports_domain' - $ref: '#/components/parameters/DMARC_Reports_source' - $ref: '#/components/parameters/DMARC_Reports_fromParam' - $ref: '#/components/parameters/DMARC_Reports_toParam' responses: '200': $ref: '#/components/responses/DMARC_Reports_source_200' '404': description: Not found | Source related to domain not found security: - basicAuth: [] /v1/dmarc/domains/{domain}/s/{source}/h/{host}: get: tags: - DMARC Reports summary: Retrieve DMARC reporting data for a hostname. operationId: GET-v1-dmarc-domains-domain-s-source-h-host- parameters: - $ref: '#/components/parameters/DMARC_Reports_domain' - $ref: '#/components/parameters/DMARC_Reports_source' - $ref: '#/components/parameters/DMARC_Reports_host' - $ref: '#/components/parameters/DMARC_Reports_fromParam' - $ref: '#/components/parameters/DMARC_Reports_toParam' responses: '200': $ref: '#/components/responses/DMARC_Reports_host_200' '404': description: Not found | Host related to source not found security: - basicAuth: [] /v1/dmarc/domains/{domain}/s/{source}/h/{host}/ip/{ip}: get: tags: - DMARC Reports summary: Retrieve DMARC reporting data for an IP Address. operationId: GET-v1-dmarc-domains-domain-s-source-h-host-ip-ip- parameters: - $ref: '#/components/parameters/DMARC_Reports_domain' - $ref: '#/components/parameters/DMARC_Reports_source' - $ref: '#/components/parameters/DMARC_Reports_host' - $ref: '#/components/parameters/DMARC_Reports_ip' - $ref: '#/components/parameters/DMARC_Reports_fromParam' - $ref: '#/components/parameters/DMARC_Reports_toParam' responses: '200': $ref: '#/components/responses/DMARC_Reports_ip_200' '404': description: Not found | IP related to host not found security: - basicAuth: [] /v1/reputationanalytics/gtoken: get: operationId: GET-v1-reputationanalytics-gtoken responses: {} tags: - openapi-reputationanalytics_other security: - basicAuth: [] delete: operationId: DELETE-v1-reputationanalytics-gtoken responses: {} tags: - openapi-reputationanalytics_other security: - basicAuth: [] patch: operationId: PATCH-v1-reputationanalytics-gtoken responses: {} tags: - openapi-reputationanalytics_other security: - basicAuth: [] /v1/reputationanalytics/gpt/domains/{domain}: get: tags: - Google Postmaster Tools summary: Get GPT Domain description: >- Returns domain records for a single domain on the account. Each domain record is for a single domain on a single day. operationId: GET-v1-reputationanalytics-gpt-domains--domain- parameters: - name: domain in: path required: true schema: type: string - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse examples: Example: value: domain: test.com data: - name: test.com date: 0001-01-01 00:00:00 +0000 UTC '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/domains: get: tags: - Google Postmaster Tools summary: Get GPT Domains description: >- Returns a list of all domain records for an account. Each domain record is for a single domain on a single day. operationId: GET-v1-reputationanalytics-gpt-domains parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse examples: Example: value: domain: test.com data: - name: test.com date: 0001-01-01 00:00:00 +0000 UTC '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/domainsfbl: get: tags: - Google Postmaster Tools summary: Get GPT FBL description: Returns the FBL for the account or domain operationId: GET-v1-reputationanalytics-gpt-domainsfbl parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse examples: Example: value: data: - name: test.com id: identifier ratio: 0.001 date: 0001-01-01 00:00:00 +0000 UTC total: 1 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/domainsfbl/{domain}: get: tags: - Google Postmaster Tools summary: Get GPT FBL description: Returns the FBL for the account or domain operationId: GET-v1-reputationanalytics-gpt-domainsfbl--domain- parameters: - name: domain in: path required: true schema: type: string - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse examples: Example: value: data: - name: test.com id: identifier ratio: 0.001 date: 0001-01-01 00:00:00 +0000 UTC total: 1 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/addresses/{address}: get: tags: - Google Postmaster Tools summary: Get GPT Address description: >- Returns address records for an single address on the account. Each address record is for a single address on a single day. operationId: GET-v1-reputationanalytics-gpt-addresses--address- parameters: - name: address in: path required: true schema: type: string - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse examples: Example: value: address: 0.0.0.0 data: - address: 0.0.0.0 domain_name: test.com reputation: BAD '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/addresses: get: tags: - Google Postmaster Tools summary: Get GPT Addresses description: >- Returns a list of all address records for an account. Each address record is for a single address on a single day. operationId: GET-v1-reputationanalytics-gpt-addresses parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse examples: Example: value: address: 0.0.0.0 data: - address: 0.0.0.0 domain_name: test.com reputation: BAD '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/domains/{domain}/addresses: get: tags: - Google Postmaster Tools summary: Get GPT Domain Addresses description: >- Returns a list of all address records for an account belonging to a specific domain. Each address record is for a single address on a single day. operationId: GET-v1-reputationanalytics-gpt-domains--domain--addresses parameters: - name: domain in: path required: true schema: type: string - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainAddressResponse examples: Example: value: domain: test.com data: - address: 0.0.0.0 domain_name: test.com reputation: BAD '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/summary: get: tags: - Google Postmaster Tools summary: Get GPT Summary description: >- Returns a list of all summary records for an account. Each record is for a single domain's summary and error summary data. operationId: GET-v1-reputationanalytics-gpt-summary parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer - name: sortBy in: query description: Field name to sort by. required: true schema: type: string - name: orderBy in: query description: '''Asc'' or ''desc'' sorting.' required: true schema: type: string - name: searchField in: query description: 'Value of the domain to search, example: mailgun.com' required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-SummaryResponse examples: Example: value: summary: - name: test.com '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/summary/domains: get: tags: - Google Postmaster Tools summary: Get GPT Domains Summary description: >- Returns a list of all domain summary records for an account. Each record is for a single domain's summary data. operationId: GET-v1-reputationanalytics-gpt-summary-domains parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer - name: sortBy in: query description: Field name to sort by. required: true schema: type: string - name: orderBy in: query description: '''Asc'' or ''desc'' sorting.' required: true schema: type: string - name: searchField in: query description: 'Value of the domain to search, example: mailgun.com' required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainSummaryResponse examples: Example: value: summary: - name: test.com '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/summary/errors: get: tags: - Google Postmaster Tools summary: Get GPT Domains Error Summary description: >- Returns a list of all domain error summary records for an account. Each record is for a single domain's error summary data. operationId: GET-v1-reputationanalytics-gpt-summary-errors parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer - name: sortBy in: query description: Field name to sort by. required: true schema: type: string - name: orderBy in: query description: '''Asc'' or ''desc'' sorting.' required: true schema: type: string - name: searchField in: query description: 'Value of the domain to search, example: mailgun.com' required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainErrorSummaryResponse examples: Example: value: summary: - name: test.com '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/gpt/summary/addresses: get: tags: - Google Postmaster Tools summary: Get GPT Addresses Summary description: >- Returns a list of all address summary records for an account. Each record is for a single address's summary data. operationId: GET-v1-reputationanalytics-gpt-summary-addresses parameters: - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: offset in: query description: The record number to begin pagination with. required: true schema: type: integer - name: limit in: query description: The number of records to return. required: true schema: type: integer - name: timeRangeStart in: query description: Unix timestamp starting time filter. required: true schema: type: integer - name: timeRangeEnd in: query description: Unix timestamp ending time filter. required: true schema: type: integer - name: sortBy in: query description: Field name to sort by. required: true schema: type: string - name: orderBy in: query description: '''Asc'' or ''desc'' sorting.' required: true schema: type: string - name: searchField in: query description: 'Value of the address to search, example: 127.0.0.1' required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse examples: Example: value: summary: - domain_name: test.com address: 0.0.0.0 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/snds: get: operationId: GET-v1-reputationanalytics-snds responses: {} tags: - openapi-reputationanalytics_other security: - basicAuth: [] put: summary: A test endpoint operationId: PUT-v1-reputationanalytics-snds responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] /v1/reputationanalytics/snds/{ip}: get: tags: - Microsoft SNDS summary: Get SNDS Address Info description: >- Returns a list of all address summary records for an account. Each record is for a single address's summary data. operationId: GET-v1-reputationanalytics-snds--ip- parameters: - name: ip in: path required: true schema: type: string - name: X-Mailgun-Account-Id in: header description: The account id required: true schema: type: string - name: Skip in: query description: The record number to begin pagination with. required: true schema: type: integer - name: SortBy in: query description: Field name to sort by. required: true schema: type: string - name: OrderBy in: query description: '''asc'' or ''desc'' sorting.' required: true schema: type: string - name: Search in: query description: Value of the address to search required: true schema: type: string responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse examples: Example: value: summary: - domain_name: test.com address: 0.0.0.0 '400': description: A 400 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError '404': description: A 404 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError '500': description: A 500 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse examples: Example: value: message: Internal Server Error security: - basicAuth: [] /v1/reputationanalytics/snds/ip/sync: get: summary: A test endpoint operationId: GET-v1-reputationanalytics-snds-ip-sync responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] put: summary: A test endpoint operationId: PUT-v1-reputationanalytics-snds-ip-sync responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] post: summary: A test endpoint operationId: POST-v1-reputationanalytics-snds-ip-sync responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] delete: summary: A test endpoint operationId: DELETE-v1-reputationanalytics-snds-ip-sync responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] patch: summary: A test endpoint operationId: PATCH-v1-reputationanalytics-snds-ip-sync responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] /v1/reputationanalytics/snds/ip/sync/force: post: summary: A test endpoint operationId: POST-v1-reputationanalytics-snds-ip-sync-force responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] /v1/reputationanalytics/snds/ip/sync/wipe: delete: summary: A test endpoint operationId: DELETE-v1-reputationanalytics-snds-ip-sync-wipe responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] /v1/reputationanalytics/snds/ip/sync/update: put: summary: A test endpoint operationId: PUT-v1-reputationanalytics-snds-ip-sync-update responses: '200': description: A 200 response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse examples: Example: value: items: [] default: description: A default response content: application/json: schema: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError tags: - openapi-reputationanalytics_other security: - basicAuth: [] components: schemas: github.com-mailgun-alerts-internal-api-ListAlertsEventsResp: type: object properties: events: type: array items: type: string required: - events github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message github.com-mailgun-alerts-internal-settings-ChannelSettings: type: object properties: url: type: string description: For webhook channel. emails: type: array items: type: string description: For email channel channel_ids: type: array items: type: string description: For slack channel github.com-mailgun-alerts-internal-settings-EventSettings: type: object properties: id: type: string format: uuid description: The unique identifier for the alert settings record. event_type: type: string description: The event type that is alerted on. channel: type: string description: The delivery channel for the alert. settings: type: object allOf: - $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-ChannelSettings description: This object contains channel-specific settings. disabled_at: type: - string - 'null' format: date-time description: Read only. When present required: - event_type - channel - settings github.com-mailgun-alerts-internal-api-mutateEventSettingReq: type: object properties: event_type: type: string description: The type of event for which you would like to receive alerts. channel: type: string description: >- The delivery method for the alert. Supported values include 'webhook' settings: type: object allOf: - $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-ChannelSettings description: >- The details pertaining to the specified channel. Please note that the contents of this object differ per channel type. required: - event_type - channel - settings github.com-mailgun-alerts-internal-settings-Webhooks: type: object properties: signing_key: type: string required: - signing_key github.com-mailgun-alerts-internal-settings-Slack: type: object properties: token: type: string team_id: type: - string - 'null' team_name: type: - string - 'null' scope: type: - string - 'null' required: - token - team_id - team_name - scope github.com-mailgun-alerts-internal-api-SettingsResponse: type: object properties: events: type: array items: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-EventSettings webhooks: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-Webhooks slack: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-settings-Slack required: - events - webhooks - slack github.com-mailgun-alerts-internal-api-ResetWebhooksSigningKeyResp: type: object properties: signing_key: type: string required: - signing_key github.com-mailgun-alerts-internal-api-TestWebhookRequest: type: object properties: event_type: type: string url: type: string required: - event_type - url github.com-mailgun-alerts-internal-api-TestEmailRequest: type: object properties: event_type: type: string emails: type: array items: type: string required: - event_type - emails github.com-mailgun-alerts-internal-api-TestSlackRequest: type: object properties: event_type: type: string channel_ids: type: array items: type: string description: If omitted would be taken from the event settings required: - event_type github.com-mailgun-alerts-internal-api-SlackChannel: type: object properties: id: type: string name: type: string is_archived: type: boolean required: - id - name - is_archived github.com-mailgun-alerts-internal-api-ListSlackChannelsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/github.com-mailgun-alerts-internal-api-SlackChannel required: - items Bounce_Classification_github.com-mailgun-bounce-classification-entities-Subaccount: type: object properties: id: type: string required: - id Bounce_Classification_github.com-mailgun-bounce-classification-entities-Domain: type: object properties: name: type: string required: - name Bounce_Classification_github.com-mailgun-bounce-classification-entities-BouncedStat: type: object properties: total: type: integer format: int32 required: - total Bounce_Classification_github.com-mailgun-bounce-classification-entities-Stat: type: object properties: subaccount: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Subaccount domain: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Domain rule-id: type: string entity-id: type: string short-explanation: type: string bounced: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-BouncedStat full_mailbox: type: integer format: int32 description: Not compatible with 'group' param. required: - bounced Bounce_Classification_github.com-mailgun-holster-v4-clock-DurationJSON: type: object properties: Duration: type: integer format: int64 required: - Duration Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListStatsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Stat _duration: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-holster-v4-clock-DurationJSON required: - items - _duration Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-UpdateStatsReq: type: object properties: is-dismissed: type: boolean required: - is-dismissed Bounce_Classification_github.com-mailgun-bounce-classification-entities-AccountStat: type: object properties: domain: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Domain bounced: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-BouncedStat required: - domain - bounced Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListAccountStatsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-AccountStat total: type: integer format: int32 req: type: object required: - items Bounce_Classification_github.com-mailgun-bounce-classification-entities-DomainStat: type: object properties: entity-id: type: string entity-name: type: string bounced: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-BouncedStat required: - entity-id - entity-name - bounced Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListDomainStatsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-DomainStat required: - items Bounce_Classification_github.com-mailgun-bounce-classification-entities-EntityStat: type: object properties: rule-id: type: string category: type: string severity: type: string sample-text: type: string explanation: type: string bounced: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-BouncedStat required: - rule-id - category - severity - sample-text - explanation - bounced Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListEntityStatsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-EntityStat required: - items Bounce_Classification_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message Bounce_Classification_github.com-mailgun-bounce-classification-entities-Classification: type: object properties: reason: type: string rule-id: type: string response-code: type: integer format: int32 required: - reason Bounce_Classification_github.com-mailgun-bounce-classification-entities-DeliveryStatus: type: object properties: message: type: string required: - message Bounce_Classification_github.com-mailgun-bounce-classification-entities-Envelope: type: object properties: sending-ip: type: string required: - sending-ip Bounce_Classification_github.com-mailgun-bounce-classification-entities-LogEvent: type: object properties: id: type: string i-classification: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Classification delivery-status: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-DeliveryStatus envelope: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-Envelope '@timestamp': type: string required: - i-classification - delivery-status - envelope - '@timestamp' Bounce_Classification_github.com-mailgun-scaffold-httpapi-paging-PagingResponse: type: object properties: previous: type: string first: type: string next: type: string last: type: string required: - previous - first - next - last Bounce_Classification_github.com-mailgun-bounce-classification-internal-api-ListEventsResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-entities-LogEvent paging: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-scaffold-httpapi-paging-PagingResponse _from: type: string format: date-time required: - items - paging Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Entity: type: object properties: name: type: string required: - name Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Entities: type: object additionalProperties: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Entity Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Rule: type: object properties: entity_id: type: string class: type: string sample-text: type: string explanation: type: string short-explanation: type: string Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Rules: type: object additionalProperties: $ref: >- #/components/schemas/Bounce_Classification_github.com-mailgun-bounce-classification-internal-config-Rule Inbox_Ready_github.com-mailgun-inboxready-model-Verified: type: object properties: verified_at: type: integer format: int64 status: type: string required: - verified_at - status Inbox_Ready_github.com-mailgun-inboxready-model-Domain: type: object properties: created_at: type: integer format: int64 name: type: string verified: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Verified services: type: object additionalProperties: type: boolean txt_record: type: string required: - created_at - name - verified - services - txt_record Inbox_Ready_github.com-mailgun-scaffold-httpapi-paging-PagingResponse: type: object properties: previous: type: string first: type: string next: type: string last: type: string required: - previous - first - next - last Inbox_Ready_github.com-mailgun-inboxready-api-DomainListResponse: type: object properties: items: type: array items: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Domain paging: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-paging-PagingResponse required: - items Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError: type: object properties: Reason: type: string required: - Reason Inbox_Ready_github.com-mailgun-inboxready-api-AddDomainResponse: type: object properties: message: type: string domain: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Domain required: - message - domain Inbox_Ready_github.com-mailgun-inboxready-api-DeleteDomainResponse: type: object properties: message: type: string required: - message Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse: type: object properties: message: type: string required: - message Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist: type: object properties: list: type: string delist_requested_at: type: string format: date-time first_seen: type: string format: date-time last_seen: type: string format: date-time comments: type: array items: type: string name: type: string required: - list - delist_requested_at - last_seen - comments Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress: type: object properties: ip: type: string ip_pool: type: string description: type: string state: type: string listed: type: array items: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist required: - ip - ip_pool - description - state - listed Inbox_Ready_github.com-mailgun-inboxready-api-ListIPAddressesResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress required: - items Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message Inbox_Ready_github.com-mailgun-inboxready-api-CreateIPAddressReq: type: object properties: ip: type: string ip_pool: type: string description: type: string required: - ip - ip_pool - description Inbox_Ready_github.com-mailgun-inboxready-api-UpdateIPAddressReq: type: object properties: ip_pool: type: string description: type: string required: - ip_pool - description Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientInfo: type: object properties: id: type: string client: type: string os: type: string category: type: string browser: type: string rotate: type: boolean image_blocking: type: boolean free: type: boolean default: type: boolean ext: type: string required: - id - client - os - category Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientsResponse: type: object properties: clients: type: object additionalProperties: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientInfo required: - clients Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError: type: object properties: Reason: type: string required: - Reason Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Error: type: object properties: name: type: string message: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse: type: object properties: error: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Error Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Warning: type: object properties: name: type: string message: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Links: type: object properties: self: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Item: type: object properties: id: type: string links: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Links Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-ErrorDetail: type: object properties: status: type: string title: type: string detail: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse: type: object properties: items: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Item errors: type: array items: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-ErrorDetail Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult: type: object properties: link_validation: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse image_validation: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse accessibility: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse: type: object properties: id: type: string reference_id: type: string customer_id: type: string spam: type: object properties: key: type: string address_list: type: array items: type: string warnings: type: array items: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Warning content_checking: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking: type: object properties: link_validation: type: boolean image_validation: type: boolean accessibility: type: boolean Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest: type: object properties: subject: type: string html: type: string mime: type: string url: type: string transfer_encoding: type: string charset: type: string reference_id: type: string customer_id: type: string clients: type: array items: type: string image_blocking: type: boolean headers: type: object additionalProperties: type: string spam: type: object properties: test_method: type: string from_address: type: string key: type: string smtp_info: type: object properties: host: type: string port: type: integer format: int32 secure: type: string username: type: string password: type: string content_checking: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking required: - subject Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse: type: array items: type: object properties: id: type: string date: type: integer format: int32 type: type: string subject: type: string headers: type: object additionalProperties: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult: type: object properties: id: type: string display_name: type: string client: type: string os: type: string category: type: string browser: type: string screenshots: type: object additionalProperties: type: string thumbnail: type: string full_thumbnail: type: string status: type: string status_details: type: object properties: submitted: type: integer format: int32 completed: type: integer format: int32 bounce_code: type: string bounce_message: type: string Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse: type: object additionalProperties: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse: type: object properties: success: type: boolean required: - success Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessInfo: type: object properties: success: type: boolean remaining_reprocesses: type: integer format: int32 regional: type: boolean screenshot: type: object properties: id: type: string type: type: string sent: type: integer format: int32 completed: type: integer format: int32 required: - regional Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessTestResponse: type: object additionalProperties: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessInfo Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse: type: object properties: content: type: string required: - content Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse: type: object properties: subject: type: string date: type: integer format: int32 completed: type: array items: type: string processing: type: array items: type: string bounced: type: array items: type: string content_checking: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult required: - subject - date Email_Preview_API_github.com-mailgun-emailpreview-address-PreviewAddressResponse: type: object properties: preview_address: type: string required: - preview_address Email_Preview_API_string: type: string Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-APIError: type: object properties: code: type: string message: type: string required: - code - message Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking: type: object properties: job_id: type: string test_id: type: string clients: type: array items: type: string job_status: type: string zip_url: type: string failed_clients: type: array items: type: string error: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-APIError required: - job_id - test_id - clients - job_status Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateZipExport: type: object properties: clients: type: array items: type: string test_id: type: string required: - clients - test_id Email_Preview_API_github.com-mailgun-emailpreview-api-CreatePreviewSharingRequest: type: object properties: test_id: type: string required: - test_id Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse: type: object properties: test_id: type: string url_uuid: type: string url: type: string enabled: type: boolean expires_at: type: string format: date-time required: - test_id - url_uuid - url - enabled - expires_at Email_Preview_API_github.com-mailgun-emailpreview-api-PreviewTestResultsResponse: type: object properties: subject: type: string date: type: integer format: int32 results: type: array items: $ref: >- #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult required: - subject - date - results Domain_Blocklist_Monitoring_DomainsResponse: type: object properties: domains: type: array items: type: object properties: domain: type: string listed: type: array items: type: object properties: last_seen: type: string format: date-time name: type: string first_seen: type: string format: date-time list: type: string comments: type: array items: type: string required: - list - comments updated_at: type: string format: date-time '-': type: integer format: int64 state: type: string required: - domain - '-' - '-' - updated_at - state - listed required: - domains Domain_Blocklist_Monitoring_GenericResponse: type: object properties: message: type: string required: - message Domain_Blocklist_Monitoring_paging: type: object properties: first: type: string previous: type: string next: type: string last: type: string required: - previous - first - next - last Domain_Blocklist_Monitoring_EventsResponse: type: object properties: events: type: array items: type: object properties: name: type: string timestamp: type: string format: date-time '-': type: string domain: type: string list: type: string event: type: string required: - timestamp - '-' - event - domain - '-' - list paging: $ref: '#/components/schemas/Domain_Blocklist_Monitoring_paging' required: - events - paging Domain_Blocklist_Monitoring_BlocklistResponse: type: object properties: blocklists: type: array items: type: object properties: comments: type: array items: type: string list: type: string first_seen: type: string format: date-time name: type: string last_seen: type: string format: date-time required: - list - comments required: - blocklists Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-GroupedTotals: type: object properties: subject: type: string domain: type: string ip: type: string from: type: string pristine: type: integer format: int32 recycled: type: integer format: int32 typo: type: integer format: int32 harvested: type: integer format: int32 total: type: integer format: int32 required: - pristine - recycled - typo - harvested - total Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse: type: object properties: first: type: string previous: type: string next: type: string required: - first - previous - next Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-GroupedTotalsResponse: type: object properties: items: type: array items: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-GroupedTotals paging: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse required: - items - paging Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-FiltersResponse: type: object properties: items: type: array items: type: string paging: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse required: - items - paging Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-DatedTotals: type: object properties: date: type: string pristine: type: integer format: int32 recycled: type: integer format: int32 typo: type: integer format: int32 harvested: type: integer format: int32 total: type: integer format: int32 required: - date - pristine - recycled - typo - harvested - total Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-DatedTotalsResponse: type: object properties: items: type: array items: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-DatedTotals paging: $ref: >- #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse required: - items - paging Service_Documentation_github.com-mailgun-spy-model-KeyBox: type: object properties: kid: type: string created_at: type: string format: date-time updated_at: type: string format: date-time last_result_at: type: string format: date-time target_email: type: string sending_domains: type: array items: type: string has_results: type: boolean name: type: string seed_filter: type: string provider_filter: type: array items: type: string description: '[] means all providers; null means that only seed_filter is used' mailing_list: type: string previous_mailing_list: type: string description: List before last regen tags: type: object additionalProperties: type: string delivery_stats: type: object additionalProperties: type: object properties: delivered: type: integer format: int32 missing: type: integer format: int32 pending: type: integer format: int32 spam: type: integer format: int32 inbox: type: integer format: int32 total: type: integer format: int32 provider: type: string categories: type: object additionalProperties: type: integer format: int32 required: - delivered - missing - pending - spam - inbox - total - provider - categories is_auto_generated: type: boolean version: type: integer format: int32 regen_needed: type: boolean description: >- Shows that mailing_list has to many unavailable seeds. Only for v2 Seed List. regen_at: type: string format: date-time required: - kid - created_at - updated_at - last_result_at - target_email - sending_domains - has_results - name - seed_filter - provider_filter - mailing_list - previous_mailing_list - tags - is_auto_generated - version - regen_needed - regen_at Service_Documentation_github.com-mailgun-scaffold-httpapi-Response: type: object additionalProperties: type: object Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError: type: object properties: Description: type: string required: - Description Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo: type: object properties: result_id: type: string expires_at: type: string format: date-time enabled: type: boolean url_id: type: string url: type: string api_url: type: string required: - result_id - expires_at - enabled - url_id - url - api_url Service_Documentation_github.com-mailgun-spy-model-MessageHeader: type: object properties: key: type: string value: type: string required: - key - value Service_Documentation_github.com-mailgun-spy-spamassassin-Result: type: object properties: is_spam: type: boolean score: type: number format: float required: type: number format: float rules: type: array items: type: object properties: name: type: string points: type: number format: float short_description: type: string long_description: type: string required: - name - points - short_description - long_description required: - is_spam - score - required - rules Service_Documentation_github.com-mailgun-spy-model-TestResult: type: object properties: rid: type: string result_id: type: string keybox_email: type: string subject: type: string sender: type: string seedlist_name: type: string created_at: type: string format: date-time updated_at: type: string format: date-time status: type: string attributes: type: object additionalProperties: type: string campaign_id: type: string sharing_enabled: type: boolean sharing_id: type: string sharing_expires_at: type: string format: date-time seed_results: type: array items: type: object properties: email: type: string provider: type: string destination: type: string state: type: string originating_ip: type: string tags: type: array items: type: string dkim: type: string spf: type: string dmarc: type: string headers: type: array items: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-MessageHeader extensions: type: object properties: category: type: string required: - category required: - email - provider - destination - state - originating_ip - tags - extensions spamassassin: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-spamassassin-Result delivery_stats: type: object additionalProperties: type: object properties: delivered: type: integer format: int32 missing: type: integer format: int32 pending: type: integer format: int32 spam: type: integer format: int32 inbox: type: integer format: int32 total: type: integer format: int32 provider: type: string categories: type: object additionalProperties: type: integer format: int32 required: - delivered - missing - pending - spam - inbox - total - provider - categories body: type: string description: Only for GET /inbox/results/{result} required: - rid - result_id - keybox_email - subject - sender - seedlist_name - created_at - updated_at - status - attributes - campaign_id - sharing_enabled - sharing_id - sharing_expires_at - seed_results - spamassassin - delivery_stats - body Service_Documentation_github.com-mailgun-spy-api-CreateTestRespLinks: type: object properties: results: type: string required: - results Service_Documentation_github.com-mailgun-spy-api-SpyCreateTestResp: type: object properties: result_id: type: string links: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-CreateTestRespLinks required: - result_id - links Service_Documentation_github.com-mailgun-spy-api-CreateTestReq: type: object properties: from: type: string subject: type: string html: type: string template_name: type: string description: template from Mailgun Send variables: type: object additionalProperties: type: string seed_list: type: string description: Use existing Seed List. If omitted creates new Seed List provider_filter: type: array items: type: string description: missing/null/[] means all providers required: - from - subject Service_Documentation_github.com-mailgun-spy-api-UnsupportedAuthentications: type: object properties: dkim: type: boolean spf: type: boolean dmarc: type: boolean required: - dkim - spf - dmarc Service_Documentation_github.com-mailgun-spy-api-Provider: type: object properties: domain: type: string display_name: type: string region: type: string created_at: type: string format: date-time updated_at: type: string format: date-time max_email_count: type: integer format: int32 seeds_limit: type: integer format: int32 unsupported_authentications: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-UnsupportedAuthentications virtual: type: boolean required: - domain - display_name - region - created_at - updated_at - max_email_count - seeds_limit - unsupported_authentications - virtual Service_Documentation_github.com-mailgun-spy-api-ListProvidersResp: type: object properties: items: type: array items: $ref: >- #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-Provider required: - items Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates: type: object properties: bounce_rate: type: integer format: int32 complaint_rate: type: integer format: int32 trap_rate: type: integer format: int32 full_mailbox_rate: type: integer format: int32 bad_failure_rate: type: integer format: int32 required: - bounce_rate - complaint_rate - trap_rate - full_mailbox_rate - bad_failure_rate Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters: type: object properties: delivered: type: integer format: int64 required: - delivered Maverick_Score_github.com-mailgun-maverick-score-internal-api-GetScoreResp: type: object properties: score: type: integer format: int32 rates: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates counters: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters required: - score - rates - counters Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError: type: object properties: Reason: type: string required: - Reason Maverick_Score_github.com-mailgun-maverick-score-internal-api-ListScoreResp: type: object properties: items: type: array items: type: object properties: group_key: type: string score: type: integer format: int32 rates: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates counters: $ref: >- #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters required: - group_key - score - rates - counters total: type: integer format: int64 required: - items - total DMARC_Reports_ReferReq: title: A referral request type: object properties: email: type: string description: Email required: - email reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError: type: object properties: Reason: type: string required: - Reason reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError: type: object properties: Description: type: string required: - Description reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse: type: object properties: message: type: string required: - message reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DeliveryError: type: object properties: error_class: type: string error_type: type: string error_ratio: type: number format: float required: - error_class - error_type - error_ratio reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-IPCount: type: object properties: reputation: type: integer format: int32 total: type: integer format: int64 required: - reputation - total reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoop: type: object properties: id: type: string spam_ratio: type: number format: float required: - id - spam_ratio reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-Domain: type: object properties: account_id: type: string name: type: string user_reported_spam_ratio: type: number format: float spf_success_ratio: type: number format: float dkim_success_ratio: type: number format: float dmarc_success_ratio: type: number format: float inbound_encryption_ratio: type: number format: float delivery_error_ratio: type: number format: float delivery_errors: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DeliveryError reputation: type: integer format: int32 date: type: string format: date-time ip_counts: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-IPCount feedback_loops: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoop required: - name - user_reported_spam_ratio - spf_success_ratio - dkim_success_ratio - dmarc_success_ratio - inbound_encryption_ratio - delivery_error_ratio - delivery_errors - reputation - date - ip_counts - feedback_loops reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse: type: object properties: domain: type: string data: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-Domain total: type: integer format: int32 required: - domain - data - total reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoopAggr: type: object properties: name: type: string id: type: string ratio: type: number format: float date: type: string format: date-time required: - name - id - ratio - date reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse: type: object properties: data: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoopAggr total: type: integer format: int32 required: - data - total reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress: type: object properties: address: type: string domain_name: type: string reputation: type: integer format: int32 date: type: string format: date-time required: - address - domain_name - reputation - date reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse: type: object properties: address: type: string data: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress total: type: integer format: int32 required: - address - data - total reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainAddressResponse: type: object properties: domain: type: string data: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress total: type: integer format: int32 required: - domain - data - total reputationanalytics_github.com-mailgun-reputationanalytics-api-Summary: type: object properties: name: type: string reputation: type: number format: float user_reported_spam_ratio: type: number format: float delivery_error_ratio: type: number format: float required: - name - reputation - user_reported_spam_ratio - delivery_error_ratio reputationanalytics_github.com-mailgun-reputationanalytics-api-SummaryResponse: type: object properties: summary: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-Summary total: type: integer format: int32 required: - summary - total reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainSummary: type: object properties: name: type: string user_reported_spam_ratio: type: number format: float spf_success_ratio: type: number format: float dkim_success_ratio: type: number format: float dmarc_success_ratio: type: number format: float inbound_encryption_ratio: type: number format: float reputation: type: number format: float required: - name - user_reported_spam_ratio - spf_success_ratio - dkim_success_ratio - dmarc_success_ratio - inbound_encryption_ratio - reputation reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainSummaryResponse: type: object properties: summary: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainSummary total: type: integer format: int32 required: - summary - total reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainErrorSummary: type: object properties: name: type: string delivery_error_ratio: type: number format: float required: - name - delivery_error_ratio reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainErrorSummaryResponse: type: object properties: summary: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainErrorSummary total: type: integer format: int32 required: - summary - total reputationanalytics_github.com-mailgun-reputationanalytics-models-address-AddressSummary: type: object properties: domain_name: type: string address: type: string reputation: type: number format: float required: - domain_name - address - reputation reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse: type: object properties: summary: type: array items: $ref: >- #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-AddressSummary ip_counts: type: object additionalProperties: type: integer format: int32 total: type: integer format: int32 required: - summary - ip_counts - total reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse: type: object properties: items: type: array items: type: string required: - items securitySchemes: basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Bounce_Classification_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Inbox_Ready_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Email_Preview_API_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Domain_Blocklist_Monitoring_basicAuth: type: http scheme: basic description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) Spamtraps_Analytics_Service_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Service_Documentation_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic Maverick_Score_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic DMARC_Reports_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic reputationanalytics_basicAuth: type: http description: >- HTTP Basic auth using api:YOUR_API_KEY. See [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/) scheme: basic parameters: DMARC_Reports_fromParam: in: query name: from description: UNIX epoch (UTC seconds) representing the start of the time range. required: false schema: type: integer example: 1736790000 DMARC_Reports_toParam: in: query name: to description: >- UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. required: false schema: type: integer example: 1736790285 DMARC_Reports_host: required: true in: path name: host schema: type: string description: Host name example: mx.mailgun.com DMARC_Reports_ip: in: path name: ip required: true schema: type: string description: a valid IPv4 or IPv6 address example: 8.8.8.8 DMARC_Reports_domain: in: path name: domain schema: type: string description: Fully qualified domain name required: true example: example.com DMARC_Reports_source: in: path name: source schema: type: string description: User friendly source id name example: mailgun required: true requestBodies: DMARC_Reports_refer_req: description: Request for referral Link required: true content: application/json: schema: $ref: '#/components/schemas/DMARC_Reports_ReferReq' responses: DMARC_Reports_records_200: description: OK | The records for DMARC DNS Setup content: application/json: example: entry: >- v=DMARC1; p=none; pct=100; fo=1; ri=3600; rua=mailto:abcdef12@inbox.ondmarc.com; ruf=mailto:abcdef12@inbox.ondmarc.com; current: >- v=DMARC1; p=none; pct=100; fo=1; ri=3600; rua=mailto:abcdef12@inbox.ondmarc.com; ruf=mailto:abcdef12@inbox.ondmarc.com; configured: true DMARC_Reports_setupCheck_200: description: OK | Setup metadata for DMARC content: application/json: example: InstanceID: d8798aa87905456b123c98745987f21379f9102389cc0981 LastAccessed: '2025-01-22T21:16:25.55Z' CreatedAt: '2025-01-22T21:16:25.55Z' UpdatedAt: '2025-01-22T21:16:25.55Z' DMARC_Reports_referral_200: description: OK | Referral Link to Redsift content: application/json: example: referral_uri: https://redsift.com/partners/mailgun?token=token DMARC_Reports_domainList_200: description: OK | Object representing a list of DMARC monitored domains content: application/json: example: domains: - label: Mailgun.com uri: /domains/mailgun.com email_count: 79, reputation: 0.5 compliance_rate: 0.58 dmarc_failures: 43, spf_rate: 0.9983 dkim_rate: 0.9977 - label: Mailjet.com uri: /domains/mailjet.com email_count: 69, reputation: 1 compliance_rate: 0.65 dmarc_failures: 30, spf_rate: 0.98 dkim_rate: 0.9243 pfqr_chart: - pass: 111 fail: 11 quarantined: 123 rejected: 12334 date: 1736527388 - pass: 199 fail: 2 quarantined: 9 rejected: 0 date: 1736526388 DMARC_Reports_domain_200: description: OK | Object representing a DMARC monitored domain content: application/json: example: email_count: 79, compliance_rate: 0.58 dmarc_policy: p=none 100% pfqr_chart: - pass: 111 fail: 11 quarantined: 123 rejected: 12334 date: 1736527388 - pass: 199 fail: 2 quarantined: 9 rejected: 0 date: 1736526388 sources: - label: mail.we.static.321 uri: /domains/mailgun.com/s/mail.we.static.321 email_count: 10 reputation: 0.5 ip_count: 1 dmarc_failures: 0 spf_rate: 0.98 dkim_rate: 0.9243 ruf: todo - label: mx.example.com uri: /domains/mailgun.com/s/mx.example.com email_count: 10 reputation: 0 ip_count: 3 dmarc_failures: 10 spf_rate: 0.9534 dkim_rate: 0.8743 ruf: todo DMARC_Reports_source_200: description: OK | Object representing DMARC info for a source content: application/json: example: email_count: 79, compliance_rate: 0.58 ip_count: 2 pfqr_chart: - pass: 111 fail: 11 quarantined: 123 rejected: 12334 date: 1736527388 - pass: 199 fail: 2 quarantined: 9 rejected: 0 date: 1736526388 hostnames: - label: 123.4.54.123 uri: /domains/mailgun.com/s/mx.example.com/h/123.4.54.123 email_count: 10 reputation: 0.5 ip_count: 1 dmarc_failures: 0 spf_rate: 0.98 dkim_rate: 0.9243 - label: mx-1234.mx.example.com uri: /domains/mailgun.com/s/mx.example.com/h/mx-1234.mx.example.com email_count: 10 reputation: 0.5 ip_count: 3 dmarc_failures: 10 spf_rate: 0.9534 dkim_rate: 0.8743 auth_events: - protocol: SPF disposition: none reason: Short reason detail: Detailed reason result: temperror email_count: 3 dmarc_failures: 0 date: 1736527388 DMARC_Reports_host_200: description: OK | Object representing DMARC info for a hostname content: application/json: example: email_count: 79, ip_count: 2 spf_fail_events: 1 dkim_fail_events: 1 auth_fail_events: 1 pfqr_chart: - pass: 111 fail: 11 quarantined: 123 rejected: 12334 date: 1736527388 - pass: 199 fail: 2 quarantined: 9 rejected: 0 date: 1736526388 ip_addresses: - label: 123.4.54.123 uri: >- /domains/mailgun.com/s/mx.example.com/h/123.4.54.123/ip/123.4.54.123 email_count: 10 reputation: 0.5 ip_count: 1 dmarc_failures: 0 spf_rate: 0.98 dkim_rate: 0.9243 ruf: todo country: USA - label: 8.8.8.8 uri: >- /domains/mailgun.com/s/mx.example.com/h/123.4.54.123/ip/8.8.8.8 email_count: 10 reputation: 0.5 ip_count: 3 dmarc_failures: 10 spf_rate: 0.9534 dkim_rate: 0.8743 ruf: todo country: CN auth_events: - protocol: SPF disposition: none reason: Short reason detail: Detailed reason result: temperror email_count: 3 dmarc_failures: 0 date: 1736527388 DMARC_Reports_ip_200: description: OK | Object representing DMARC info for an IP Address content: application/json: example: email_count: 79, ip_count: 2 spf_fail_events: 1 dkim_fail_events: 1 auth_fail_events: 1 ruf: todo pfqr_chart: - pass: 111 fail: 11 quarantined: 123 rejected: 12334 date: 1736527388 - pass: 199 fail: 2 quarantined: 9 rejected: 0 date: 1736526388 auth_events: - protocol: SPF disposition: none reason: Short reason detail: Detailed reason result: temperror email_count: 3 dmarc_failures: 0 date: 1736527388 x-tagGroups: - name: Mailgun Optimize tags: - Domains - DMARC Reports - Inbox Placement - Email Preview - Bounce Classification - Spam Traps Monitoring - Email Health Score - IP Blocklist Monitoring - Domain Blocklist Monitoring - Google Postmaster Tools - Microsoft SNDS - Alerts