Read the account's sending policy

GET/api/v1/email/policy

authentication: Secret API key as a bearer token
billing: Free.

The rules behind ok_to_send on every email lookup this account runs: the signals that block, the risk-score ceiling and the mailbox-confidence floor. The policy belongs to the account, so every member reads and changes the same one. An undeliverable verdict is always blocked whatever the policy says.

Example request

curl https://spaw.co/api/v1/email/policy \
  -H "Authorization: Bearer sk_live_…"

const response = await fetch('https://spaw.co/api/v1/email/policy', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_…',
  },
});
const result = await response.json();

import requests

response = requests.get(
    'https://spaw.co/api/v1/email/policy',
    headers={'Authorization': 'Bearer sk_live_…'},
)
result = response.json()

$ch = curl_init('https://spaw.co/api/v1/email/policy');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer sk_live_…'],
]);
$result = json_decode(curl_exec($ch), true);

from spaw import Client

client = Client('sk_live_…')
result = client.get_email_policy()

import Spaw from 'spaw';

const spaw = new Spaw({ apiKey: 'sk_live_…' });
const result = await spaw.getEmailPolicy();

use Spaw\Client;

$spaw = new Client('sk_live_…');
$result = $spaw->getEmailPolicy();

This endpoint has no console on its page. It answers with records from your own account, often by an id only you have, rather than about a value you can type here. The dashboard lists the same rows.

Responses

200The policy in force.

{
    "success": true,
    "data": {
        "max_risk_score": 60,
        "block_signals": [
            "disposable",
            "likely_typo",
            "parked_domain",
            "mx_blocklisted",
            "no_reply"
        ],
        "min_mailbox_confidence": null,
        "is_default": true,
        "updated_at": null
    }
}

Error codes

Failures answer { success: false, error: { code, message, request_id } }. Each code has its own page.

markdown version·openapi.json