Skip to main content
GET
Verify message provenance

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Query Parameters

id
string

RFC message id of a Dairo-sent message (the by-message verify path).

agent
string

Portable agentId (agt_...) from the provenance header.

kid
string

Key id from the provenance header.

from
string

Sender address (canonical field).

to
string

Comma-joined to+cc recipients (canonical field).

subject
string

Message subject (canonical field).

ts
string

Provenance timestamp ts (canonical field).

sig
string

base64url Ed25519 signature from the provenance header.

Response

Success

verified
boolean
required
issuer
string
required
checkedAt
string<date-time>
required
reason
string | null

Set when verified=false (unknown_kid, bad_signature, unknown_agent, passport_revoked, message_not_found, ...).

agent
object | null
keyId
string | null