curl --request POST \
--url https://api.baselayer.com/lien_submissions/initial_filing_lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"state": "IL",
"filing_number": "P98172",
"filing_date": "2023-01-15",
"allow_unverified": false
}
'import requests
url = "https://api.baselayer.com/lien_submissions/initial_filing_lookup"
payload = {
"state": "IL",
"filing_number": "P98172",
"filing_date": "2023-01-15",
"allow_unverified": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
state: 'IL',
filing_number: 'P98172',
filing_date: '2023-01-15',
allow_unverified: false
})
};
fetch('https://api.baselayer.com/lien_submissions/initial_filing_lookup', 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/initial_filing_lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'state' => 'IL',
'filing_number' => 'P98172',
'filing_date' => '2023-01-15',
'allow_unverified' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_submissions/initial_filing_lookup"
payload := strings.NewReader("{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/lien_submissions/initial_filing_lookup")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/initial_filing_lookup")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}"
response = http.request(request)
puts response.read_body{
"outcome": "imported",
"created": true,
"warnings": [
"filing_date_mismatch"
],
"filing": {
"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": "c0315e18-d05e-4f8d-9b48-5e4816d93d93",
"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": "5e964550-843b-45de-a8c2-9d048d5bd9a3",
"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": "191aa2c2-5908-462a-9f06-7bd84dc87c1a",
"capacity": "ESTATE",
"city": "Springfield",
"id": "8545693b-a50f-4865-9687-1a8d37e5d07c",
"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_submission_document": false,
"has_downloadable_document": false,
"origin": "filed_via_baselayer",
"status": "Active"
}
}{
"code": 500,
"message": "Payment Required. Sandbox applications do not support this request.",
"metadata": {}
}{
"code": 489,
"message": "This lien filing is already held by the organization as a Baselayer filing.",
"metadata": {}
}{
"code": 490,
"message": "Only consensual lien filings can be imported. Statutory, judicial and tax liens are imposed on a debtor rather than granted by one, so they are not tracked as UCC financing statements.",
"metadata": {}
}Lookup Initial Filing For Amendment
Resolve the initial financing statement a UCC-3 will amend, from
the state and file number the filer copies off the UCC-1.
File date is optional for lookup and required when
allow_unverified is true.
The search a filer must run before creating a UCC-3. Resolution is
three-way: a UCC-1 the organization filed through Baselayer resolves
to that submission; a filing known from the public record is claimed
as an imported filing (creating the record if this is the first
claim, exactly as POST /lien_submissions/import would); and a
filing Baselayer cannot verify at all is reported as not_found —
unless allow_unverified is set, in which case it is held as an
unverified imported filing built from the details supplied here.
Keep allow_unverified off until the filer has seen the not_found
answer and confirmed they want to proceed anyway.
The resolved filing is what POST /lien_submissions/{filing_id}/amend
then targets. warnings flags a file date that disagrees with the
matched filing, a date past its lapse date, or a filing that is no
longer Active — none of them block the lookup.
The file number is validated against the state’s format where the format is known (length and character checks otherwise), and the supplied file date must not be in the future nor predate the revised UCC Article 9 effective date (2001-07-01).
Not available to sandbox applications: the lookup reads the real public record and can claim a filing off it, so there is nothing to simulate.
curl --request POST \
--url https://api.baselayer.com/lien_submissions/initial_filing_lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"state": "IL",
"filing_number": "P98172",
"filing_date": "2023-01-15",
"allow_unverified": false
}
'import requests
url = "https://api.baselayer.com/lien_submissions/initial_filing_lookup"
payload = {
"state": "IL",
"filing_number": "P98172",
"filing_date": "2023-01-15",
"allow_unverified": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
state: 'IL',
filing_number: 'P98172',
filing_date: '2023-01-15',
allow_unverified: false
})
};
fetch('https://api.baselayer.com/lien_submissions/initial_filing_lookup', 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/initial_filing_lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'state' => 'IL',
'filing_number' => 'P98172',
'filing_date' => '2023-01-15',
'allow_unverified' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_submissions/initial_filing_lookup"
payload := strings.NewReader("{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/lien_submissions/initial_filing_lookup")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/initial_filing_lookup")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"state\": \"IL\",\n \"filing_number\": \"P98172\",\n \"filing_date\": \"2023-01-15\",\n \"allow_unverified\": false\n}"
response = http.request(request)
puts response.read_body{
"outcome": "imported",
"created": true,
"warnings": [
"filing_date_mismatch"
],
"filing": {
"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": "c0315e18-d05e-4f8d-9b48-5e4816d93d93",
"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": "5e964550-843b-45de-a8c2-9d048d5bd9a3",
"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": "191aa2c2-5908-462a-9f06-7bd84dc87c1a",
"capacity": "ESTATE",
"city": "Springfield",
"id": "8545693b-a50f-4865-9687-1a8d37e5d07c",
"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_submission_document": false,
"has_downloadable_document": false,
"origin": "filed_via_baselayer",
"status": "Active"
}
}{
"code": 500,
"message": "Payment Required. Sandbox applications do not support this request.",
"metadata": {}
}{
"code": 489,
"message": "This lien filing is already held by the organization as a Baselayer filing.",
"metadata": {}
}{
"code": 490,
"message": "Only consensual lien filings can be imported. Statutory, judicial and tax liens are imposed on a debtor rather than granted by one, so they are not tracked as UCC financing statements.",
"metadata": {}
}Authorizations
Body
The initial financing statement details to resolve, as they appear on the UCC-1.
The state abbreviation of the jurisdiction the initial financing statement is filed in.
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 "IL"
The filing number the filing office assigned the initial financing statement (UCC-1) being amended.
1 - 64"P98172"
The date the initial financing statement was filed. Optional for lookup; required when allow_unverified is true. Cannot be in the future and cannot predate the revised UCC Article 9 effective date (2001-07-01).
"2023-04-20"
A custom name for the filing record this lookup creates, when it creates one (only filer's reference).
128"Acme Inc — 2023 equipment lien"
When the filing cannot be found in Baselayer or the public record, whether to hold it anyway as an unverified imported filing built from the details supplied here. Off by default so an exploratory search creates nothing; set it only after the filer confirms the initial filing could not be verified.
Response
The lookup resolved (or reported not_found) without creating a record.
How the initial-filing lookup resolved, and the record a UCC-3 can now
be created against via POST /lien_submissions/{filing_id}/amend.
Which kind of record the lookup resolved the initial financing statement to, or not_found when nothing matched and no unverified filing was requested.
filed_via_baselayer, imported, imported_unverified, not_found "imported"
Whether this lookup created the returned filing record, as opposed to resolving one the organization already held.
Non-blocking flags about the match: a file date that disagrees with the matched filing (filing_date_mismatch), a file date past the filing's lapse date (filing_date_after_lapse_date), a filing that no longer stands (filing_not_active), or an unverified import whose filing has since appeared in the public record (public_record_available).
Non-blocking flags an initial-filing lookup raises about its match.
filing_date_mismatch, filing_date_after_lapse_date, filing_not_active, public_record_available, secured_party_preferences_missing 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.
- LienFilingSubmissionUCC1Response (v1)
- LienFilingSubmissionImportedResponse (v1)
Show child attributes
Show child attributes