curl --request GET \
--url https://api.baselayer.com/lien_submissions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/lien_submissions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/lien_submissions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.baselayer.com/lien_submissions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_submissions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/lien_submissions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"filing_type": "UCC1",
"reference_data": "Filing for a 1967 Ford Mustang",
"submission_filing_name": "My Lien Filing",
"search_to_reflect": true,
"email_contact": "<string>",
"real_estate_info": {
"type": "FILE_IN_REAL_ESTATE_RECORDS",
"covers_timber": true,
"covers_as_extracted_collateral": true,
"filed_as_fixture": true,
"real_estate_record_owner": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"state": "AL",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"id": "6622b049-a93c-4748-8057-b5824fc52d0e",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
"is_assignor": null,
"mailing_address": "123 Main St",
"masked": null,
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Secured Party",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"collateral_statement_designation": null,
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"alternative_name_designation": "AGLIEN",
"alternative_filing_type": "TRANSMITTING_UTILITY",
"principal_indebted_amount": "<string>",
"documentary_tax_stamp_required": true,
"tax_exempt_reason": "DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION",
"assigned_business_debtor": {
"business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
"capacity": "ESTATE",
"city": "Springfield",
"id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "LLC",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"role": "Debtor",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP",
"capacity": "NONE_OF_THE_ABOVE",
"business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"filing_status": "Draft",
"filing_number": "UCC1-1234567890",
"filing_date": "2023-01-01",
"lapse_date": "2024-04-20",
"has_downloadable_document": false,
"origin": "filed_via_baselayer",
"status": "Active"
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Get Lien Filing Submissions
This endpoint retrieves a list of lien filing submissions made by the authenticated organization. Each submission includes summary information such as filing type, date, number, and parties involved.
curl --request GET \
--url https://api.baselayer.com/lien_submissions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/lien_submissions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/lien_submissions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.baselayer.com/lien_submissions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_submissions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/lien_submissions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"filing_type": "UCC1",
"reference_data": "Filing for a 1967 Ford Mustang",
"submission_filing_name": "My Lien Filing",
"search_to_reflect": true,
"email_contact": "<string>",
"real_estate_info": {
"type": "FILE_IN_REAL_ESTATE_RECORDS",
"covers_timber": true,
"covers_as_extracted_collateral": true,
"filed_as_fixture": true,
"real_estate_record_owner": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"state": "AL",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"id": "6622b049-a93c-4748-8057-b5824fc52d0e",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
"is_assignor": null,
"mailing_address": "123 Main St",
"masked": null,
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Secured Party",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"collateral_statement_designation": null,
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"alternative_name_designation": "AGLIEN",
"alternative_filing_type": "TRANSMITTING_UTILITY",
"principal_indebted_amount": "<string>",
"documentary_tax_stamp_required": true,
"tax_exempt_reason": "DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION",
"assigned_business_debtor": {
"business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
"capacity": "ESTATE",
"city": "Springfield",
"id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "LLC",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"role": "Debtor",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP",
"capacity": "NONE_OF_THE_ABOVE",
"business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"filing_status": "Draft",
"filing_number": "UCC1-1234567890",
"filing_date": "2023-01-01",
"lapse_date": "2024-04-20",
"has_downloadable_document": false,
"origin": "filed_via_baselayer",
"status": "Active"
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Query Parameters
The maximum number of lien filing submissions to return.
x >= 1The number of lien filing submissions to skip before starting to return the submissions.
x >= 0The query parameter will be used to search by filename in lien submissions. If it is not provided, it will be ignored.
"Cook County Lien"
Filter lien filing submissions by their status. Multiple statuses can be provided (comma separated).
Enum class delineating the various stages of a lien filing submission's lifecycle.
Draft, Requested, InReview, NeedsAttention, Submitted, Filed, Cancelled Filter lien filing submissions by their origin — how the organization came to hold the filing: filed_via_baselayer (submitted through Baselayer) or imported (claimed from the public record). This is the filing's own provenance, NOT the channel the request arrived on.
filed_via_baselayer, imported Filter to the filings a single bulk import batch created.
Response
Successful Response
- LienFilingSubmissionUCC1Response (v1)
- LienFilingSubmissionUCC3Response (v1)
- LienFilingSubmissionImportedResponse (v1)
Represents the response structure for a lien filing submission. This model includes all the details provided during the creation of a lien filing submission along with additional system-generated information such as the unique identifier, the current status of the submission, and the filing number if the lien has been recorded.
Initial financing statement, which is the first filing of a lien.
"UCC1"Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).
128"Filing for a 1967 Ford Mustang"
A custom name for the filing (only filer's reference).
128"My Lien Filing"
When set to true, a search will be conducted on the debtor post-filing to verify that the filing has been properly registered by the filing office.
This email will receive all correspondence concerning this lien filing.
256This model represents the real estate record in a lien filing submission.
- LienFilingRealEstateInfo (v1)
- LienFilingNoRealEstateInfo (v1)
Show child attributes
Show child attributes
Miscellaneous information associated with the lien filing submission.
256The state abbreviation for the jurisdiction where the lien is to be filed.
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, PR, VI, AE, AA, AP, GU, AS The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.
128An enumeration of debtors implicated in the lien filing process, excluding the assigned debtor on anchored filings. Standalone filings return every debtor in this list.
Represents the response structure for an organization acting as a debtor in a lien filing.
This model encapsulates detailed information about an organizational debtor, including its identification, contact details, and specific attributes relevant to its role in the lien. It is designed to provide a comprehensive view of the debtor's information as returned by the API in response to lien-related queries or operations.
- LienFilingOrganizationDebtorPartyResponse (v1)
- LienFilingIndividualDebtorPartyResponse (v1)
Show child attributes
Show child attributes
[
{
"capacity": "ESTATE",
"city": "Springfield",
"id": "6622b049-a93c-4748-8057-b5824fc52d0e",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
}
]
A list of secured parties involved in the lien filing.
Represents the response structure for an organization acting as a secured party in a lien filing.
This model encapsulates detailed information about an organizational secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the secured party's information as returned by the API in response to lien-related queries or operations.
- LienFilingOrganizationSecuredPartyResponse (v1)
- LienFilingIndividualSecuredPartyResponse (v1)
Show child attributes
Show child attributes
[
{
"city": "Springfield",
"id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
"is_assignor": null,
"mailing_address": "123 Main St",
"masked": null,
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"role": "Secured Party",
"state": "IL",
"type": "ORGANIZATION"
}
]
This structure represents the schema for a collateral statement in the form of text provided for a lien filing submission.
- LienFilingCollateralStatementText (v1)
- LienFilingCollateralStatementAttachmentsResponse (v1)
Show child attributes
Show child attributes
{
"collateral_statement_designation": null,
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
}
Designation for the lien filing that specifies an alternativename under which the lien might be filed or recognized. This can includedesignations like agricultural liens, bailee/bailor relationships,or other specific types that affect how the lien is treated or categorized legally.
AGLIEN, BAILEE_BAILOR, CONSIGNEE_CONSIGNOR, LESSEE_LESSOR, NON_UCC_FILING, SELLER_BUYER, LICENSEE, DEBTOR_SECURED_PARTY Field that specifies the type of lien filing in alternativecontexts. This can include types like transmitting utility, manufactured home, public finance, or not applicable.
TRANSMITTING_UTILITY, MANUFACTURED_HOME, PUBLIC_FINANCE, NOT_APPLICABLE The principal indebted amount in the lien filing submission.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Whether a documentary tax stamp is required for the lien filing submission. When set to true all Documentary Stamps due and payable or to become due and payable pursuant, have been paid. If set to false, the lien filing submission will not require a documentary tax stamp.
The tax exempt reason for the lien filing submission.
DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION, DEBTOR_CREDIT_UNION, DEBTOR_TELEPHONE_COOPERATIVE, GOVERNMENT_AGENCY, JUDGEMENT_LIEN, MUNICIPALITY, REORGANIZATION, SECURITIES, STATE_AGENCY, NOT_EXEMPT Represents the response structure for an assigned business debtor party in a lien filing.
This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
Show child attributes
Show child attributes
{
"business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
"capacity": "ESTATE",
"city": "Springfield",
"id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "LLC",
"postal_code": "62701",
"role": "Debtor",
"state": "IL",
"type": "ORGANIZATION"
}
Represents the response structure for an assigned business debtor party in a lien filing.
This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.
- LienFilingAssignedBusinessDebtorPartyResponse (v1)
- LienFilingAssignedPersonDebtorPartyResponse (v1)
Show child attributes
Show child attributes
The unique identifier for the lien filing submission.
The current state of the lien filing submission.
Draft, Requested, InReview, NeedsAttention, Submitted, Filed, Cancelled The filing number assigned to the lien, when the lien filing has been recorded by the jurisdiction. This is a unique identifier for the lien, and is used to reference the lien in subsequent transactions.
128"UCC1-1234567890"
The date when the lien filing was submitted to the jurisdiction.
"2023-01-01"
The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.
"2024-04-20"
Indicates whether a downloadable document (e.g., the filed lien in PDF format) is available for this lien filing submission. This is typically true when the lien filing has been officially recorded by the jurisdiction.
How the organization came to own this lien filing: it was filed through Baselayer, or imported by the organization from a filing that already exists in the public record.
filed_via_baselayer, imported The lien's standing once it has been filed, derived from its lapse date under UCC §9-515 rather than read off a stored column — a filed lien whose lapse date has passed reports Lapsed here without anything having had to age it. Reads the same way as an imported filing's status. For a filing made THROUGH Baselayer both §9-515 clauses live in the filing's own UCC-3 amendments, so the field is populated only where those have been read: the initial-filing lookup (POST /lien_submissions/initial_filing_lookup). It is omitted elsewhere rather than answered from unread evidence.
Active, Inactive, Lapsed, Released, Satisfied, Expired, Pending, Contested, Disputed, Perfected, Unperfected, Void, Invalid, Enforcement, Foreclosure, Subordinated, Avoided, Terminated, Draft, InPreperation, Unknown "Active"