Endpoint
GET https://requiems.xyz/v1/systems/domain/trust/{domain}
Domain Trust
Evaluate the trustworthiness of a domain by analyzing DNS records, WHOIS registration data, and MX configuration — in a single call.
Parameters
| Name |
Type |
Required |
Location |
Description |
domain |
string |
yes |
path |
The domain name to evaluate for trust. Must be a valid domain format (e.g. github.com). |
Response Example
{
"data": {
"domain": "github.com",
"trust_score": 1,
"trust_level": "high",
"who_is": {
"registrar": "MarkMonitor Inc.",
"created_at": "2007-10-09T18:20:50Z",
"expires_at": "2026-10-09T18:20:50Z",
"age_days": 6814,
"status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited"
]
},
"dns": {
"has_a_records": true,
"has_mx_records": true,
"has_ns_records": true,
"available": false
},
"mx_records": [
{
"host_name": "github-com.mail.protection.outlook.com.",
"priority": 0
}
],
"flags": []
},
"metadata": {
"timestamp": "2026-06-05T21:01:18Z"
}
}
Response Fields
| Field |
Type |
Description |
domain |
string |
The domain name that was evaluated. |
trust_score |
number |
Computed trust score between 0.0 and 1.0. Starts at 1.0 with penalties applied based on domain signals. |
trust_level |
string |
Coarse trust label derived from the score. Possible values are "high" (>= 0.75), "medium" (0.4 - 0.74), or "low" (< 0.4). |
who_is |
object |
WHOIS registration data for the domain. Omitted from the response if WHOIS is unavailable for the TLD or if the domain is not registered. |
who_is.registrar |
string |
The registrar where the domain was registered. |
who_is.created_at |
string |
The date the domain was first registered in RFC3339 format. |
who_is.expires_at |
string |
The date the domain registration expires in RFC3339 format. |
who_is.age_days |
integer |
Number of days since the domain was registered. |
who_is.status |
array |
WHOIS status codes indicating the domain transfer and update permissions. |
dns |
object |
DNS health check results for the domain. Fields default to false if the domain is not registered. |
dns.has_a_records |
boolean |
True if the domain has at least one A record pointing to an IP address. |
dns.has_mx_records |
boolean |
True if the domain has MX records configured for receiving email. |
dns.has_ns_records |
boolean |
True if the domain has NS records indicating it is delegated to a nameserver. |
dns.available |
boolean |
True if the domain is unregistered and available for purchase. When true, trust_score is 0.0 and evaluation stops immediately. |
mx_records |
array |
List of MX records found for the domain. Empty array if none exist or if the domain is not registered. |
mx_records[].host_name |
string |
The hostname of the mail server. |
mx_records[].priority |
integer |
Mail server priority. Lower value means higher priority. |
flags |
array |
List of signal flags raised during evaluation. Possible values are "new_domain", "young_domain", "no_mx", "no_a_records", "no_ns_records", "expiring_soon", "whois_unavailable", "domain_not_registered". Only "domain_not_registered" is returned when the domain is not registered. |
Errors
400 bad_request — Invalid or malformed domain value in the request path.
1---2name: data-integrity-get-domain3description: Evaluate the trustworthiness of a domain by analyzing DNS records, WHOIS registration data, and MX configuration — in a single call.4---5
6## Endpoint
7
8**GET https://requiems.xyz/v1/systems/domain/trust/{domain}**
9
10## Domain Trust
11
12Evaluate the trustworthiness of a domain by analyzing DNS records, WHOIS registration data, and MX configuration — in a single call.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `domain` | string | yes | path | The domain name to evaluate for trust. Must be a valid domain format (e.g. github.com). |
19
20## Response Example
21
22```json
23{
24 "data": {
25 "domain": "github.com",
26 "trust_score": 1,
27 "trust_level": "high",
28 "who_is": {
29 "registrar": "MarkMonitor Inc.",
30 "created_at": "2007-10-09T18:20:50Z",
31 "expires_at": "2026-10-09T18:20:50Z",
32 "age_days": 6814,
33 "status": [
34 "clientDeleteProhibited",
35 "clientTransferProhibited",
36 "clientUpdateProhibited"
37 ]
38 },
39 "dns": {
40 "has_a_records": true,
41 "has_mx_records": true,
42 "has_ns_records": true,
43 "available": false
44 },
45 "mx_records": [
46 {
47 "host_name": "github-com.mail.protection.outlook.com.",
48 "priority": 0
49 }
50 ],
51 "flags": []
52 },
53 "metadata": {
54 "timestamp": "2026-06-05T21:01:18Z"
55 }
56}
57```
58
59## Response Fields
60
61| Field | Type | Description |
62| ----- | ---- | ----------- |
63| `domain` | string | The domain name that was evaluated. |
64| `trust_score` | number | Computed trust score between 0.0 and 1.0. Starts at 1.0 with penalties applied based on domain signals. |
65| `trust_level` | string | Coarse trust label derived from the score. Possible values are "high" (>= 0.75), "medium" (0.4 - 0.74), or "low" (< 0.4). |
66| `who_is` | object | WHOIS registration data for the domain. Omitted from the response if WHOIS is unavailable for the TLD or if the domain is not registered. |
67| `who_is.registrar` | string | The registrar where the domain was registered. |
68| `who_is.created_at` | string | The date the domain was first registered in RFC3339 format. |
69| `who_is.expires_at` | string | The date the domain registration expires in RFC3339 format. |
70| `who_is.age_days` | integer | Number of days since the domain was registered. |
71| `who_is.status` | array<string> | WHOIS status codes indicating the domain transfer and update permissions. |
72| `dns` | object | DNS health check results for the domain. Fields default to false if the domain is not registered. |
73| `dns.has_a_records` | boolean | True if the domain has at least one A record pointing to an IP address. |
74| `dns.has_mx_records` | boolean | True if the domain has MX records configured for receiving email. |
75| `dns.has_ns_records` | boolean | True if the domain has NS records indicating it is delegated to a nameserver. |
76| `dns.available` | boolean | True if the domain is unregistered and available for purchase. When true, trust_score is 0.0 and evaluation stops immediately. |
77| `mx_records` | array<object> | List of MX records found for the domain. Empty array if none exist or if the domain is not registered. |
78| `mx_records[].host_name` | string | The hostname of the mail server. |
79| `mx_records[].priority` | integer | Mail server priority. Lower value means higher priority. |
80| `flags` | array<string> | List of signal flags raised during evaluation. Possible values are "new_domain", "young_domain", "no_mx", "no_a_records", "no_ns_records", "expiring_soon", "whois_unavailable", "domain_not_registered". Only "domain_not_registered" is returned when the domain is not registered. |
81
82## Errors
83
84- `400` **bad_request** — Invalid or malformed domain value in the request path.