curl --request POST \
--url https://api.baselayer.com/lien_submissions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"filing_type": "UCC1",
"state": "IL",
"debtors": [
{
"mailing_address": "456 Debtor Ave",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "NONE_OF_THE_ABOVE",
"organization_name": "Debtor Industries LLC",
"organization_type": "LLC",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "B_CORPORATION",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.",
"type": "TEXT"
}
}
'import requests
url = "https://api.baselayer.com/lien_submissions"
payload = {
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"filing_type": "UCC1",
"state": "IL",
"debtors": [
{
"mailing_address": "456 Debtor Ave",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "NONE_OF_THE_ABOVE",
"organization_name": "Debtor Industries LLC",
"organization_type": "LLC",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "B_CORPORATION",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.",
"type": "TEXT"
}
}
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({
reference_data: '123456',
submission_filing_name: 'My new lien filing',
filing_type: 'UCC1',
state: 'IL',
debtors: [
{
mailing_address: '456 Debtor Ave',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
capacity: 'NONE_OF_THE_ABOVE',
organization_name: 'Debtor Industries LLC',
organization_type: 'LLC',
type: 'ORGANIZATION'
}
],
secured_parties: [
{
mailing_address: '123 Main St',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
organization_name: 'Acme Inc',
organization_type: 'B_CORPORATION',
type: 'ORGANIZATION'
}
],
collateral_statements: {
text: 'All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.',
type: 'TEXT'
}
})
};
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 => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference_data' => '123456',
'submission_filing_name' => 'My new lien filing',
'filing_type' => 'UCC1',
'state' => 'IL',
'debtors' => [
[
'mailing_address' => '456 Debtor Ave',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'capacity' => 'NONE_OF_THE_ABOVE',
'organization_name' => 'Debtor Industries LLC',
'organization_type' => 'LLC',
'type' => 'ORGANIZATION'
]
],
'secured_parties' => [
[
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'organization_type' => 'B_CORPORATION',
'type' => 'ORGANIZATION'
]
],
'collateral_statements' => [
'text' => 'All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.',
'type' => 'TEXT'
]
]),
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"
payload := strings.NewReader("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\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")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\n}")
.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::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\n}"
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": {}
}
]
}Create New Standalone Ucc1 Lien Filing Submission
Creates a new standalone lien filing submission in a draft
state, without anchoring it to a business or person known to the
platform. Use this when the debtor has not gone through a KYB
search — all debtors are supplied manually through the debtors
list and remain fully editable while the submission is a draft.
Unlike the business- and person-anchored variants, the response
carries no assigned_debtor; every debtor lives in debtors.
Parties may be supplied incomplete while drafting. Draft values are persisted as entered, and submit-time validation reports anything still missing.
If the request body does not include secured parties, the system will attempt to generate the first secured party using the organization’s lien filing preferences, if they are present in the organization’s profile.
The actual filing with the appropriate jurisdiction does not
occur at this stage; submit the draft through the
POST /lien_submissions/{filing_id}/submit endpoint.
curl --request POST \
--url https://api.baselayer.com/lien_submissions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"filing_type": "UCC1",
"state": "IL",
"debtors": [
{
"mailing_address": "456 Debtor Ave",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "NONE_OF_THE_ABOVE",
"organization_name": "Debtor Industries LLC",
"organization_type": "LLC",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "B_CORPORATION",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.",
"type": "TEXT"
}
}
'import requests
url = "https://api.baselayer.com/lien_submissions"
payload = {
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"filing_type": "UCC1",
"state": "IL",
"debtors": [
{
"mailing_address": "456 Debtor Ave",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "NONE_OF_THE_ABOVE",
"organization_name": "Debtor Industries LLC",
"organization_type": "LLC",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "B_CORPORATION",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.",
"type": "TEXT"
}
}
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({
reference_data: '123456',
submission_filing_name: 'My new lien filing',
filing_type: 'UCC1',
state: 'IL',
debtors: [
{
mailing_address: '456 Debtor Ave',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
capacity: 'NONE_OF_THE_ABOVE',
organization_name: 'Debtor Industries LLC',
organization_type: 'LLC',
type: 'ORGANIZATION'
}
],
secured_parties: [
{
mailing_address: '123 Main St',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
organization_name: 'Acme Inc',
organization_type: 'B_CORPORATION',
type: 'ORGANIZATION'
}
],
collateral_statements: {
text: 'All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.',
type: 'TEXT'
}
})
};
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 => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference_data' => '123456',
'submission_filing_name' => 'My new lien filing',
'filing_type' => 'UCC1',
'state' => 'IL',
'debtors' => [
[
'mailing_address' => '456 Debtor Ave',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'capacity' => 'NONE_OF_THE_ABOVE',
'organization_name' => 'Debtor Industries LLC',
'organization_type' => 'LLC',
'type' => 'ORGANIZATION'
]
],
'secured_parties' => [
[
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'organization_type' => 'B_CORPORATION',
'type' => 'ORGANIZATION'
]
],
'collateral_statements' => [
'text' => 'All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.',
'type' => 'TEXT'
]
]),
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"
payload := strings.NewReader("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\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")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\n}")
.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::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"filing_type\": \"UCC1\",\n \"state\": \"IL\",\n \"debtors\": [\n {\n \"mailing_address\": \"456 Debtor Ave\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"NONE_OF_THE_ABOVE\",\n \"organization_name\": \"Debtor Industries LLC\",\n \"organization_type\": \"LLC\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"B_CORPORATION\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"All inventory, equipment, accounts, and proceeds now owned or hereafter acquired by the debtor.\",\n \"type\": \"TEXT\"\n }\n}"
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
Body
The request object containing all the Lien Filing Submission details, specifically for UCC-1 filings.
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. For an anchored filing, omit the debtor associated with the business or person in the URL because it is supplied as the assigned debtor. For a standalone filing, include every debtor in this list.
Describes an organization that is a debtor in a lien filing. This model is tailored for organizations acting as debtors in lien contexts, including specific details relevant to their debtor status.
- LienFilingOrganizationDebtorParty (v1)
- LienFilingIndividualDebtorParty (v1)
Show child attributes
Show child attributes
[ { "capacity": "ESTATE", "city": "Springfield", "mailing_address": "123 Main St", "organization_name": "Acme Inc", "organization_type": "COOPERATIVE", "postal_code": "62701", "state": "IL", "type": "ORGANIZATION" } ]
A list of secured parties involved in the lien filing.
Describes an organization acting as a secured party in a lien filing. This model is tailored to encapsulate organizations with a secured interest in the context of a lien, detailing aspects relevant to their secured party status.
- LienFilingOrganizationSecuredParty (v1)
- LienFilingIndividualSecuredParty (v1)
Show child attributes
Show child attributes
[ { "city": "Springfield", "mailing_address": "123 Main St", "organization_name": "Acme Inc", "organization_type": "COOPERATIVE", "postal_code": "62701", "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)
- LienFilingCollateralStatementAttachmentsRequest (v1)
Show child attributes
Show child attributes
{ "collateral_statement_designation": "NONE", "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.
x <= 10000000000Whether 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 Response
Successfully created a draft standalone lien filing submission record.
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"