Submit a vehicle owner's total-loss situation to SecondAppraisal on their behalf. Minimum: one of customer.phone / customer.email, your `agent` self-identification, a `consent.attestation`, and `consent.owner_authorization` (the fixed sentence, word for word). Returns a receipt with `customer_confirmation_url` (one tap confirms), a relayable `customer_message`, an optional `preliminary` market read, `contact_policy` (we email and text the customer once with the confirm link, and a person calls only after the customer confirms through it or contacts us), and `pricing` — the consultation is free; if the owner wants more, Appraisal Research is $199 (paid up front) or the Appointed Appraiser Service (our Appraisal Research, appointment as the customer's appraiser under the policy's appraisal clause, determining the amount of loss with the insurer's appraiser, and the appraisal award letter) is $495 with a $25 discount for customers you send ($470; a card HOLD, not a charge). The Appointed Appraiser Service fee is a flat fee, held on the card and charged after the result. An umpire's fee, if one is needed, is separate. Never promise an outcome. The $25 applies to the Appointed Appraiser Service (`representation`) only. You may quote `pricing` verbatim; payment always happens on our site by the customer's own click (`checkout` links appear once they have confirmed) — never collect card details. Read `customer_message` to the user verbatim.
View input schema
{
"type": "object",
"properties": {
"agent": {
"type": "object",
"properties": {
"name": {
"allOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "string",
"minLength": 1,
"maxLength": 120
}
],
"description": "Human-readable name of the agent or product submitting on the customer's behalf (e.g. \"OpenClaw\", \"Acme Claims Copilot\"). Shown to the customer."
},
"platform": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,59}$",
"description": "Platform slug for attribution. Known values: openclaw, chatgpt, claude, gemini, copilot, perplexity, custom. Any lowercase slug is accepted."
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "Agent / integration version string."
},
"operator_url": {
"type": "string",
"format": "uri",
"maxLength": 300,
"description": "Homepage or documentation URL of the agent operator."
}
},
"required": [
"name",
"platform"
],
"additionalProperties": false,
"description": "Who is calling. Required — an intake without self-identification is refused."
},
"customer": {
"type": "object",
"properties": {
"first_name": {
"allOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"minLength": 1,
"maxLength": 80
}
]
},
"last_name": {
"allOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"minLength": 1,
"maxLength": 80
}
]
},
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "Customer email address."
},
"phone": {
"allOf": [
{
"type": "string"
},
{
"type": "string",
"pattern": "^[2-9]\\d{9}$"
}
],
"description": "US mobile or landline number. Punctuation and a leading +1 are tolerated."
}
},
"additionalProperties": false,
"description": "The vehicle owner. At least one of email / phone is required; everything else is optional."
},
"vehicle": {
"type": "object",
"properties": {
"vin": {
"allOf": [
{
"type": "string"
},
{
"type": "string",
"minLength": 11,
"maxLength": 17
}
],
"description": "Vehicle Identification Number. A full 17-character VIN lets us decode year/make/model/trim."
},
"plate": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "License plate. Requires plate_state to resolve a VIN."
},
"plate_state": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two-letter US state code, e.g. TX."
},
"year": {
"type": "integer",
"minimum": 1900,
"maximum": 2100
},
"make": {
"allOf": [
{
"type": "string",
"maxLength": 60
},
{
"type": "string",
"minLength": 1,
"maxLength": 60
}
]
},
"model": {
"allOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"minLength": 1,
"maxLength": 80
}
]
},
"trim": {
"allOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"minLength": 1,
"maxLength": 80
}
]
},
"odometer": {
"type": "integer",
"minimum": 0,
"maximum": 2000000,
"description": "Odometer reading in miles at the time of loss."
}
},
"additionalProperties": false,
"description": "The vehicle. A VIN (or plate + plate_state) is best; year/make/model works too."
},
"loss": {
"type": "object",
"properties": {
"date_of_loss": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Calendar date, YYYY-MM-DD."
},
"loss_state": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "State where the loss occurred / the policy is written."
},
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$",
"description": "US ZIP code (5 or 5+4). Used to search comparable vehicles near the customer."
},
"insurance_path": {
"type": "string",
"enum": [
"own",
"at-fault",
"unknown",
"none"
],
"description": "Whose insurance is handling it: own (customer's carrier), at-fault (the other driver's carrier), unknown, or none (no insurance claim — valuation only)."
}
},
"additionalProperties": false,
"description": "When and where the loss happened."
},
"offer": {
"type": "object",
"properties": {
"insurer": {
"allOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "string",
"minLength": 1,
"maxLength": 120
}
],
"description": "Insurance company handling the total loss."
},
"claim_number": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"acv_offer_cents": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "Insurer's Actual Cash Value offer in cents. `acv_offer` (dollars) is also accepted."
},
"acv_offer": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Insurer's Actual Cash Value offer in dollars. Converted to cents server-side."
}
},
"additionalProperties": false,
"description": "The insurer's position so far, if any."
},
"consent": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"customer_directed",
"warm_handoff"
],
"default": "customer_directed",
"description": "customer_directed: the customer asked their agent to submit this. warm_handoff: a registered agent attests the customer asked to be contacted now (priority callback; requires an API key)."
},
"attestation": {
"type": "string",
"minLength": 20,
"maxLength": 1000,
"description": "The agent's attestation, in its own words, that the customer asked for this submission and knows SecondAppraisal will email and text them once with a confirm link, and will call only after they confirm. Stored verbatim on the intake."
},
"owner_authorization": {
"type": "string",
"enum": [
"My owner asked me to submit this request and authorizes SecondAppraisal to email and text them about it, and to call them once they confirm."
],
"description": "Required: this exact sentence, which you accept on your owner's behalf beside your own words: \"My owner asked me to submit this request and authorizes SecondAppraisal to email and text them about it, and to call them once they confirm.\" (version 2026-11-09.1). Stored with its version on the intake."
},
"attestor_name": {
"allOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "string",
"minLength": 1,
"maxLength": 120
}
],
"description": "Who is attesting (the agent, or the person operating it)."
},
"notify_customer": {
"type": "boolean",
"default": true,
"description": "true (default): we send the customer our welcome email and text with the confirm link. false: you relay `customer_message` and `customer_confirmation_url` yourself and we send nothing. Either way we call only after the customer confirms through the link or contacts us."
}
},
"required": [
"attestation",
"owner_authorization"
],
"additionalProperties": false,
"description": "Consent basis. Attestation wording version 2026-11-09.1."
},
"external_ref": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Your reference id; echoed in every response."
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Any unique string per logical submission; a replay returns the original receipt."
}
},
"required": [
"agent",
"customer",
"consent"
],
"additionalProperties": false,
"description": "Submit a vehicle owner's total-loss situation on their behalf."
}