REFERENCE · REQUESTS AND VERDICTS

GET /v1/verdicts/{verdict_id}

One verdict. Returns the bare Verdict object, not wrapped. The list read, GET /insureds/{insured_ref}/verdicts, returns {data, next_cursor}. Branch on rules[].surface when kind is surface and on rules[].result when kind is verified.

PARAMETERS

NAME	TYPE	REQUIRED	DESCRIPTION
verdict_id	string	yes

RESPONSE

FIELD	TYPE	DESCRIPTION
verdict_id	string
kind	enum	surface, verified.
scope	enum	line, engagement.
coverage_line_id	string	Set when scope is line
insured_ref	string
consumer_ref	string
engagement_id	string	The engagement this verdict was judged for (0015)
requirement_set	object	The requirement set (lineage) this verdict was judged against (0015), so a caller holding several can tell them apart
requirement_set_version	integer
issued_at	timestamp
issued_by	enum	engine, reviewer.
status	enum	On kind surface: non_compliant if a hard rule fails on paper, pending if one is not yet on file or in review, else compliant. On the kind verified roll-up: non_compliant only when a source contradicts or denies a hard rule, insufficient_evidence when every line resolved and a hard rule is unconfirmed, compliant when every hard rule passes; a roll-up that reopens is superseded by pending One of: compliant, non_compliant, insufficient_evidence, pending.
grace_until	timestamp	null on a verdict. Read grace_until on the engagement, set by a requirement-set publish with applies_to all_active
rules	object[]	One entry per requirement. Branch on rules[].surface when kind is surface, and on rules[].result when kind is verified: at stage one result is usually unverified with reason verification_pending while the source is being contacted
wording	object	Generated text for display; it is not part of the contract (contractual: false) and may change without a version bump. Render from status and rules
supersedes	string
test	boolean

Errors: 401, 403, 404, 429, 500. Every error body carries error.code, error.message, and error.request_id.

import requests url = "https://api.insuranceverified.ai/v1/verdicts/…" headers = { "Authorization": "Bearer ive_live_…", } response = requests.get(url, headers=headers) print(response.status_code, response.json())

const url = "https://api.insuranceverified.ai/v1/verdicts/…"; const response = await fetch(url, { method: "GET", headers: { "Authorization": "Bearer ive_live_…" }, }); console.log(response.status, await response.json());

{ "verdict_id": "…", "kind": "surface", "scope": "engagement", "coverage_line_id": null, "insured_ref": "…", "consumer_ref": "…", "engagement_id": "…", "requirement_set": { "key": "default", "version": 3 }, "requirement_set_version": 3, "issued_at": "…", "issued_by": "engine", "status": "compliant", "grace_until": null, "rules": [ { "rule_key": "general_liability.limit_min.each_occurrence", "surface": "pass", "result": "unverified", "severity": "hard", "reasons": [ "verification_pending" ], "flags": [], "required": { "amount": 1000000 }, "observed": { "amount": 1000000 }, "document_class_required": "coi", "document_class_observed": "coi", "verification_required": "broker", "verification_observed": null, "coverage_line_id": "…", "satisfied_by": null, "satisfied_via_parent": null, "satisfied_via_program": null, "alternatives": null, "fact_ids": [ "…" ], "document_ids": [ "…" ] } ], "wording": { "summary": "…", "next": "…", "contractual": false }, "supersedes": "prior_verdict_id", "test": false }