List Email Logs

Beta

GET/v1/core/email-logs

This endpoint is idempotent. Learn more

Returns a paginated list of email logs for the current account.

cursoroptional string

Cursor token used to retrieve the next or previous page of results.

limitoptional integer

Maximum number of results per page (default: 100, max: 1000).

qoptional string

Search query used to filter results.

include[]optional arrayenumValues:sent_by

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

URL to fetch the next page, null if no more pages.

previous_page_urlstringnullable

URL to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Resources in this page.

idstring

Email log ID.

objectstringenumValues:email_log

Resource type identifier.

send_statusstringenumValues:sentpending

Email send status.

recipientsarray of string

Recipient email addresses.

subjectstringnullable

Email subject line.

filenamestringnullable

Filename of any attachment.

sent_byobjectExpandablenullable

Actor who sent the email. Null when the email was sent by the system.

idstring

Actor ID.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

namestringnullable

Display name.

handlestringnullable

Human-readable handle (email for users, redacted_value for API keys, slug for agents).

roleobjectnullable

Assigned role.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Email Logs

List Email Logs

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listEmailLog = await client.core.emailLogs.list();

console.log(listEmailLog.data);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listEmailLog = await client.core.emailLogs.list();

console.log(listEmailLog.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/core/email-logs?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiZW1sXzAxN2I4MDcwN2FkYTkyZGRkZmY4YTJjM2EwIiwiZCI6ImYifQ.U9OqoBoCU2Cda0dZGjVwMLeet-DH4QIE9RDWS8LmEk8",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "eml_017b80707ada92dddff8a2c3a0",
      "object": "email_log",
      "send_status": "sent",
      "recipients": [
        "customer@example.com"
      ],
      "subject": "Order Confirmation #1001",
      "filename": "invoice_1001.pdf",
      "sent_by": {
        "id": "us_0151164dcaea4cbded27b50aae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/core/email-logs?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiZW1sXzAxN2I4MDcwN2FkYTkyZGRkZmY4YTJjM2EwIiwiZCI6ImYifQ.U9OqoBoCU2Cda0dZGjVwMLeet-DH4QIE9RDWS8LmEk8",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "eml_017b80707ada92dddff8a2c3a0",
      "object": "email_log",
      "send_status": "sent",
      "recipients": [
        "customer@example.com"
      ],
      "subject": "Order Confirmation #1001",
      "filename": "invoice_1001.pdf",
      "sent_by": {
        "id": "us_0151164dcaea4cbded27b50aae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": null
      },
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Email Logs

Query Parameters

Returns

Responses