---
title: "Discover canonical supplier event questions before collecting dates"
method: GET
path: "/api/v1/supplier-deadlines/questions"
tags: ["calculations"]
---

# Discover canonical supplier event questions before collecting dates

`GET /api/v1/supplier-deadlines/questions`

## Request

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

## Query parameters

- `contract_version` string, required
- `state` string, required
- `role` string
- `project_type` 'commercial' | 'residential' | 'public', required
- `hired_by` 'owner' | 'contractor' | 'subcontractor', required

## Response `200`

Successful Response

- PresentedQuestionsResponse
  - `contract_version` string
  - `scope` object, required
  - `scope_status` 'supported' | 'no_lien_right' | 'review_required', required
  - `reason_code` string, required
  - `description` string, 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
  - `questions` PresentedQuestion[], required
    - `id` string, required
    - `label` string, required
    - `help` string, required
    - `answers` string[]
    - `date_policy` 'required_for_calculation_if_yes' | 'optional_review_only' | 'forbidden', required
    - `applies_when` Conditions
      - `all` Predicate[]
        - `event` string, required
        - `answer` 'yes' | 'no', required
    - `affects` string[], required
    - `source_ids` string[], required
    - `group` 'core' | 'exceptions', required
    - `ordinary_answer` 'yes' | 'no'
  - `sources` object[], required
  - `exclusions` string[], required
  - `warnings` 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)