Skip to content
nsin docs
EN فا

List sent email

GET
/domains/{domain}/email-routing/sent
 
curl --request GET \
  --url 'https://api.nsin.ir/domains/example.com/email-routing/sent?page=1&per_page=50' \
  --header 'Authorization: Bearer <token>'

Mail sent from this domain with the send endpoint, newest first, one row per recipient, with the receiving server’s answer. Rows are kept 30 days; the text of a message is never kept. Requires domain.view.

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

Query Parameters

Section titled “Query Parameters ”
page
integer
default: 1 >= 1
per_page
integer
default: 50 >= 1 <= 200

Responses

Section titled “ Responses ”

200

Section titled “200 ”

A page of sent mail.

Media type application/json
object
data
Array<object>

One recipient of one sent message.

object
id
integer
group_id

Shared by the recipients of one send.

string
from

The sender address.

string
from_name
string
to

This row’s recipient.

string
subject
string
status

queued with attempts above 0 is a soft failure waiting for its next try.

string
Allowed values: queued sending sent failed
attempts

Delivery attempts so far.

integer
smtp_code

The receiving server’s last reply code. 0 before the first attempt.

integer
response

The receiving server’s last reply text.

string
tls

TLS version of the last delivery connection

string
created_at
string format: date-time
sent_at
string | null format: date-time
next_try_at

When a soft failure is tried again.

string | null format: date-time
total
integer
page
integer
per_page
integer
Example 
{
  "data": [
    {
      "status": "queued"
    }
  ]
}

401

Section titled “401 ”

Missing, malformed, revoked or expired API key. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

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

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 ”

The key exceeded its request budget (300 requests per minute by default).

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 limited 
{
  "error": "rate limit exceeded"
}