nsindocs Search the docs⌘K
API
  1. Docs
  2. API reference
  3. Email Routing

List the domain owner's destinations

gethttps://api.nsin.ir/domains/{domain}/email-routing/destinations/

Auth: Authorization: Bearer nsin_… or X-Api-Key: nsin_… — see API keys.

The destinations a rule on this domain may forward to — the domain OWNER's account's, whoever is asking. Requires domain.view.

Path parameters

  • domainstringrequiredpath

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

Responses

200Destination list.

Content type: application/json

  • idinteger
  • emailstring
  • verifiedboolean

    Whether the address was confirmed through the emailed link.

  • verified_atstring | null (date-time)

    When it was confirmed.

  • created_atstring (date-time)
  • last_sent_atstring | null (date-time)

    When the last verification mail went out.

  • resend_cooldown_secondsinteger

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

  • in_useinteger

    Rules and catch-alls pointing at it.

  • last_failurestring

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

  • last_failure_atstring | null (date-time)

    When last_failure was recorded.

json
[
  {
    "id": 0,
    "email": "string",
    "verified": true,
    "verified_at": "2026-01-01T00:00:00Z",
    "created_at": "2026-01-01T00:00:00Z",
    "last_sent_at": "2026-01-01T00:00:00Z",
    "resend_cooldown_seconds": 0,
    "in_use": 0,
    "last_failure": "string",
    "last_failure_at": "2026-01-01T00:00:00Z"
  }
]
401Missing, malformed, revoked or expired API key. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "invalid API key"
}
404No such domain, or it is not visible to this account. Domains you cannot access are reported as not found rather than forbidden.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}
429The key exceeded its request budget (300 requests per minute by default).

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "rate limit exceeded"
}

Example request

bash
curl -X GET "https://api.nsin.ir/domains/example.com/email-routing/destinations/" \
  -H "Authorization: Bearer $NSIN_API_KEY"
esc