Properties
| Name | Type | Description |
|---|---|---|
| domainId | object | |
| domain | string | |
| phase | string | |
| dns | object | |
| requirements | array | |
| provider | object | |
| operationId | object | |
| checkedAt | object | |
| nextCheckAt | object | |
| failure | object | |
| provisioning | object | |
| health | object | |
| sending | object | Whether the domain, the organization, and its sending account are healthy enough to send, as last observed. Ready does not guarantee that a particular send is accepted. |
| dmarc | object | |
| rotation | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/samva-dev/json-schema/samva-dev-email-domain-verification-schema.json",
"title": "EmailDomainVerification",
"x-generated": "2026-10-31",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/samva-dev-openapi.json#/components/schemas/EmailDomainVerification",
"type": "object",
"properties": {
"domainId": {
"$ref": "#/$defs/EmailDomainId"
},
"domain": {
"type": "string"
},
"phase": {
"type": "string",
"enum": [
"dns-setup",
"provisioning",
"verifying",
"ready",
"degraded",
"failed"
]
},
"dns": {
"type": "object",
"properties": {
"observed": {
"type": "boolean"
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"satisfied": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"missing": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"mismatch": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"unknown": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"observed",
"total",
"satisfied",
"missing",
"mismatch",
"unknown"
],
"additionalProperties": false
},
"requirements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"record": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"A",
"AAAA",
"CNAME",
"MX",
"NS",
"SOA",
"PTR",
"SRV",
"TXT",
"CAA"
]
},
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"ttl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"priority": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"type",
"name",
"value"
],
"additionalProperties": false
},
"status": {
"type": "string",
"enum": [
"satisfied",
"missing",
"mismatch",
"unknown"
]
},
"evidence": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"_tag": {
"type": "string",
"enum": [
"PublicDns"
]
},
"resolver": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"satisfied",
"missing",
"mismatch",
"unknown"
]
},
"values": {
"type": "array",
"items": {
"type": "string"
}
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
}
},
"required": [
"_tag",
"resolver",
"status",
"values",
"detail",
"observedAt"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"_tag": {
"type": "string",
"enum": [
"Provider"
]
},
"provider": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"satisfied",
"missing",
"mismatch",
"unknown"
]
},
"values": {
"type": "array",
"items": {
"type": "string"
}
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
}
},
"required": [
"_tag",
"provider",
"status",
"values",
"detail",
"observedAt"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"_tag": {
"type": "string",
"enum": [
"Host"
]
},
"source": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"ok",
"pending",
"failed"
]
},
"label": {
"type": "string"
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
}
},
"required": [
"_tag",
"source",
"status",
"label",
"detail",
"observedAt"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"key",
"record",
"status",
"evidence"
],
"additionalProperties": false
}
},
"provider": {
"anyOf": [
{
"type": "object",
"properties": {
"identity": {
"type": "string",
"enum": [
"pending",
"verified",
"failed",
"unknown"
]
},
"dkim": {
"anyOf": [
{
"type": "string",
"enum": [
"pending",
"verified",
"failed",
"unknown"
]
},
{
"type": "null"
}
]
},
"mailFrom": {
"anyOf": [
{
"type": "string",
"enum": [
"pending",
"verified",
"failed",
"unknown"
]
},
{
"type": "null"
}
]
}
},
"required": [
"identity"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"operationId": {
"anyOf": [
{
"$ref": "#/$defs/OperationId"
},
{
"type": "null"
}
]
},
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nextCheckAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"failure": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"failedAt": {
"type": "string"
}
},
"required": [
"code",
"message",
"failedAt"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"provisioning": {
"$ref": "#/$defs/EmailDomainProvisioningExecution"
},
"health": {
"type": "object",
"properties": {
"actionOwner": {
"type": "string",
"enum": [
"customer",
"samva",
"upstream",
"none"
]
},
"action": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"current",
"stale",
"unknown"
]
},
"observedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"staleAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nextRetryAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string",
"enum": [
"ready",
"dns-action-required",
"dns-unavailable",
"verification-pending",
"verification-failed",
"samva-repair",
"signing-custody-action-required",
"ownership-conflict",
"inactive",
"observation-stale",
"observation-unknown"
]
}
},
"required": [
"actionOwner",
"action",
"freshness",
"observedAt",
"staleAt",
"nextRetryAt",
"reason"
],
"additionalProperties": false
},
"sending": {
"type": "object",
"properties": {
"actionOwner": {
"type": "string",
"enum": [
"customer",
"samva",
"upstream",
"none"
]
},
"action": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"current",
"stale",
"unknown"
]
},
"observedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"staleAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nextRetryAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"ready",
"blocked",
"unknown"
]
},
"reason": {
"type": "string",
"enum": [
"domain-not-ready",
"domain-observation-stale",
"operator-paused",
"sending-paused",
"sending-status-unknown",
"ready"
]
}
},
"required": [
"actionOwner",
"action",
"freshness",
"observedAt",
"staleAt",
"nextRetryAt",
"status",
"reason"
],
"additionalProperties": false,
"description": "Whether the domain, the organization, and its sending account are healthy enough to send, as last observed. Ready does not guarantee that a particular send is accepted."
},
"dmarc": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"valid",
"missing",
"invalid",
"multiple",
"unknown"
]
},
"source": {
"type": "string",
"enum": [
"direct",
"organizational",
"none"
]
},
"policyDomain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"policy": {
"anyOf": [
{
"type": "string",
"enum": [
"none",
"quarantine",
"reject"
]
},
{
"type": "null"
}
]
},
"subdomainPolicy": {
"anyOf": [
{
"type": "string",
"enum": [
"none",
"quarantine",
"reject"
]
},
{
"type": "null"
}
]
},
"effectivePolicy": {
"anyOf": [
{
"type": "string",
"enum": [
"none",
"quarantine",
"reject"
]
},
{
"type": "null"
}
]
},
"observedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"staleAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"guidance": {
"type": "string"
}
},
"required": [
"status",
"source",
"policyDomain",
"policy",
"subdomainPolicy",
"effectivePolicy",
"observedAt",
"staleAt",
"guidance"
],
"additionalProperties": false
},
"rotation": {
"anyOf": [
{
"$ref": "#/$defs/EmailDkimRotation"
},
{
"type": "null"
}
]
}
},
"required": [
"domainId",
"domain",
"phase",
"dns",
"requirements",
"provider",
"operationId",
"checkedAt",
"nextCheckAt",
"failure",
"provisioning",
"health",
"sending",
"dmarc",
"rotation"
],
"additionalProperties": false,
"$defs": {
"EmailDkimRotation": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domainId": {
"$ref": "#/$defs/EmailDomainId"
},
"phase": {
"type": "string",
"enum": [
"staged",
"cutover",
"complete"
]
},
"selector": {
"type": "string"
},
"record": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TXT"
]
},
"value": {
"type": "string"
},
"ttl": {
"type": "string"
}
},
"required": [
"name",
"type",
"value",
"ttl"
],
"additionalProperties": false
},
"formerRecord": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"TXT"
]
},
"value": {
"type": "string"
}
},
"required": [
"name",
"type",
"value"
],
"additionalProperties": false
},
"minimumRetainUntil": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The earliest time the former DKIM record may be removed. Keep it published at least until then so mail signed with the former key still verifies."
}
},
"required": [
"id",
"domainId",
"phase",
"selector",
"record",
"formerRecord",
"minimumRetainUntil"
],
"additionalProperties": false
},
"EmailDomainId": {
"type": "string",
"pattern": "^dom_[0-9a-hjkmnp-tv-z]{16,24}$",
"x-samva-brand": "EmailDomainId"
},
"EmailDomainProvisioningExecution": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"none",
"running",
"succeeded",
"failed"
]
},
"generation": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"revision": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"status",
"generation",
"revision"
],
"additionalProperties": false
},
"OperationId": {
"type": "string",
"pattern": "^op_[0-9a-hjkmnp-tv-z]{16,24}$",
"x-samva-brand": "OperationId"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/samva-dev-email-domain-verification"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.