LienDeadline API

https://liendeadline.com/api
Admin
The LienDeadline API provides a production-style API reference for deadline automation, allowing...
Tokens:3,636
Snippets:40
Trust Score:2.5
Update:4 months ago
Show doc for...
Tokens:
Raw
### GET /api/v1/state-guides/index

Source: https://liendeadline.com/api

Lightweight list endpoint used for dropdowns and UI controls before opening full guides.

```APIDOC
## GET /api/v1/state-guides/index

### Description
Lightweight list endpoint used for dropdowns and UI controls before opening full guides.

### Method
GET

### Endpoint
/api/v1/state-guides/index

### Response
#### Success Response (200)
- **states** (array) - List of states with their titles.
  - **state_code** (string) - The 2-letter state code.
  - **title** (string) - The title for the state's lien/notice guide.

#### Response Example
```json
{
  "states": [
    { "state_code": "CA", "title": "California Mechanics Lien" },
    { "state_code": "TX", "title": "Texas Preliminary Notice" }
  ]
}
```
```

--------------------------------

### POST /api/v1/calculate-deadline Request Example

Source: https://liendeadline.com/api/test-api

Example of a POST request to the calculate-deadline endpoint. Use this to prove your closeout day-count logic.

```json
{ "invoice_date": "2025-01-15", "state": "CA", "role": "supplier", "project_type": "commercial" }
```

--------------------------------

### Lightweight List of State Guides for UI Controls

Source: https://liendeadline.com/api

Provides a lightweight list of states with titles, suitable for populating dropdowns and UI controls before users access full guides.

```json
{
  "states": [
    { "state_code": "CA", "title": "California Mechanics Lien" },
    { "state_code": "TX", "title": "Texas Preliminary Notice" }
  ]
}
```

--------------------------------

### GET /api/v1/state-guides/{state}

Source: https://liendeadline.com/api

Pull state-specific guidance and rules when you need context for internal auditability.

```APIDOC
## GET /api/v1/state-guides/{state}

### Description
Pull state-specific guidance and rules when you need context for internal auditability.

### Method
GET

### Endpoint
/api/v1/state-guides/{state}

### Parameters
#### Path Parameters
- **state** (string) - Required - US state code (2 letters)

### Response
#### Success Response (200)
- **state** (string) - State code.
- **state_name** (string) - Full state name.
- **notice_window_days** (integer) - Default number of days for preliminary notice.
- **filing_deadline_rule** (string) - Rule for lien filing deadline.
- **references** (array) - Legal statute citations.

#### Response Example
```json
{
  "state": "CA",
  "state_name": "California",
  "notice_window_days": 90,
  "filing_deadline_rule": "30-day rule when notice of completion is filed",
  "references": ["Cal. Civ. Code §8200-8444"]
}
```
```

--------------------------------

### GET /api/v1/state-guides/{state}/calculator-payload

Source: https://liendeadline.com/api

Fetches normalized rule payload exactly as used by the calculator for downstream integrations.

```APIDOC
## GET /api/v1/state-guides/{state}/calculator-payload

### Description
Fetches normalized rule payload exactly as used by the calculator for downstream integrations.

### Method
GET

### Endpoint
/api/v1/state-guides/{state}/calculator-payload

### Parameters
#### Path Parameters
- **state** (string) - Required - US state code (2 letters)

### Response
#### Success Response (200)
- **state_code** (string) - The 2-letter state code.
- **state_name** (string) - The full name of the state.
- **rule_payload** (object) - The normalized rule payload for the calculator.
  - **preliminary_notice** (object) - Rules for preliminary notice.
    - **required** (boolean) - Whether preliminary notice is required.
    - **days** (integer) - The number of days for the notice.
    - **when** (string) - Conditions affecting the notice timing.
  - **lien_filing** (object) - Rules for lien filing.
    - **required** (boolean) - Whether lien filing is required.
    - **days** (integer) - The number of days for filing.

#### Response Example
```json
{
  "state_code": "CA",
  "state_name": "California",
  "rule_payload": {
    "preliminary_notice": {
      "required": true,
      "days": 20,
      "when": "Notice of completion may shorten timing"
    },
    "lien_filing": {
      "required": true,
      "days": 90
    }
  }
}
```
```

--------------------------------

### Calculate Deadline using cURL

Source: https://liendeadline.com/api

Example of how to make a POST request to the calculate-deadline endpoint using cURL. Ensure you include your API key for authorization and set the correct content type.

```curl
curl -X POST "https://secure-api-v1.liendeadline.com/v1/calculate-deadline" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_date": "2025-01-15",
    "state": "CA",
    "role": "supplier",
    "project_type": "commercial"
}'
```

--------------------------------

### GET /api/v1/supported-states

Source: https://liendeadline.com/api

Return the list of supported jurisdictions used for validation and routing.

```APIDOC
## GET /api/v1/supported-states

### Description
Return the list of supported jurisdictions used for validation and routing.

### Method
GET

### Endpoint
/api/v1/supported-states

### Response
#### Success Response (200)
- **states** (array) - List of state codes.
- **count** (integer) - Number of supported states.

#### Response Example
```json
{
  "states": ["AL", "AK", "AZ", "AR", "...", "WY", "DC"],
  "count": 51
}
```
```

--------------------------------

### Calculate Preliminary Notice and Lien Filing Deadlines

Source: https://liendeadline.com/api

Use this endpoint to calculate preliminary notice and lien filing deadlines based on invoice and project details. It returns required notice information, deadlines, and potential warnings or statute citations.

```json
{
  "preliminary_notice": {
    "required": true,
    "deadline": "2025-02-04",
    "days_from_now": 20
  },
  "lien_filing": {
    "deadline": "2025-04-15",
    "days_from_now": 90
  },
  "warnings": [
    "If Notice of Completion is filed, deadline can shorten to 30 days"
  ],
  "statute_citations": [
    "Cal. Civ. Code §8204(a)",
    "Cal. Civ. Code §8204(a)"
  ]
}
```

--------------------------------

### Calculate Lien Deadline

Source: https://liendeadline.com/api

Use this cURL command to make a POST request to calculate preliminary notice and lien filing deadlines. Ensure you replace YOUR_API_KEY with your actual API key and provide the correct invoice details.

```curl
curl -X POST "https://secure-api-v1.liendeadline.com/v1/calculate-deadline" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ 
    "invoice_date": "2025-01-15",
    "state": "CA",
    "role": "supplier",
    "project_type": "commercial"
}'
```

--------------------------------

### Calculate Deadline

Source: https://liendeadline.com/api

Use this endpoint to calculate and retrieve preliminary notice and lien filing deadlines based on invoice data. It supports calculations across all 50 states and DC.

```APIDOC
## POST /calculate-deadline

### Description
Calculates and returns preliminary notice and lien filing deadlines, along with remaining day counters, based on provided invoice details.

### Method
POST

### Endpoint
/calculate-deadline

### Parameters
#### Request Body
- **invoice_date** (string) - Required - The date of the invoice.
- **state** (string) - Required - The state for which to calculate deadlines (e.g., "CA").
- **role** (string) - Required - The role in the project (e.g., "supplier").
- **project_type** (string) - Required - The type of project (e.g., "commercial").

### Request Example
{
  "invoice_date": "2025-01-15",
  "state": "CA",
  "role": "supplier",
  "project_type": "commercial"
}

### Response
#### Success Response (200)
- **preliminary_notice_deadline** (string) - The deadline for the preliminary notice.
- **lien_filing_deadline** (string) - The deadline for the lien filing.
- **remaining_days_preliminary_notice** (integer) - The number of days remaining until the preliminary notice deadline.
- **remaining_days_lien_filing** (integer) - The number of days remaining until the lien filing deadline.

#### Response Example
{
  "preliminary_notice_deadline": "2025-02-14",
  "lien_filing_deadline": "2025-03-16",
  "remaining_days_preliminary_notice": 30,
  "remaining_days_lien_filing": 61
}
```

--------------------------------

### Pull State-Specific Guidance and Rules

Source: https://liendeadline.com/api

Fetches detailed state-specific guidance, including notice window days and filing deadline rules. This is useful for internal auditability.

```json
{
  "state": "CA",
  "state_name": "California",
  "notice_window_days": 90,
  "filing_deadline_rule": "30-day rule when notice of completion is filed",
  "references": ["Cal. Civ. Code §8200-8444"]
}
```

--------------------------------

### POST /api/v1/calculate-deadline

Source: https://liendeadline.com/api/test-api

Calculates preliminary and lien deadlines based on invoice date, state, role, and project type. This is the highest-value business call for most prospects and is useful for proving closeout day-count logic.

```APIDOC
## POST /api/v1/calculate-deadline

### Description
Calculates preliminary and lien deadlines and the number of days remaining based on the provided invoice details. This endpoint is crucial for proving closeout day-count logic quickly.

### Method
POST

### Endpoint
/api/v1/calculate-deadline

### Parameters
#### Request Body
- **invoice_date** (string) - Required - The date of the invoice.
- **state** (string) - Required - The state for which to calculate deadlines.
- **role** (string) - Required - The role of the user (e.g., 'supplier').
- **project_type** (string) - Required - The type of project (e.g., 'commercial').

### Request Example
{
  "invoice_date": "2025-01-15",
  "state": "CA",
  "role": "supplier",
  "project_type": "commercial"
}

### Response
#### Success Response (200)
- **preliminary_deadline** (string) - The calculated preliminary deadline.
- **lien_deadline** (string) - The calculated lien deadline.
- **days_remaining** (integer) - The number of days remaining until the lien deadline.
```

--------------------------------

### Retrieve List of Supported Jurisdictions

Source: https://liendeadline.com/api

This endpoint returns a list of all supported US states and the District of Columbia, used for validation and routing purposes.

```json
{
  "states": ["AL", "AK", "AZ", "AR", "...", "WY", "DC"],
  "count": 51
}
```

--------------------------------

### Fetch Normalized Rule Payload for Calculator

Source: https://liendeadline.com/api

Retrieves the normalized rule payload used by the calculator for downstream integrations. This includes preliminary notice and lien filing requirements.

```json
{
  "state_code": "CA",
  "state_name": "California",
  "rule_payload": {
    "preliminary_notice": {
      "required": true,
      "days": 20,
      "when": "Notice of completion may shorten timing"
    },
    "lien_filing": {
      "required": true,
      "days": 90
    }
  }
}
```

--------------------------------

### API Authentication Header

Source: https://liendeadline.com/api

Include your API key in the request header as a Bearer token for authentication. This is a standard practice for securing API access.

```http
Authorization: Bearer YOUR_API_KEY
```

--------------------------------

### Common API Request Headers

Source: https://liendeadline.com/api

These headers are commonly used in API requests for specifying content type, acceptable response formats, and ensuring idempotency.

```http
Content-Type: application/json
```

```http
Accept: application/json
```

```http
Idempotency-Key (optional)
```
Tokens:
Raw