Spf

Get SPF diagnostics

get/domains/{domainId}/spf

Request

  • Base URL: https://api.palisade.email
  • URL: https://api.palisade.email/domains/{domainId}/spf
  • Auth: one of:
    • HTTP bearer
    • HTTP basic

Path parameters

domainIdstring uuid required

Headers

Palisade-Version'2025-04-30' | 'unstable' required

Response

Success

domain_idstring uuid required

Id of the domain the diagnostics are for.

domainstring required

The domain name whose live DNS was read, for example "example.com".

recordstring nullable required

The SPF TXT record live DNS serves for the domain, or null when none is published. When more than one v=spf1 record exists they are joined with newlines here; see records for them individually.

recordsstring[] required

Every v=spf1 TXT record found at the domain. More than one entry is itself an error — receivers treat it as a permanent failure.

ttlnumber nullable required

TTL of the SPF TXT record in seconds, when it could be read.

statusstring required

Overall SPF health: "pass", "warn" or "fail".

lookup_countinteger required

DNS lookups the record costs receivers: every include, a, mx, ptr, exists and redirect term, counted recursively through every include and redirect. Terms receivers never reach are not charged: anything to the right of a matching all, and a redirect= in a record that also carries an all, which RFC 7208 section 6.1 says must be ignored.

max_lookupsinteger required

The limit SPF imposes before receivers return a permanent error: 10.

lookups_remaininginteger required

How many more lookups the record could add before breaking. 0 when at or over the limit.

next_stepstring required

The single action Palisade suggests taking next.

Changes

No recorded changes to this operation across all 1 revision of this API.