Skip to main content

​
Overview

The enforcement log records every send limit action taken across your mailboxes. When a mailbox exceeds its daily send limit, Exchange blocks outbound mail and TenantCore logs the event. When the limit resets and the mailbox is unblocked, that is logged as well. Use this endpoint to audit enforcement activity, debug delivery issues, or monitor send volume trends across your infrastructure.

​
List enforcement events

Returns enforcement events across all your tenants, ordered by most recent first. Supports filtering by tenant and action type, and pagination. 
GET /v1/enforcement/events
Query parameters
ParameterTypeDefaultDescription
tenant_idstring—Filter events to a specific tenant
actionstring—Filter by action: blocked or unblocked
limitnumber50Number of results to return. Max 200.
offsetnumber0Pagination offset
Example request — all events 
curl "https://api.tenantcore.io/v1/enforcement/events" \
  -H "Authorization: Bearer tc_live_your_key"
Example request — blocks only for a specific tenant 
curl "https://api.tenantcore.io/v1/enforcement/events?tenant_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&action=blocked" \
  -H "Authorization: Bearer tc_live_your_key"
Example request — paginated 
curl "https://api.tenantcore.io/v1/enforcement/events?limit=100&offset=100" \
  -H "Authorization: Bearer tc_live_your_key"
Example response 
{
  "events": [
    {
      "id": "uuid",
      "tenant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "mailbox_address": "sales@mail.acmecorp.com",
      "action_taken": "blocked",
      "sent_count": 26,
      "limit_value": 25,
      "message": "Mailbox blocked: sent 26, limit 25",
      "created_at": "2025-04-20T14:30:00Z"
    },
    {
      "id": "uuid",
      "tenant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "mailbox_address": "sales@mail.acmecorp.com",
      "action_taken": "unblocked",
      "sent_count": 0,
      "limit_value": 25,
      "message": "Mailbox unblocked: sent 0, limit 25",
      "created_at": "2025-04-21T00:05:00Z"
    }
  ],
  "count": 2,
  "total": 2,
  "limit": 50,
  "offset": 0,
  "filters": {
    "tenant_id": null,
    "action": null
  }
}
Response fields
FieldTypeDescription
eventsarrayList of enforcement events
countnumberNumber of events in this response
totalnumberTotal matching events across all pages
limitnumberThe limit applied to this request
offsetnumberThe offset applied to this request
filtersobjectThe filters that were applied
Event fields
FieldTypeDescription
tenant_idstringThe tenant this event belongs to
mailbox_addressstringThe affected mailbox email address
action_takenstringblocked or unblocked
sent_countnumberSend count at the time enforcement ran
limit_valuenumberThe configured limit at the time of the event
messagestringHuman-readable summary of the enforcement action
created_attimestampWhen the enforcement event was logged

​
Pagination

Use limit and offset to page through large result sets. The total field in the response tells you how many matching events exist across all pages. 
async function getAllEnforcementEvents(apiKey) {
  const limit  = 200;
  let   offset = 0;
  let   all    = [];

  while (true) {
    const res = await fetch(
      `https://api.tenantcore.io/v1/enforcement/events?limit=${limit}&offset=${offset}`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    const data = await res.json();
    all.push(...data.events);

    if (all.length >= data.total) break;
    offset += limit;
  }

  return all;
}

​
Errors

StatusCodeDescription
404tenant_not_foundSpecified tenant_id does not exist or belongs to a different account