Insurance
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Insurance Policyinsurance_policy
An insurance policy with premiums, renewal, and coverage.
insurance_queryInsuranceDashboardFindthrough vritto_findList all non-archived insurance policies and claims. Use for coverage questions, renewal lookups, and to resolve policy or claim IDs before any write. Defaults to a compact summary: counts plus capped lean rows (policy type, provider, premium, renewal date, status; claim status, filed date, amount).
| Field | Type | Description |
|---|---|---|
| detail | one of summary, full | Response shape: "summary" (default, counts + capped lean policy/claim rows) or "full" (every record incl. deductibles, coverage details, contacts, and notes). |
insurance_upsertInsurancePolicyCreate or Updatethrough vritto_create or vritto_updateCreate or update one insurance policy. Omit policy.id to create (providerName required); include a real policy.id from insurance_queryInsuranceDashboard to update, sent fields merge over the existing record. Example: policy { providerName 'GEICO', type 'auto', premium 120, billingCadence 'monthly', deductible 500, expirationDate '2026-12-01' }.
| Field | Type | Description |
|---|---|---|
| policy* | object | Policy fields; providerName is required when creating. |
| policy.id | string | Existing policy ID to update, from a prior insurance_queryInsuranceDashboard result. Omit to create a new policy. |
| policy.providerName | string | Insurer or provider name, e.g. 'GEICO'. Required when creating. |
| policy.source | one of manual, import, bank | Where the record came from. Set by the ingestion pipeline; leave unset. |
| policy.websiteDomain | string | Provider website domain, e.g. 'geico.com'. Also used to resolve the logo. |
| policy.logoUrl | string | Logo image URL. Usually omit, the server resolves a logo automatically. |
| policy.policyNumber | string | Policy number. |
| policy.type | one of auto, home, renters, health, life, travel, pet, disability, umbrella, device, business, other | Coverage type (default 'other'). |
| policy.status | one of active, pending, expired, cancelled, shopping | Policy status. Defaults to 'active', or 'expired' when the expiration date has passed. Use 'shopping' for quotes under consideration. |
| policy.namedInsured | string | Named insured people, e.g. 'Tharun; spouse'. |
| policy.coverageSummary | string | Short summary of what the policy covers. |
| policy.currency | string | ISO 4217 currency code, e.g. 'USD' (default USD). |
| policy.premium | number | Premium per billing cadence in the given currency (default 0). |
| policy.billingCadence | one of monthly, quarterly, semiannual, yearly, one_time, unknown | How often the premium is billed (default 'monthly'). |
| policy.deductible | number | Deductible amount (default 0). |
| policy.coverageLimit | number | Coverage limit amount (default 0). |
| policy.effectiveDate | string | Coverage start date (YYYY-MM-DD). |
| policy.expirationDate | string | Coverage end date (YYYY-MM-DD). |
| policy.renewalDate | string | Renewal date (YYYY-MM-DD). Defaults to the expiration date. |
| policy.nextPaymentDate | string | Next premium payment date (YYYY-MM-DD). |
| policy.renewalReminderDays | integer | Days before a renewal, expiration, or premium date to send the reminder (default 14, 0 = on the day). |
| policy.agentName | string | Agent or broker name. |
| policy.agentPhone | string | Agent phone number. |
| policy.agentEmail | string | Agent email address. |
| policy.customerServicePhone | string | Customer service or claims phone number. |
| policy.notes | string | Notes or details. |
| policy.coveredPersonIds | list of string | People person ids this policy covers; replaces wholesale. |
| policy.tags | list of string | Tags. |
| policy.assetIds | list of string | Linked Assets document IDs (policy documents, receipts, evidence). IDs come from the Assets module, resolve with files_queryFiles or an assets upload flow; never invented. |
Example input
{
"policy": {
"providerName": "State Farm",
"type": "auto",
"status": "active",
"premium": 684,
"billingCadence": "semiannual",
"renewalDate": "2027-02-14"
}
}insurance_deleteInsurancePolicyDeletethrough vritto_deleteDelete (archive and mark cancelled) one insurance policy. Only for explicit removal requests, to record that a policy lapsed or was replaced, prefer insurance_upsertInsurancePolicy with status 'cancelled' or 'expired'. Resolve the ID with insurance_queryInsuranceDashboard first.
| Field | Type | Description |
|---|---|---|
| policyId* | string | Policy ID from a prior insurance_queryInsuranceDashboard result, never invented. |
Insurance Claiminsurance_claim
A claim against a policy.
insurance_upsertInsuranceClaimCreate or Updatethrough vritto_create or vritto_updateCreate or update one claim against a policy. policyId is required and must come from insurance_queryInsuranceDashboard. Omit claim.id to create; include a real claim.id to update, sent fields merge over the existing record. Example: claim { policyId '<id>', status 'open', incidentDate '2026-07-01', amountClaimed 1800, notes 'Windshield replacement' }.
| Field | Type | Description |
|---|---|---|
| claim* | object | Claim fields; policyId is required. |
| claim.id | string | Existing claim ID to update, from a prior insurance_queryInsuranceDashboard result. Omit to create a new claim. |
| claim.policyId* | string | ID of the covering policy from a prior insurance_queryInsuranceDashboard result, never invented. |
| claim.claimNumber | string | Insurer-assigned claim number. |
| claim.status | one of open, submitted, approved, paid, denied, closed | Claim status (default 'open'). |
| claim.incidentDate | string | Date of the incident (YYYY-MM-DD). |
| claim.filedDate | string | Date the claim was filed (YYYY-MM-DD). |
| claim.currency | string | ISO 4217 currency code for the claim amounts, e.g. 'INR'. Omit to inherit the covering policy's currency. |
| claim.amountClaimed | number | Amount claimed (default 0). |
| claim.amountPaid | number | Amount paid out so far (default 0). |
| claim.adjusterName | string | Adjuster name. |
| claim.adjusterPhone | string | Adjuster phone number. |
| claim.notes | string | Notes, timeline updates, or a claim preparation checklist. |
| claim.assetIds | list of string | Linked Assets document IDs (policy documents, receipts, evidence). IDs come from the Assets module, resolve with files_queryFiles or an assets upload flow; never invented. |
insurance_deleteInsuranceClaimDeletethrough vritto_deleteDelete (archive) one claim. Only for explicit removal requests, to record an outcome, prefer insurance_upsertInsuranceClaim with status 'closed', 'paid', or 'denied'. Resolve the ID with insurance_queryInsuranceDashboard first.
| Field | Type | Description |
|---|---|---|
| claimId* | string | Claim ID from a prior insurance_queryInsuranceDashboard result, never invented. |