Extract data from mechanics liens
A mechanics lien is a claim a contractor, subcontractor, or supplier records against a property when it has not been paid for work or materials that went into improving it. The lien attaches to the real estate itself, which is what gives an unpaid tradesperson a strong hand: the owner usually cannot sell or refinance cleanly until the claim is released. It is the counterpart of a lien waiver, the document a payee signs to give up that claim once paid. General contractors, title companies, and construction lenders all track liens because an unreleased one clouds title.
Cornerstone Framing LLC recorded a lien on 2026-06-12 in Denver County, Colorado, against Highland Development Partners for unpaid framing work on the Larkspur Terrace Phase 2 project at 88 Larkspur Avenue. The claim totals 148,500 USD: a work_items table of labor totaling 88,500 USD and a materials_supplied table of lumber and fasteners totaling 60,000 USD. Of that, 40,000 USD has been paid, leaving a balance due of 108,500 USD, which reconciles to the total less the payment. The general contractor is Meridian Builders Inc., a notice of non-payment was served on 2026-04-30, and the claim is made under the Colorado mechanics lien statute (C.R.S. 38-22).
Talonic reads the lien and returns the lienor, the property owner, the property description, the total claimed, the amount paid, and the balance due as fields, with the work items, the materials supplied, and the payment history as tables. The balance due is checked against the total less payments, so a filing that claims 148,500 USD and 40,000 USD paid but states a balance other than 108,500 USD is flagged. It captures the claim as recorded and makes no judgment about whether the lien is valid, perfected, or enforceable; those are questions for counsel and the recording jurisdiction.
What gets extracted from mechanics liens
How extraction works for mechanics liens
Mechanics liens are recorded on jurisdiction-specific forms and vary by state, so the lienor, the claimed amount, and the property description sit in different places from one county to the next. Talonic classifies the filing and aligns it to the lien schema in the Field Registry, so lienor.name, property_owner.name, total_amount, amount_paid, and balance_due each resolve to a field, while the work_items and payment_history tables load per row with amounts typed as numbers in USD. The 2026-06-12 filing date and the 2026-04-30 notice date parse to ISO 8601, and the lien_type and payment_status enums are preserved. Every value carries a confidence score and a source-region pointer under DIN SPEC 91491, so a title officer can verify the 108,500 USD balance against the recorded claim. Talonic reports the lien as filed and makes no validity or perfection judgment.
Sample extraction
A recorded mechanics lien for unpaid framing work
{
"document_number": "MLN-2026-0612-DEN",
"document_date": "2026-06-12",
"lienor.name": "Cornerstone Framing LLC",
"lienor.address": "410 Wynkoop St, Denver, CO 80202",
"property_owner.name": "Highland Development Partners",
"property_owner.address": "1900 16th St, Denver, CO 80202",
"property.description": "Multifamily residential development known as Larkspur Terrace Phase 2, 88 Larkspur Avenue, Denver, CO",
"property.legal_description": "Lot 4, Block 7, Larkspur Subdivision Filing No. 2, City and County of Denver",
"general_contractor.name": "Meridian Builders Inc.",
"work_description": "Rough and finish carpentry framing for buildings C and D",
"total_amount": 148500,
"currency": "USD",
"amount_paid": 40000,
"balance_due": 108500,
"payment_status": "partially_paid",
"lien_type": "mechanics_lien",
"jurisdiction": "Denver County, Colorado",
"notice_required_date": "2026-04-30",
"notice_of_non_payment": true,
"governing_law": "Colorado C.R.S. 38-22",
"project_name": "Larkspur Terrace Phase 2",
"filing_office_county": "Denver",
"work_items": [
{
"item_id": "WI-1",
"item_description": "Framing labor, building C",
"work_date": "2026-03-15",
"quantity": 620,
"unit_rate": 75,
"item_amount": 46500
},
{
"item_id": "WI-2",
"item_description": "Framing labor, building D",
"work_date": "2026-04-02",
"quantity": 560,
"unit_rate": 75,
"item_amount": 42000
}
],
"materials_supplied": [
{
"material_id": "M-1",
"material_description": "Dimensional lumber",
"supplier": "Front Range Lumber",
"supply_date": "2026-03-10",
"quantity": 1,
"unit_price": 44000,
"material_amount": 44000
},
{
"material_id": "M-2",
"material_description": "Fasteners and hardware",
"supplier": "Front Range Lumber",
"supply_date": "2026-03-10",
"quantity": 1,
"unit_price": 16000,
"material_amount": 16000
}
],
"payment_history": [
{
"payment_id": "P-1",
"payment_date": "2026-05-01",
"payment_amount": 40000,
"payment_method": "ACH",
"check_number": null,
"reference_number": "INV-2211",
"balance_after_payment": 108500
}
]
}Frequently asked
Is a lien the same as a lien waiver?
No, they are opposites. A lien is the claim that encumbers the property for unpaid work. A lien waiver is the release a payee signs to give up that claim once paid. Talonic reads the lien filing here and keeps its claimed amount and balance as fields.
Does it reconcile the balance due?
Yes. total_amount less amount_paid is checked against balance_due, so a claim of 148,500 USD with 40,000 USD paid must show a 108,500 USD balance, and a mismatch is flagged on ingest.
Does it read the work items and materials?
Yes. The work_items and materials_supplied tables return per row, and their amounts foot to the total: 88,500 USD of labor plus 60,000 USD of materials makes the 148,500 USD claim.
Does Talonic decide whether the lien is valid?
No. It extracts the claim as recorded, including the jurisdiction and the notice dates. Whether the lien was perfected or is enforceable is a determination for counsel and the recording office.
What fields are extracted from mechanics liens?
Talonic returns mechanics liens as schema-validated, typed fields. Common fields include Filing Number, Lienor, Property Owner, General Contractor, and more, each normalized (dates to ISO 8601, amounts as numbers) and mapped to a stable key so the output shape stays the same across layouts.
How accurate is extraction from mechanics liens, and how is confidence reported?
Every extracted cell carries a confidence score from 0.0 to 1.0 and a provenance pointer back to the source page and region, so low-confidence values can be reviewed against the original before the data is trusted downstream. There is no single accuracy number: confidence is reported per field so you can gate on it.
Can I use mechanics liens extraction in production?
Yes. The same engine behind this guide is available as a production REST API and Node SDK with sync, async, and streaming modes, schema versioning, signed webhooks, and EU-resident processing. Start free with an API key, then scale on usage-based pricing.
What does it cost to extract data from mechanics liens?
There is a free tier for prototyping and agent evaluation with no credit card. Paid usage is credit-based at 1,000 credits per euro: page ingestion is 100 credits per page and registry-resolved queries are free. See talonic.com/pricing for current rates.
Ready to extract from your own mechanics liens?
- GDPR
- HIPAA
- ISO 27001 / 42001 aligned
- DIN SPEC 91491 co-author
- EU-resident infrastructure
Author note
Reviewed by Talonic engineering, construction schema review · last reviewed 2026-07-08
- Source: Talonic Lien schema (seeded)