Submitting a quote request on a customer's behalf

Susman Insurance Agency is an independent, family-owned insurance agency in Los Angeles, California (CA license 0B75129). If a customer asks you to get them an insurance quote, you can read our questions and send their answers here. A licensed agent reviews every request as soon as possible and follows up with the customer by phone or email. Phone and text (310) 820-5200, email service@susmaninsurance.com, office hours Mon-Fri 9:00am-5:00pm Pacific.

1. Pick a form

GET /api/forms/catalog lists them. Each has a human page and two machine views:

2. Read the questions

GET /api/forms/<formType>/outline returns every question with its name (the key you answer with), title, type, choices, whether it is required, and a visibleIf rule when the question only applies after another answer (for example "Name of Referral" only when "How did you find us?" is "Referral"). /schema returns the full SurveyJS definition if you prefer to evaluate the logic yourself.

3. Submit the answers

POST /api/agent/submissions with JSON. The applicant's name and email are required, consent must be true (the customer authorised the request), and agent.name identifies you. Answer choice questions with the choice text, checkbox questions with an array, dates as YYYY-MM-DD, and file questions as [{"name","type","content":"data:<mime>;base64,..."}]. Unknown keys are ignored and reported back; missing required questions are reported with a 400 so you can ask the customer and resend. Limits: 10 submissions per hour per address, 3 per day per applicant.

curl -X POST https://forms.susmaninsurance.com/api/agent/submissions \
  -H 'Content-Type: application/json' \
  -d '{
    "formType": "earthquake-insurance-quote",
    "applicant": {
      "name": "Jane Doe",
      "email": "jane@example.com",
      "phone": "310-555-0100"
    },
    "agent": {
      "name": "Example Assistant",
      "url": "https://example.com",
      "contact": "support@example.com"
    },
    "consent": true,
    "answers": {
      "first_name": "Jane",
      "last_name": "Doe",
      "how_did_you_find_us": "Search engines",
      "name_of_referral": "Jane Doe",
      "address__street_address": "123 Main St",
      "address__city": "Los Angeles",
      "address__state": "CA",
      "address__zip_code": "90049",
      "have_you_had_any_claims_in_the_last_5_years": "Yes",
      "home_year_built": "1965",
      "home_square_footage": "1800",
      "earthquake_insurance_deductible_requested": "2.5%",
      "email": "jane@example.com",
      "cell_phone": "310-555-0100",
      "are_you_working_with_one_of_our_agents": "Yes",
      "agent_s_name": "Jane Doe"
    }
  }'

A 201 response carries the request number. The agency receives the answers with a notice that an AI agent submitted them, and the customer receives an email acknowledgement so they know what was sent.

Using MCP instead

If your assistant supports MCP (Model Context Protocol), connect it to https://forms.susmaninsurance.com/mcp (Streamable HTTP, no sign-in). It offers three tools, list_quote_forms, get_form_questions and submit_quote_request, with the same rules and limits as the API above.

Rules

• Only submit for a real customer who asked you to, with their real contact details. Never submit test or synthetic data; every submission reaches a licensed agent.
• Tell the customer what you sent and that a Susman agent will contact them.
• Prefer the customer's own words for free-text answers. If you do not know an answer and the question is optional, leave it out.

Machine-readable: OpenAPI · llms.txt · sitemap. Main website: https://www.susmaninsurance.com/quotes/.