Calculate invoice deadlines (customer API key)
calculate_lien_deadlineCalculate preliminary notice and lien filing deadlines from a construction invoice date and US state, returning deadline dates, day counts, waiver due date, and rollover warnings.
Instructions
Customer API tool: requires LIENDEADLINE_API_KEY, a dedicated LienDeadline customer key; without one it returns a configuration error and makes no request. Calculates the preliminary notice and lien filing deadlines for one construction invoice from its invoice or delivery date and state. Returns JSON with state, invoice_date, project_type, preliminary_notice_deadline, lien_deadline, waiver_due_date, prelim_deadline_days, lien_deadline_days, warnings such as weekend or holiday rollover, notes and a disclaimer. A date, day count or project_type the API does not return is null; missing warnings is [] and missing notes is an empty string. API denials (401 key, 403 scope, 429 rate limit) return a tool error. Successful calculations consume one API plan unit. Not legal advice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"state": "<state>",
"invoice_date": "<invoice_date>"
},
"name": "calculate_lien_deadline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Your role on the project, e.g. "supplier", "contractor", "subcontractor". | |
| state | Yes | Two-letter US state code, e.g. "TX", "CA", "DC", from the jurisdictions the customer API supports. | |
| notice_date | No | Notice of completion date in YYYY-MM-DD format, if known; not the date a preliminary notice was sent. Omit otherwise. | |
| invoice_date | Yes | Invoice or delivery date in YYYY-MM-DD format; deadlines count from it. | |
| project_type | No | "commercial" or "residential" (case-insensitive). Omit for commercial. Changes the deadline in some states. |