---
title: "Calculate reviewed supplier delivery-event baselines"
method: POST
path: "/api/v1/supplier-deadlines"
tags: ["calculations"]
---

# Calculate reviewed supplier delivery-event baselines

`POST /api/v1/supplier-deadlines`

## Request

- Base URL: `https://secure-api-v1.liendeadline.com`
- URL: `https://secure-api-v1.liendeadline.com/api/v1/supplier-deadlines`
- Auth: none declared

Authenticated or website-proxied supplier-events-v1/v2 calculation for reviewed Florida/Kansas private-project baselines. V2 accepts explicit yes/no/unknown event answers. Other jurisdictions, public projects, and unreviewed events require qualified review. Ongoing deliveries do not produce a final lien date. Completed results consume plan or anonymous usage; no project is saved.

## Request body

- SupplierDeadlineRequest
  - `contract_version` 'supplier-events-v1' | 'supplier-events-v2', required
  - `role` string
  - `state` string, required
  - `first_delivery_date` string, required
  - `last_delivery_date` string
  - `project_type` 'commercial' | 'residential' | 'public', required
  - `hired_by` 'owner' | 'contractor' | 'subcontractor', required
  - `deliveries_complete` boolean, required
  - `special_events_reviewed` boolean
  - `florida_final_payment_date` string
  - `florida_termination_date` string
  - `florida_final_payment_status` 'yes' | 'no' | 'unknown'
  - `florida_termination_status` 'yes' | 'no' | 'unknown'
  - `kansas_extension_status` 'yes' | 'no' | 'unknown'

## Response `200`

Successful Response

- SupplierDeadlineCalculation
  - `contract_version` 'supplier-events-v1' | 'supplier-events-v2', required
  - `status` 'calculated' | 'review_required', required
  - `state_code` string, required
  - `role` string, required
  - `inputs` object, required
  - `preliminary_notice` SupplierDeadline, required
    - `name` string, required
    - `deadline` string, required
    - `days_from_now` integer, required
    - `required` boolean, required
    - `status` 'calculated' | 'not_required' | 'review_required' | 'awaiting_final_delivery', required
    - `description` string, required
    - `source_url` string
  - `lien_filing` SupplierDeadline, required
    - `name` string, required
    - `deadline` string, required
    - `days_from_now` integer, required
    - `required` boolean, required
    - `status` 'calculated' | 'not_required' | 'review_required' | 'awaiting_final_delivery', required
    - `description` string, required
    - `source_url` string
  - `critical_warnings` string[], required
  - `statute_citations` string[], required
  - `disclaimer` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/liendeadline/apis/lien-deadline-api.md) · [All operations](https://skmtc.dev/liendeadline/apis/lien-deadline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/liendeadline/apis/lien-deadline-api/revisions/170b4d579b4b?raw)