Skip to content

Commit 736039f

Browse files
oschwaldclaude
andcommitted
Document new email domain outputs for minFraud
Add documentation for new email domain fields in minFraud Insights and Factors: classification, risk, volume, and visit object with status, last_visited_on, and has_redirect fields. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 33d180e commit 736039f

File tree

1 file changed

+118
-3
lines changed

1 file changed

+118
-3
lines changed

content/minfraud/api-documentation/responses.md

Lines changed: 118 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -882,20 +882,119 @@ associated with the IP address passed in the request.
882882
This is a sub-object of `email` that contains information related to the domain.
883883
```json
884884
{
885-
"first_seen": "2015-01-20"
885+
"classification": "business",
886+
"first_seen": "2015-01-20",
887+
"risk": 1.23,
888+
"visit": {
889+
"has_redirect": true,
890+
"last_visited_on": "2025-11-15",
891+
"status": "live"
892+
},
893+
"volume": 6.5
886894
}
887895
```
888896

889897
<!-- prettier-ignore-start -->
890898

891899
{{< schema-table key="email--domain" >}}
892900

901+
{{< minfraud-schema-row key="classification" type="response" valueType="string" insights="true" factors="true" >}}
902+
A classification of the domain. One of the following values. Additional values may be added in the future.
903+
904+
* `business`
905+
* `education`
906+
* `government`
907+
* `isp_email`
908+
909+
[Learn more about the domain classification on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data)
910+
{{</minfraud-schema-row>}}
911+
893912
{{< minfraud-schema-row key="first_seen" type="response" valueType="string" valueTypeNote="format: YYYY-MM-DD, max length: 10" insights="true" factors="true" >}}
894913
A date string (e.g. 2019-01-01) to identify the date an email address domain was first seen by MaxMind. This is expressed using the ISO 8601 date format `YYYY-MM-DD`. The earliest date that may be returned is January 1, 2019.
895914

896915
[Learn how to use email first seen data for risk analysis on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data#first-seen)
897916
{{</minfraud-schema-row>}}
898917

918+
{{< minfraud-schema-row key="risk" type="response" valueType="decimal" valueTypeNote="min: 0.01, max: 99" insights="true" factors="true" >}}
919+
This field contains the risk associated with the domain. The value ranges from 0.01 to 99. A higher score indicates higher risk.
920+
921+
[Learn more about the email domain risk score on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data)
922+
{{</minfraud-schema-row>}}
923+
924+
{{< minfraud-schema-row key="visit" type="response" valueType="object" insights="true" factors="true" >}}
925+
An object containing information about an automated visit to the email domain. See the [Email > Domain > Visit](#email--domain--visit) section for details about this object.
926+
{{</minfraud-schema-row>}}
927+
928+
{{< minfraud-schema-row key="volume" type="response" valueType="decimal" valueTypeNote="min: 0.001, max: 1000000" insights="true" factors="true" >}}
929+
This field indicates how much activity we see on an email domain across the minFraud network, expressed in sightings per million.
930+
931+
The value is rounded to 2 significant figures. Example domain sightings per million requests:
932+
933+
* Consumer email domains: gmail.com (630,000), icloud.com (37,000)
934+
* Business domains: microsoft.com (6)
935+
936+
Note: These are point-in-time examples to provide a relative sense of the values. They will change based on email usage patterns.
937+
938+
[Learn more about email domain volume on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data)
939+
{{</minfraud-schema-row>}}
940+
941+
{{</ schema-table >}}
942+
943+
<!-- prettier-ignore-end -->
944+
945+
### Email > Domain > Visit
946+
947+
{{< anchor-target schema--response--email--domain--visit >}}
948+
949+
This is a sub-object of `email/domain` that contains information about an
950+
automated visit to the email domain.
951+
952+
Domain visits are performed by an automated agent, so for newly-sighted domains
953+
on the minFraud network, it can take a few minutes for these outputs to be
954+
populated on later requests on the same domain. Domain visits are also limited
955+
to those with low volume on the network. High volume domains such as those for
956+
email providers and large businesses will not have domain visit outputs in the
957+
minFraud response.
958+
959+
```json
960+
{
961+
"has_redirect": true,
962+
"last_visited_on": "2025-11-15",
963+
"status": "live"
964+
}
965+
```
966+
967+
<!-- prettier-ignore-start -->
968+
969+
{{< schema-table key="email--domain--visit" >}}
970+
971+
{{< minfraud-schema-row key="has_redirect" type="response" valueType="boolean" insights="true" factors="true" >}}
972+
This is `true` if the domain in the request has redirects (configured to automatically send visitors to another URL). Otherwise, the key is not included in the `/email/domain/visit` object.
973+
974+
If `true`, the `/email/domain/visit/status` field corresponds to the last domain visited after redirecting.
975+
976+
[Learn more about the email domain visit redirect flag on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data)
977+
{{</minfraud-schema-row>}}
978+
979+
{{< minfraud-schema-row key="last_visited_on" type="response" valueType="string" valueTypeNote="format: YYYY-MM-DD" insights="true" factors="true" >}}
980+
A date string that corresponds to when the automated visit was completed. This is expressed using the ISO 8601 date format `YYYY-MM-DD`.
981+
982+
Pair with the `/email/domain/visit/status` and `/email/domain/visit/has_redirect` fields to determine the recency of those values.
983+
{{</minfraud-schema-row>}}
984+
985+
{{< minfraud-schema-row key="status" type="response" valueType="string" insights="true" factors="true" >}}
986+
A classification of the status of the domain (or the last domain visited after following redirects, if these are present and can be followed) based on an automated visit at a previous point in time. This field may be initially unavailable for a newly sighted domain and populated at a future time after a visit is conducted. Pair with the `/email/domain/visit/last_visited_on` to determine the recency of the visit. One of the following values. Additional values may be added in the future.
987+
988+
* `live` - the domain is reachable and serving content normally
989+
* `dns_error` - the domain is missing, expired, or DNS is misconfigured
990+
* `network_error` - the domain is offline, blocked, or unreachable
991+
* `http_error` - the domain is reachable but the web application had a problem or denied the request
992+
* `parked` - the domain is reachable and is in a parked state
993+
* `pre_development` - the domain is reachable and is in a pre-development state
994+
995+
[Learn more about the email domain visit status on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-email-risk-data)
996+
{{</minfraud-schema-row>}}
997+
899998
{{</ schema-table >}}
900999

9011000
<!-- prettier-ignore-end -->
@@ -1533,7 +1632,15 @@ Factors services, and a full example of the JSON body document for an error.
15331632
},
15341633
"email": {
15351634
"domain": {
1536-
"first_seen": "2015-01-20"
1635+
"classification": "business",
1636+
"first_seen": "2015-01-20",
1637+
"risk": 1.23,
1638+
"visit": {
1639+
"has_redirect": true,
1640+
"last_visited_on": "2025-11-15",
1641+
"status": "live"
1642+
},
1643+
"volume": 6.5
15371644
},
15381645
"first_seen": "2016-02-03",
15391646
"is_disposable": false,
@@ -1758,7 +1865,15 @@ Factors services, and a full example of the JSON body document for an error.
17581865
},
17591866
"email": {
17601867
"domain": {
1761-
"first_seen": "2015-01-20"
1868+
"classification": "business",
1869+
"first_seen": "2015-01-20",
1870+
"risk": 1.23,
1871+
"visit": {
1872+
"has_redirect": true,
1873+
"last_visited_on": "2025-11-15",
1874+
"status": "live"
1875+
},
1876+
"volume": 6.5
17621877
},
17631878
"first_seen": "2016-02-03",
17641879
"is_disposable": false,

0 commit comments

Comments
 (0)