Docs

GET /trust/thresholds

The published enforcement thresholds and the ladder they drive. Same constants the ladder acts on, so nothing that draws a line has to hard-code one.

Parameters

This operation takes no parameters.

Responses

  • 200 Success
  • 400 Validation error
  • 401 Missing API key
  • 403 Forbidden
  • 404 Not found
  • 409 Conflict
  • 429 Rate limited
  • 500 Internal server error

Response headers

  • ratelimit-limit — Messages this API key may spend in one 60-second window.
  • ratelimit-remaining — Messages left in the current window.
  • ratelimit-reset — Seconds until the current window resets and the budget refills.

200 body

FieldTypeRequiredNotes
ladderarray<"ok" | "warning" | "throttled" | "paused">yes
metricsobjectyes
metrics.bounceobjectyes
metrics.complaintobjectyes
min_sampleintegeryes
throttled_sends_per_minuteintegeryes
window_daysintegeryes

Errors

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.