sendly-now · Schema
DeliverabilityDiagnosisV1
A composed answer to why mail from one domain may not be arriving: its DNS identity, the project's recent delivery outcomes, one address's suppression state, and the findings drawn from them.
EmailTransactional EmailMarketing CampaignsWorkflow AutomationAI IntegrationDeveloper Platform
Properties
| Name | Type | Description |
|---|---|---|
| address | stringnull | |
| checked_at | string | |
| domain | string | |
| findings | array | What is wrong, worst first. An empty array means nothing here explains a delivery problem. |
| identity | object | |
| recent_delivery | object | |
| suppression | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/sendly-now/json-schema/sendly-now-deliverability-diagnosis-v1-schema.json",
"title": "DeliverabilityDiagnosisV1",
"description": "A composed answer to why mail from one domain may not be arriving: its DNS identity, the project's recent delivery outcomes, one address's suppression state, and the findings drawn from them.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/sendly-now-deliverability-api-openapi.yml#/components/schemas/DeliverabilityDiagnosisV1",
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"domain": {
"type": "string"
},
"findings": {
"description": "What is wrong, worst first. An empty array means nothing here explains a delivery problem.",
"items": {
"$ref": "#/$defs/DeliverabilityFindingV1"
},
"type": "array"
},
"identity": {
"$ref": "#/$defs/DeliverabilityIdentityV1"
},
"recent_delivery": {
"$ref": "#/$defs/DeliverabilityRecentDeliveryV1"
},
"suppression": {
"$ref": "#/$defs/DeliverabilitySuppressionV1"
}
},
"required": [
"domain",
"address",
"checked_at",
"identity",
"suppression",
"recent_delivery",
"findings"
],
"type": "object",
"$defs": {
"DeliverabilityFindingSeverityV1": {
"description": "`blocking`: mail from this domain cannot be delivered as configured. `degraded`: it delivers, but inbox placement or sender reputation is at risk. `info`: worth knowing, nothing to fix.",
"enum": [
"blocking",
"degraded",
"info"
],
"type": "string"
},
"DeliverabilityFindingV1": {
"description": "One diagnosed problem, with its fix.",
"properties": {
"code": {
"description": "Stable identifier for this finding, e.g. `domain_not_verified`. Branch on this, not on `summary`.",
"type": "string"
},
"remedy": {
"description": "What to do about it.",
"type": "string"
},
"severity": {
"$ref": "#/$defs/DeliverabilityFindingSeverityV1"
},
"summary": {
"description": "What is wrong, in one sentence.",
"type": "string"
}
},
"required": [
"code",
"severity",
"summary",
"remedy"
],
"type": "object"
},
"DeliverabilityIdentityV1": {
"description": "The sending identity's DNS health, as last refreshed.",
"properties": {
"dkim_status": {
"description": "DKIM signing. This is the one that decides whether Sendly will send from the domain at all.",
"enum": [
"NOT_CHECKED",
"PENDING",
"VERIFIED",
"FAILED",
null
],
"type": [
"string",
"null"
]
},
"dmarc_status": {
"description": "The DMARC policy published at `_dmarc.<domain>`.",
"enum": [
"NOT_CHECKED",
"PENDING",
"VERIFIED",
"FAILED",
null
],
"type": [
"string",
"null"
]
},
"last_checked_at": {
"description": "When the DNS refresh job last looked. These statuses are a CACHE, not a live lookup.",
"format": "date-time",
"type": [
"string",
"null"
]
},
"mail_from_domain": {
"type": [
"string",
"null"
]
},
"mail_from_domain_status": {
"description": "Raw SES `CustomMailFromStatus` (`Pending`/`Success`/`Failed`/`TemporaryFailure`), or `NotConfigured`. `Failed` means SES silently fell back to `amazonses.com`, which is why the value is reported rather than folded into a boolean.",
"type": [
"string",
"null"
]
},
"mx_status": {
"description": "Inbound receiving only. Null unless the domain has receiving enabled.",
"enum": [
"NOT_CHECKED",
"PENDING",
"VERIFIED",
"FAILED",
null
],
"type": [
"string",
"null"
]
},
"registered": {
"description": "Whether this project has a domain record at all. False makes every other field null.",
"type": "boolean"
},
"spf_status": {
"description": "SPF alignment for the sending identity.",
"enum": [
"NOT_CHECKED",
"PENDING",
"VERIFIED",
"FAILED",
null
],
"type": [
"string",
"null"
]
},
"verified": {
"type": "boolean"
}
},
"required": [
"registered",
"verified",
"dkim_status",
"spf_status",
"dmarc_status",
"mx_status",
"mail_from_domain",
"mail_from_domain_status",
"last_checked_at"
],
"type": "object"
},
"DeliverabilityRecentDeliveryV1": {
"description": "Delivery outcomes over the requested window.",
"properties": {
"bounce_rate": {
"description": "Bounced ÷ sent (0–1), or null when nothing was sent in the window.",
"type": [
"number",
"null"
]
},
"bounced": {
"type": "integer"
},
"complained": {
"type": "integer"
},
"complaint_rate": {
"type": [
"number",
"null"
]
},
"delivered": {
"type": "integer"
},
"failed": {
"type": "integer"
},
"scope": {
"description": "PROJECT-WIDE, not per-domain, and said so rather than implied. `Email` has no sending-domain column, so narrowing these counters to one domain would mean a scan over every row the project has ever sent. A project that sends from one domain — most of them — can read these as that domain's.",
"enum": [
"project"
],
"type": "string"
},
"sent": {
"type": "integer"
},
"window_days": {
"type": "integer"
}
},
"required": [
"window_days",
"scope",
"sent",
"delivered",
"bounced",
"complained",
"failed",
"bounce_rate",
"complaint_rate"
],
"type": "object"
},
"DeliverabilitySuppressionV1": {
"description": "Null unless the request named an `address`.",
"properties": {
"reason": {
"enum": [
"HARD_BOUNCE",
"COMPLAINT",
"MANUAL",
"UNSUBSCRIBE",
null
],
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"SES_WEBHOOK",
"API",
"DASHBOARD",
null
],
"type": [
"string",
"null"
]
},
"suppressed": {
"type": "boolean"
},
"suppressed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"suppressed",
"reason",
"source",
"suppressed_at"
],
"type": [
"object",
"null"
]
}
}
}
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/sendly-now-deliverability-diagnosis-v1"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.