sendsend.email
Sign inStart building

List request logs

GET/v1/logs

The last 30 days of calls made with this project’s API keys, newest first: what was called, the status, the time it took and the request id. Message content, recipients and request bodies are never stored. Reading the log does not add to it.

Required scope: emails:read

Parameters

NameInDescription
limitoptionalqueryPage size, 1 to 100. Default 20.
cursoroptionalqueryThe next_cursor from a previous page.
statusoptionalquerysuccess (below 400) or error (400 and above).
methodoptionalqueryOnly this HTTP method.
request_idoptionalqueryFind one request by its id (req_…).

Example

curl -X GET 'https://api.sendsend.email/v1/logs' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "data": [
    {
      "id": "log_Kd83…",
      "object": "log",
      "method": "POST",
      "route": "/v1/emails",
      "resource_id": null,
      "status": 202,
      "error_code": null,
      "duration_ms": 41,
      "request_id": "req_Kd83…",
      "key_id": "key_9Fq…",
      "created_at": "2026-10-06T15:04:05.000Z"
    }
  ],
  "next_cursor": null
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.