Get Sending Status

GET

api

sending-status

Get Sending Status

curl --request GET \
  --url https://api.sequenzy.com/api/v1/sending-status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/sending-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/sending-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/sending-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sending-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": "paused",
  "pauseReason": "Bounce rate (9.910%) exceeded threshold (5%) for 111 total emails",
  "pauseReasonKind": "high_hard_bounce_rate",
  "pausedAt": "2026-08-05T09:12:00Z",
  "selfResume": {
    "canSelfResume": true,
    "supported": true,
    "allowedByAdmin": true,
    "ownerIsTrusted": false,
    "aiReviewStatus": "approved",
    "aiReviewReason": null,
    "aiReviewStartedAt": "2026-08-05T09:12:01Z",
    "aiReviewedAt": "2026-08-05T09:12:44Z",
    "unavailableReason": null
  },
  "senderHealth": {
    "enforcementMode": "enforce",
    "scopedSent": 111,
    "bounceScopedSent": 111,
    "complaintScopedSent": 111,
    "hardBounce": {
      "count": 11,
      "rate": 9.91,
      "warnThreshold": { "rate": 3, "count": null },
      "pauseThreshold": { "rate": 5, "count": null }
    },
    "softBounce": {
      "count": 2,
      "rate": 1.802,
      "warnThreshold": { "rate": 6, "count": null },
      "pauseThreshold": { "rate": 10, "count": null }
    },
    "complaint": {
      "count": 0,
      "rate": 0,
      "warnThreshold": { "rate": null, "count": 2 },
      "pauseThreshold": { "rate": null, "count": 3 }
    }
  },
  "metricsWindow": {
    "kind": "all_time_since_reset",
    "expiresAt": null,
    "bounceResetAt": null,
    "complaintResetAt": null,
    "description": "Sender-health enforcement uses all-time totals from the reset watermark, not a rolling window."
  },
  "remediation": {
    "steps": [
      "Fix the source of the bad addresses (import, form, or integration) so no new invalid addresses enter the list.",
      "Leave every permanent bounce suppressed. Removing suppressions re-sends to known-bad addresses and pauses the account again.",
      "Confirm the list has been cleaned, then request a resume."
    ],
    "supportEmail": "nic@sequenzy.com",
    "docsUrl": "https://docs.sequenzy.com/guides/sender-health",
    "dashboardPath": "/dashboard/company/comp_abc123",
    "dashboardUrl": "https://sequenzy.com/dashboard/company/comp_abc123"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Check whether a workspace can send email right now. Returns the pause reason, the sender-health rates measured against the thresholds that apply at your volume, the automated review state, whether you can restore sending yourself, and ordered remediation steps. Call this whenever a send, sequence step, or test send fails for a reason that is not a validation error. A company-level pause blocks every send, including test sends. Requires the account:read scope, so a read-only key can diagnose a blocked account.

Sender-health enforcement uses all-time totals counted from a reset watermark, not a rolling window. metricsWindow.expiresAt is always null - a paused rate does not decay and waiting will not restore sending. See Sender Health.

Request

curl "https://api.sequenzy.com/api/v1/sending-status" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

string

active, paused, or suspended. Anything other than active blocks every send for this workspace.

string

The enforcement message, including the measured rate, the threshold it crossed, and the send volume it was measured over. null when sending is active.

string

One of high_hard_bounce_rate, high_soft_bounce_rate, high_complaint_rate, phishing_guard, manual, or other. Only high_hard_bounce_rate can be cleared with the resume endpoint.

string

ISO timestamp of the pause. null when sending is active.

boolean

Whether resume will succeed right now.

string

When canSelfResume is false, the gate that is blocking it: waiting_for_review, blocked_by_ai, review_failed, blocked_by_admin, or unsupported_reason. null when resume is available.

string

State of the automated sender-health review: not_required, pending, approved, flagged, or failed.

object

Enforcement counts and thresholds for hardBounce, softBounce, and complaint, plus their non-test send denominators: bounceScopedSent for bounce rates and complaintScopedSent for complaint rates. scopedSent is a backward-compatible alias for bounceScopedSent. Also includes enforcementMode. null when the workspace has no metrics record yet or sender-health analytics are temporarily unavailable; pause state and remediation remain authoritative during an analytics outage.

object

kind is always all_time_since_reset and expiresAt is always null. bounceResetAt and complaintResetAt are the watermarks the totals are counted from.

object

steps for the current state, in order, plus supportEmail, docsUrl, and dashboardUrl.

Responses

{
  "success": true,
  "status": "paused",
  "pauseReason": "Bounce rate (9.910%) exceeded threshold (5%) for 111 total emails",
  "pauseReasonKind": "high_hard_bounce_rate",
  "pausedAt": "2026-08-05T09:12:00Z",
  "selfResume": {
    "canSelfResume": true,
    "supported": true,
    "allowedByAdmin": true,
    "ownerIsTrusted": false,
    "aiReviewStatus": "approved",
    "aiReviewReason": null,
    "aiReviewStartedAt": "2026-08-05T09:12:01Z",
    "aiReviewedAt": "2026-08-05T09:12:44Z",
    "unavailableReason": null
  },
  "senderHealth": {
    "enforcementMode": "enforce",
    "scopedSent": 111,
    "bounceScopedSent": 111,
    "complaintScopedSent": 111,
    "hardBounce": {
      "count": 11,
      "rate": 9.91,
      "warnThreshold": { "rate": 3, "count": null },
      "pauseThreshold": { "rate": 5, "count": null }
    },
    "softBounce": {
      "count": 2,
      "rate": 1.802,
      "warnThreshold": { "rate": 6, "count": null },
      "pauseThreshold": { "rate": 10, "count": null }
    },
    "complaint": {
      "count": 0,
      "rate": 0,
      "warnThreshold": { "rate": null, "count": 2 },
      "pauseThreshold": { "rate": null, "count": 3 }
    }
  },
  "metricsWindow": {
    "kind": "all_time_since_reset",
    "expiresAt": null,
    "bounceResetAt": null,
    "complaintResetAt": null,
    "description": "Sender-health enforcement uses all-time totals from the reset watermark, not a rolling window."
  },
  "remediation": {
    "steps": [
      "Fix the source of the bad addresses (import, form, or integration) so no new invalid addresses enter the list.",
      "Leave every permanent bounce suppressed. Removing suppressions re-sends to known-bad addresses and pauses the account again.",
      "Confirm the list has been cleaned, then request a resume."
    ],
    "supportEmail": "nic@sequenzy.com",
    "docsUrl": "https://docs.sequenzy.com/guides/sender-health",
    "dashboardPath": "/dashboard/company/comp_abc123",
    "dashboardUrl": "https://sequenzy.com/dashboard/company/comp_abc123"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Get Sending Status

curl --request GET \
  --url https://api.sequenzy.com/api/v1/sending-status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/sending-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/sending-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/sending-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/sending-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": "paused",
  "pauseReason": "Bounce rate (9.910%) exceeded threshold (5%) for 111 total emails",
  "pauseReasonKind": "high_hard_bounce_rate",
  "pausedAt": "2026-08-05T09:12:00Z",
  "selfResume": {
    "canSelfResume": true,
    "supported": true,
    "allowedByAdmin": true,
    "ownerIsTrusted": false,
    "aiReviewStatus": "approved",
    "aiReviewReason": null,
    "aiReviewStartedAt": "2026-08-05T09:12:01Z",
    "aiReviewedAt": "2026-08-05T09:12:44Z",
    "unavailableReason": null
  },
  "senderHealth": {
    "enforcementMode": "enforce",
    "scopedSent": 111,
    "bounceScopedSent": 111,
    "complaintScopedSent": 111,
    "hardBounce": {
      "count": 11,
      "rate": 9.91,
      "warnThreshold": { "rate": 3, "count": null },
      "pauseThreshold": { "rate": 5, "count": null }
    },
    "softBounce": {
      "count": 2,
      "rate": 1.802,
      "warnThreshold": { "rate": 6, "count": null },
      "pauseThreshold": { "rate": 10, "count": null }
    },
    "complaint": {
      "count": 0,
      "rate": 0,
      "warnThreshold": { "rate": null, "count": 2 },
      "pauseThreshold": { "rate": null, "count": 3 }
    }
  },
  "metricsWindow": {
    "kind": "all_time_since_reset",
    "expiresAt": null,
    "bounceResetAt": null,
    "complaintResetAt": null,
    "description": "Sender-health enforcement uses all-time totals from the reset watermark, not a rolling window."
  },
  "remediation": {
    "steps": [
      "Fix the source of the bad addresses (import, form, or integration) so no new invalid addresses enter the list.",
      "Leave every permanent bounce suppressed. Removing suppressions re-sends to known-bad addresses and pauses the account again.",
      "Confirm the list has been cleaned, then request a resume."
    ],
    "supportEmail": "nic@sequenzy.com",
    "docsUrl": "https://docs.sequenzy.com/guides/sender-health",
    "dashboardPath": "/dashboard/company/comp_abc123",
    "dashboardUrl": "https://sequenzy.com/dashboard/company/comp_abc123"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Overview

Companies

Sync Rules

Shopify

Websites

Integrations

Sender Profiles

Tracking Settings

Sending Status

Notification Preferences

Subscribers

Tags

Lists

Events

Segments

Audience Syncs

Migrations

Products

Media

Analytics

Sequences

Generation

SMS

Campaigns

Landing Pages

Emails

A/B Tests

Email Sends

Suppressions

Transactional

Templates

Widgets

Commerce

Webhooks

Team

Conversations

Get Sending Status

Request

Response fields

Responses

​Request

​Response fields

​Responses

Request

Response fields

Responses