# Succession Wills LLM API

> Generate a complete Last Will and Testament by supplying Will Builder fields as URL query parameters.

Base URL: https://app.successionwills.com/api/v1/llm
Docs: https://llm.successionwills.com/
OpenAPI: https://llm.successionwills.com/schemas/openapi.json
Field dictionary: https://llm.successionwills.com/schemas/will-fields.json

## Status

Live. GET https://app.successionwills.com/api/v1/llm creates a will and redirects to a clean WillDocument page. Add format=json for a JSON response.

## Endpoint

GET https://app.successionwills.com/api/v1/llm

Also reserved (less preferred):
https://app.successionwills.com/api/v1/llm/first_name=...&last_name=...

## Required parameters

- first_name (string)
- last_name (string)
- address_street (string)
- address_city (string)
- address_state (string)
- address_country (string)
- address_zip (string)
- marital_status (number: 1 Married, 2 Not Married, 3 Getting Married Soon, 4 Common-Law)
- has_children (boolean)
- executors (JSON array, min 1)
- residue_bens (JSON array, min 1)

## Conditionally required

- If marital_status in {1,3,4}: spouse_first_name, spouse_last_name
- If has_children=true: children (JSON array)
- If include_minors=true: first_name_primary_guardian, last_name_primary_guardian, primary_guardian_relationship

## Nested JSON (URL-encode these values)

executors item:
{"first_name":"David","last_name":"Wilson","relationship":"friend","order":1}

children item:
{"first_name":"Emily","last_name":"Smith","exclude":false,"order":1}

residue_bens common pattern:
[{"selection":"spouse","place":0},{"selection":"children","place":1}]

## Minimal example (readable)

https://app.successionwills.com/api/v1/llm
  ?first_name=John
  &last_name=Smith
  &address_street=123 Maple Street
  &address_city=Springfield
  &address_state=IL
  &address_country=United States
  &address_zip=62701
  &marital_status=1
  &spouse_first_name=Sarah
  &spouse_last_name=Smith
  &has_children=true
  &children=[{"first_name":"Emily","last_name":"Smith"}]
  &executors=[{"first_name":"David","last_name":"Wilson","relationship":"friend"}]
  &residue_bens=[{"selection":"spouse","place":0},{"selection":"children","place":1}]

## Optional advanced parameters

burial_selection, funeral_instructions, has_pets, pets, pet_guardian, cash_bens, bequests, age_benchmarks, wedlock_requirement_enable, wedlock_requirement, attorneys, sub_executors, manner_of_sub

## Response envelope

{"status":200,"success":true,"data":{...}}

## Human docs

https://llm.successionwills.com/