HisendHISEND Docs

Get reputation and history

GET
/admin/projects/{project_id}/reputation

Requires a user JWT with the admin role. Period defaults to 30; supported values: 7, 30, 90, all. Dates use UTC. Totals cover the selected period; raw history is paginated. Rates are null with no sent denominator.

Authorization

AdminJWT
AuthorizationBearer <token>

User JWT; backend checks the admin role. Project API keys cannot access admin endpoints.

In: header

Path Parameters

project_id*integer
Range0 <= value

Query Parameters

page?integer
Default1
Range1 <= value
limit?integer
Default20
Range1 <= value <= 100
period?string
from?string
to?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.hisend.app/v1/admin/projects/0/reputation"
{
  "score": 0,
  "is_locked": true,
  "cumulative": {
    "bounced": 0,
    "failed": 0,
    "complained": 0
  },
  "totals": {
    "sent": 0,
    "delivered": 0,
    "bounced": 0,
    "failed": 0,
    "complained": 0
  },
  "bounce_rate": 0,
  "complaint_rate": 0,
  "recipients_24h": 0,
  "recipients_month": 0,
  "history": [
    {
      "id": 0,
      "project_id": 0,
      "date": "string",
      "sent": 0,
      "delivered": 0,
      "bounced": 0,
      "failed": 0,
      "complained": 0
    }
  ],
  "total": 0,
  "period": "string",
  "from": "string",
  "to": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}