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