API reference

Logs

Every authenticated request to the API is logged: who called what, when, and with which result. Use the log to debug integrations and to audit key usage.

Both endpoints need a full-access key whose creator holds the API controls privilege in the console. They can also return the common errors listed in the overview.

What is logged

One entry per request made with a valid key of your company, including requests that were then refused (for example for a missing permission or the rate limit). Requests refused before a key is accepted (a missing or invalid key, tsmartSend turned off, a caller address that is not allowed) and requests to unknown paths or with an unsupported method are not logged. Only the method, path, status, error name and user agent are kept, never request or response bodies, and entries are deleted after 30 days. An entry is written right after the response, so it can appear a moment later.

GET /logs

Lists the requests of the last 30 days, newest first.

Permission: full access; the key's creator needs the API controls privilege.

Query

Request

curl "https://send.tsmart.ai/logs?limit=2" \
  -H "Authorization: Bearer $TSMART_API_KEY"

Response

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
      "created_at": "2026-10-12 09:15:02.638091+00",
      "endpoint": "/emails",
      "method": "POST",
      "response_status": 200,
      "user_agent": "tsmart-node/1.1.1"
    },
    {
      "id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
      "created_at": "2026-10-12 09:14:58.190274+00",
      "endpoint": "/emails",
      "method": "POST",
      "response_status": 403,
      "user_agent": "tsmart-cli/1.1.0"
    }
  ]
}

Errors

GET /logs/{id}

Returns one log entry, with the error name of a failed request.

Permission: full access; the key's creator needs the API controls privilege.

Path

Request

curl https://send.tsmart.ai/logs/1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9 \
  -H "Authorization: Bearer $TSMART_API_KEY"

Response

{
  "object": "log",
  "id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
  "created_at": "2026-10-12 09:14:58.190274+00",
  "endpoint": "/emails",
  "method": "POST",
  "response_status": 403,
  "error": "domain_not_verified",
  "user_agent": "tsmart-cli/1.1.0"
}

The fields are those of the list plus object (always "log") and error: the name of the error response for a status of 400 or more, otherwise null.

Errors