Get a contact's last activity

GET

/api/v3/contacts/{email}/last-active

const url = 'https://api.tryletterhead.com/api/v3/contacts/example/last-active?api=true';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/contacts/example/last-active?api=true' \
  --header 'Authorization: Bearer <token>'

Returns just the single most recent engagement event for a contact — its type (delivery, open, click, bounce, or purchase) and when it happened. For the full event-by-event history, use Get a contact’s activity; for rolled-up counters and rates, use Get a contact’s engagement breakdown.

This is a company-level (v3) read. Authenticate with a company API key as a Bearer token.

Authorizations

bearerAuth

Parameters

Path Parameters

email

required

string

The contact’s email address, URL-encoded.

Query Parameters

api

required

boolean

Required. Set to true.

channel

string

Narrow to the contact’s most recent event on a single newsletter, by channel slug. Returns 404 if the slug doesn’t match a channel in your company, or 403 if it names another company’s channel. Omit for the most recent event across every newsletter in the company.

Responses

200

200 OK

application/json

object

items

object

label

string

occurredAt

string

message

string

total

integer

Example

{
  "items": {
    "label": "open",
    "occurredAt": "2026-06-16T19:00:37+00:00"
  },
  "message": "Last active retrieved.",
  "total": 1
}

Still can’t find what you need? Contact support.