List the org's deliverability findings

GET

/v1/reputation/findings

• Production
• Local

The caller’s org deliverability findings, newest-first. Supports ?status=, ?severity=, ?domain=, ?sender= filters and limit/cursor paging. Read-only; strictly org-scoped.

Authorizations

• AgentKey
  mailbox:read

Parameters

Query Parameters

status

string

Allowed values: open resolved

severity

string

Allowed values: low high unknown

domain

string

sender

string

limit

integer

default: 50 >= 1 <= 100

Page size for the cursor-paginated agent surface (default 50; clamped to the 1-100 range).

cursor

string

Opaque list pagination cursor.

Responses

200

A page of deliverability findings.

The paged list of the org’s deliverability findings (newest-first).

object

items

required

Array<object>

One deliverability finding (internal status/severity/type; raw provider vocabulary is not exposed).

object

id

required

string

type

required

Bounce/complaint/feedback_3p/ip_listing/dkim/dmarc/spf/bimi/suppression/account_health/unknown.

string

severity

required

string

Allowed values: low high unknown

status

required

string

Allowed values: open resolved

domain

string

sender

string

title

required

string

detail

required

string

first_seen_at

required

string format: date-time

last_seen_at

required

string format: date-time

resolved_at

string format: date-time

total

required

integer

next_cursor

Opaque cursor for the next page; absent on the last page.

string

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

403

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope