Docs

Logs

Every authenticated Irisend API request your team makes is recorded for the dashboard's Logs page and readable from the API, with secrets always redacted.

GET/logsList requests

List items are intentionally minimal — endpoint, method, response_status, user_agent — with no object field and no request/response bodies. Fetch a single log to read those.

curl https://api.irisend.com/logs?limit=20 \
  -H "Authorization: Bearer $IRISEND_API_KEY"
ResponseJSON
{
  "object": "list",
  "has_more": false,
  "data": [
    { "id": "1d20e63d-e6a7-4a65-831d-0556d3d3a6a1", "created_at": "2026-09-25T09:00:12.481Z", "endpoint": "/emails", "method": "POST", "response_status": 200, "user_agent": "node" }
  ]
}
GET/logs/:idRetrieve a request
curl https://api.irisend.com/logs/1d20e63d-e6a7-4a65-831d-0556d3d3a6a1 \
  -H "Authorization: Bearer $IRISEND_API_KEY"
ResponseJSON
{
  "object": "log",
  "id": "1d20e63d-e6a7-4a65-831d-0556d3d3a6a1",
  "created_at": "2026-09-25T09:00:12.481Z",
  "endpoint": "/emails",
  "method": "POST",
  "response_status": 200,
  "user_agent": "node",
  "request_body": { "from": "[email protected]", "to": "[email protected]", "subject": "Your receipt" },
  "response_body": { "id": "em_9f2K3mQ1zPr7vT6yB4wL0nC" }
}