Email Providers

Live status of SES event tracking for a provider

get/email-providers/{id}/tracking/status

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/email-providers/{id}/tracking/status
  • Auth: HTTP bearer

Path parameters

idinteger required

Provider ID

Response

Event tracking status

last_event_atstring nullable

Most recent delivered/bounced/complained event recorded for an email sent through this provider. null means no provider feedback has arrived yet.

sns_topic_arnstring nullable
subscription_confirmed_atstring nullable

When the SNS subscription for the current topic was confirmed. null with a topic set usually means the subscription is still pending — most often because the endpoint was subscribed before the topic ARN was saved here.

supports_event_trackingboolean required

Only SES providers support SNS event tracking.

webhook_urlstring required

Public webhook endpoint SNS must deliver events to.

Example response

{
  "last_event_at": "2026-07-18T10:31:00Z",
  "subscription_confirmed_at": "2026-07-18T10:30:00Z",
  "webhook_url": "https://temps.example.com/api/t/webhook/ses"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.