---
title: "Calculate against the discovered canonical supplier event contract"
method: POST
path: "/api/v1/supplier-deadlines/v3"
tags: ["calculations"]
---

# Calculate against the discovered canonical supplier event contract

`POST /api/v1/supplier-deadlines/v3`

## Request

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

## Request body

- SupplierV3Request
  - `contract_version` string, required
  - `state` string, required
  - `role` string
  - `project_type` 'commercial' | 'residential' | 'public', required
  - `hired_by` 'owner' | 'contractor' | 'subcontractor', required
  - `rules_source` RulesIdentity, required
    - `schema_version` 'state-rules-v1' | 'state-rules-v2', required
    - `source_version` string, required
    - `source_hash` string, required
    - `reviewed_commit` string, required
    - `supplier_engine_version` string, required
    - `implementation_manifest_hash` string, required
  - `questions_identity` QuestionsIdentity, required
    - `questions_version` string
    - `question_set_hash` string, required
  - `events` object, required

## Response `200`

Successful Response

- SupplierV3Response
  - `contract_version` string
  - `status` 'calculated' | 'no_lien_right' | 'awaiting_final_delivery' | 'review_required', required
  - `as_of_date` string, required
  - `state_code` string, required
  - `role` string
  - `inputs` object, required
  - `rules_source` RulesIdentity, required
    - `schema_version` 'state-rules-v1' | 'state-rules-v2', required
    - `source_version` string, required
    - `source_hash` string, required
    - `reviewed_commit` string, required
    - `supplier_engine_version` string, required
    - `implementation_manifest_hash` string, required
  - `questions_identity` QuestionsIdentity, required
    - `questions_version` string
    - `question_set_hash` string, required
  - `preliminary_notice` SupplierDeadlineV3, required
    - `name` string, required
    - `status` 'calculated' | 'not_required' | 'no_lien_right' | 'awaiting_final_delivery' | 'review_required', required
    - `deadline` string, required
    - `days_from_now` integer, required
    - `required` boolean, required
    - `description` string, required
    - `reason_code` string, required
    - `event_ids` string[]
    - `source_ids` string[]
    - `candidate_deadlines` CandidateDeadline[]
      - `id` string, required
      - `date` string, required
      - `source_ids` string[], required
    - `action_by` string
  - `lien_filing` SupplierDeadlineV3, required
    - `name` string, required
    - `status` 'calculated' | 'not_required' | 'no_lien_right' | 'awaiting_final_delivery' | 'review_required', required
    - `deadline` string, required
    - `days_from_now` integer, required
    - `required` boolean, required
    - `description` string, required
    - `reason_code` string, required
    - `event_ids` string[]
    - `source_ids` string[]
    - `candidate_deadlines` CandidateDeadline[]
      - `id` string, required
      - `date` string, required
      - `source_ids` string[], required
    - `action_by` string
  - `sources` object[], required
  - `critical_warnings` 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)