Skip to content
nsin nsin nsin Docs

Check nameserver delegation now

POST
/domains/{domain}/check-ns
 
curl --request POST \
  --url https://api.nsin.ir/domains/example.com/check-ns \
  --header 'Authorization: Bearer <token>'

Runs an immediate delegation check for a pending or moved managed domain instead of waiting for the background checker. On success the domain is activated right away.

Rate-limited to once per hour per domain, independently of the API key rate limit. Requires domain.settings.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
domain
required
string

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

Example 
example.com

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Check result.

Media type application/json
object
ok

Whether the delegation matched an accepted set.

boolean
status
  • pending — managed domain waiting for its nameservers to point at NSIN.
  • unverified — external-DNS domain waiting for its TXT verification record.
  • active — serving.
  • moved — delegation has left NSIN; the domain keeps serving during a grace window.
  • disabled — not serving; re-enable with POST /domains/{domain}/enable.
  • banned — administratively blocked.
string
Allowed values: pending unverified active moved disabled banned
message
string
next_check_at
string format: date-time
nsin_ns

The nameservers the delegation is expected to match.

Array<string>
current_ns

The nameservers actually observed.

Array<string>
Example 
{
  "status": "pending"
}

400

Section titled “400 ”

Not a managed domain, or the domain is not awaiting nameserver changes.

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"
}

401

Section titled “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"
}

403

Section titled “403 ”

The key is read-only, your role on the domain lacks the required permission, or the domain’s plan does not include the feature.

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"
}

404

Section titled “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"
}

429

Section titled “429 ”

Either the once-per-hour manual check limit or the API key rate limit was hit.

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"
}