Check the published records now

POST

/domains/{domain}/email-routing/dns/check

curl --request POST \
  --url https://api.nsin.ir/domains/example.com/email-routing/dns/check \
  --header 'Authorization: Bearer <token>'

• Production

Queries the public nameserver for the domain’s MX, SPF and DKIM and marks each managed record ok, missing or extra (a foreign MX or a second SPF). A domain whose records do not answer is misconfigured and its mail hosts stop accepting for it until the records are back. The same check runs every five minutes on its own. Once a minute per domain: sooner answers 429 with retry_after_seconds. Requires domain.view.

Authorizations

• bearerAuth
• apiKeyAuth

Parameters

Path Parameters

domain

required

string

The domain name (for example example.com) — not a numeric id.

Example

example.com

Responses

200

Fresh verdict; the status.

Media type application/json

object

enabled

boolean

status

string

Allowed values: unconfigured ready misconfigured unlocked suspended

hosts_ready

At least one mail host has checked in recently. Enable is refused while false.

boolean

locked

The managed records are not editable.

boolean

subaddressing

boolean

suspended_reason

string

catch_all

object

enabled

boolean

action

string

Allowed values: forward drop

destination_id

integer

nullable

destination_email

string

nullable

destination_verified

boolean

dns

object

checked_at

string format: date-time

nullable

ok

boolean

records

Array<object>

object

type

string

Allowed values: MX TXT

name

Relative to the domain; @ is the apex.

string

content

string

priority

integer

ttl

integer

state

extra is a foreign MX or a second SPF seen publicly.

string

Allowed values: ok missing extra unchecked

record_id

The managed record’s id, when the row is ours.

integer

problems

Array<string>

conflicts

Only while unconfigured — what enable would have to remove or merge.

object

mx

Array<object>

object

id

integer

name

string

content

string

priority

integer

spf

object

record_id

integer

content

string

merged

string

spf_multiple

boolean

previous_mx_available

Enable removed MX records that disable can restore.

boolean

counts_24h

object

received

Every message except discarded bounces.

integer

forwarded

integer

dropped

integer

rejected

integer

deferred

integer

limits

object

max_rules

integer

nullable

rules_used

integer

max_forwards_per_day

integer

nullable

forwards_today

integer

dkim

Always present. Before Email Routing is enabled the selector and name are already known (they come from platform settings) and txt is empty, because the key is generated at enable time.

object

selector

string

name

The TXT name relative to the domain.

string

txt

string

platform

object

mx_hosts

Array<object>

object

host

string

priority

integer

spf_include

string

forward_domain

string

Example

{
  "status": "unconfigured",
  "catch_all": {
    "action": "forward"
  },
  "dns": {
    "records": [
      {
        "type": "MX",
        "state": "ok"
      }
    ]
  }
}

401

Missing, malformed, revoked or expired API key — or the owning account is inactive.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Examples

Example invalidKey

{
  "error": "invalid API key"
}

404

No such domain, or it is not visible to this account. Domains you cannot access are reported as not found rather than forbidden.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Example

{
  "error": "read-only API key"
}

409

Email routing is not enabled on this domain (conflict: not_enabled).

Media type application/json

object

error

required

Human-readable description of what went wrong.

string

conflict

What conflicts (mx, spf, spf_multiple, external_dns, domain_status, not_enabled, local_part, destination).

string

records

For mx / spf_multiple — the rows in the way.

Array<object>

object

id

integer

name

string

content

string

priority

integer

record_id

For spf — the existing SPF row.

integer

content

For spf — its current value.

string

merged

For spf — what it becomes with our include merged in.

string

destination

For destination — the existing row.

object

id

integer

email

string

verified

boolean

verified_at

string format: date-time

nullable

created_at

string format: date-time

last_sent_at

When the last verification mail went out.

string format: date-time

nullable

resend_cooldown_seconds

Seconds until another verification mail may be sent; 0 when allowed now.

integer

in_use

Rules and catch-alls pointing at it.

integer

last_failure

The receiving server’s last refusal, when forwards to it are bouncing.

string

last_failure_at

string format: date-time

nullable

Example

{
  "error": "read-only API key"
}

429

The per-key rate limit, or a check less than a minute ago.

Media type application/json

object

error

required

Human-readable description of what went wrong.

string

retry_after_seconds

Seconds left on this domain’s five-minute scan window.

integer

Example

{
  "error": "read-only API key"
}

502

The public lookup failed; nothing changed.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Example

{
  "error": "read-only API key"
}