{"schema_version":"1.0.0","name":"inbox-check","description":"Email deliverability test API. Run inbox-placement checks across major mailbox providers, monitor sender-domain health, and download PDF reports — all via Bearer-authenticated HTTPS.","url":"https://check.live-direct-marketing.online","provider":{"organization":"Live Direct Marketing","url":"https://live-direct-marketing.online"},"contact_email":"support@live-direct-marketing.online","auth":{"schemes":[{"type":"bearer","bearer_format":"icp_live_*","description":"API keys issued at https://check.live-direct-marketing.online/account. Each key carries scope and quota."}]},"capabilities":{"skills":[{"id":"feedback_suggestions_create","name":"Submit an explicit product improvement suggestion","description":"Stores a bounded suggestion for Check administrators. This endpoint never sends email, reads a message, or changes a test.","url":"https://check.live-direct-marketing.online/api/v1/feedback/suggestions","method":"POST","input_schema":{"type":"object","properties":{"category":{"type":"string","description":"Short improvement category.","minLength":1,"maxLength":64},"message":{"type":"string","description":"The improvement suggestion for Check administrators.","minLength":1,"maxLength":500},"context":{"type":"object","description":"Optional structured context for the suggestion.","additionalProperties":true},"test_token":{"type":"string","description":"Optional owned Check test token that gives the suggestion context.","maxLength":64}},"required":["category","message"]},"required_scope":"feedback:submit"},{"id":"me_get","name":"Caller introspection — key metadata + current period usage","description":"Returns this key's tier, scopes, allowed providers, and daily/monthly usage counters. Useful for self-checking remaining quota before a batch.","url":"https://check.live-direct-marketing.online/api/v1/me","method":"GET"},{"id":"monitor_domain_checks","name":"List a domain’s check history","description":"Returns past deliverability check results for the domain, newest first.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}/checks","method":"GET","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_domain_create","name":"Add a domain to monitoring","description":"Registers a domain for recurring SPF/DMARC/MX/blocklist/TLS checks. Requires a user-bound API key.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains","method":"POST","input_schema":{"type":"object","properties":{"domain":{"type":"string","minLength":3,"maxLength":253},"enabledChecks":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["spf","dmarc","mx","blocklist","tls"]}}},"required":["domain"]}},{"id":"monitor_domain_delete","name":"Remove a monitored domain","description":"Stops monitoring and deletes the domain and its check history. Irreversible.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}","method":"DELETE","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_domain_latest","name":"Get a domain’s latest check","description":"Returns the most recent deliverability check result for the domain.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}/latest","method":"GET","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_domain_list","name":"List monitored domains","description":"Returns all domains under continuous deliverability monitoring for the key owner, plus the per-user active-domain limit.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains","method":"GET"},{"id":"monitor_domain_pause","name":"Pause monitoring for a domain","description":"Suspends scheduled checks for the domain without deleting its history.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}/pause","method":"POST","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_domain_resume","name":"Resume monitoring for a domain","description":"Re-enables scheduled checks for a previously paused domain.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}/resume","method":"POST","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_domain_run","name":"Run an on-demand check now","description":"Triggers an immediate deliverability check for the domain, outside the schedule.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/domains/{id}/run","method":"POST","input_schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},{"id":"monitor_settings_get","name":"Get monitoring notification settings","description":"Returns the key owner’s alert/digest/webhook/telegram monitoring preferences.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/settings","method":"GET"},{"id":"monitor_settings_update","name":"Update monitoring notification settings","description":"Patches alert thresholds, digest frequency, webhook and telegram delivery options.","url":"https://check.live-direct-marketing.online/api/v1/monitoring/settings","method":"PATCH","input_schema":{"type":"object","properties":{"emailEnabled":{"type":"boolean"},"webhookUrl":{"type":"string","nullable":true,"maxLength":2048,"format":"uri"},"webhookSecret":{"type":"string","nullable":true,"maxLength":256},"alertOnInfo":{"type":"boolean"},"alertOnWarn":{"type":"boolean"},"alertOnCrit":{"type":"boolean"},"digestFrequency":{"enum":["off","weekly","monthly"],"type":"string"},"telegramEnabled":{"type":"boolean"}},"required":[]}},{"id":"providers_list","name":"List available providers","description":"Lists all deliverability providers, marking which ones the calling key may use (with a reason for those it can’t) so clients can surface accurate upgrade prompts.","url":"https://check.live-direct-marketing.online/api/v1/providers","method":"GET"},{"id":"sender-links_get","name":"Get a permanent sender page: seed addresses, latest runs, reports state","description":"Get a permanent sender page: seed addresses, latest runs, reports state","url":"https://check.live-direct-marketing.online/api/v1/sender-links/{linkId}","method":"GET","input_schema":{"type":"object","properties":{"linkId":{"type":"string"}},"required":["linkId"]}},{"id":"tests_auto_create","name":"Create a deliverability test (auto mode — per-recipient single-seed)","description":"For campaign-style delivery checks: pass `recipient_email` and we auto-classify the provider via MX, picking ONE matching seed (vs the manual mode which fans across all seeds). Custom-domain recipients fall back to the `ldm` spam-analyzer seed.","url":"https://check.live-direct-marketing.online/api/v1/tests/auto","method":"POST","input_schema":{"type":"object","properties":{"recipient_email":{"type":"string","format":"email"},"sender_email":{"type":"string","format":"email"},"meta":{"type":"object"},"client_ref":{"type":"object","description":"LDM's opaque task reference. Only an authenticated API request can set it."}},"required":["recipient_email"]}},{"id":"tests_create","name":"Create a deliverability test (manual mode)","description":"Returns a seed mailbox the caller must send their campaign email to (with the +token plus-addressing). Workers then poll the seed via IMAP and report placement (inbox/spam/other/not_received); polling backs off over up to a 2h window before giving up (api#27).","url":"https://check.live-direct-marketing.online/api/v1/tests","method":"POST","input_schema":{"type":"object","properties":{"recipient_email":{"type":"string","format":"email"},"providers":{"type":"array","items":{"type":"string"}},"meta":{"type":"object"},"screenshots":{"type":"boolean"}},"required":[]}},{"id":"tests_delete","name":"Delete a test (irreversible)","description":"Removes the test, its results, and any associated screenshot jobs. Cannot be undone.","url":"https://check.live-direct-marketing.online/api/v1/tests/{token}","method":"DELETE","input_schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}},{"id":"tests_get","name":"Fetch test status + results (JSON or PDF)","description":"Returns full test snapshot: status (waiting/done/expired), per-seed results (placement, spf/dkim/dmarc, screenshot URL), aggregate summary, verdict, and recommendations. Pass `?format=pdf` or `Accept: application/pdf` to download a PDF report instead — requires `reports:pdf` scope.","url":"https://check.live-direct-marketing.online/api/v1/tests/{token}","method":"GET","input_schema":{"type":"object","properties":{"token":{"type":"string"},"format":{"type":"string","description":"Response format. Default `json`. Use `pdf` for a downloadable report.","enum":["json","pdf"]}},"required":["token"]}},{"id":"tests_list","name":"List own tests (paginated by created_at cursor)","description":"Returns tests created by this API key, newest first. Use `?cursor=<created_at>` to page back.","url":"https://check.live-direct-marketing.online/api/v1/tests","method":"GET","input_schema":{"type":"object","properties":{"limit":{"type":"string"},"cursor":{"type":"string"},"status":{"type":"string"}},"required":[]}},{"id":"tests_recheck","name":"Schedule a same-message placement recheck","description":"Schedules a durable re-scan of the original message after delay_hours (24 by default). Does not send a new email and does not consume test quota. Use GET /api/v1/tests/{token}/recheck-status to read both snapshots and the transition matrix.","url":"https://check.live-direct-marketing.online/api/v1/tests/{token}/recheck","method":"POST","input_schema":{"type":"object","properties":{"token":{"type":"string"},"delay_hours":{"type":"number","description":"Delay before the same-message recheck. Defaults to 24 hours.","default":24,"minimum":1,"maximum":168}},"required":["token"]}},{"id":"tests_recheck-status","name":"Get delayed placement snapshots and transitions","description":"Get delayed placement snapshots and transitions","url":"https://check.live-direct-marketing.online/api/v1/tests/{token}/recheck-status","method":"GET","input_schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}},{"id":"tests_repoll","name":"Force IMAP re-poll of a test (within cooldown)","description":"Triggers a one-shot IMAP fetch on every seed of this test. 30s cooldown per token. Quota NOT consumed (no email sent). Useful when delivery is delayed past the auto-window.","url":"https://check.live-direct-marketing.online/api/v1/tests/{token}/repoll","method":"POST","input_schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}}]},"documentation_url":"https://check.live-direct-marketing.online/api/docs"}