curl --request POST \
--url https://api.baselayer.com/people/{person_id}/lien_submissions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"search_to_reflect": true,
"filing_type": "UCC1",
"state": "AL",
"debtors": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "TRUST",
"suffix": "Sr.",
"last_name": "Doe",
"first_name": "John",
"type": "INDIVIDUAL"
}
],
"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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.",
"type": "TEXT"
}
}
'import requests
url = "https://api.baselayer.com/people/{person_id}/lien_submissions"
payload = {
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"search_to_reflect": True,
"filing_type": "UCC1",
"state": "AL",
"debtors": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "TRUST",
"suffix": "Sr.",
"last_name": "Doe",
"first_name": "John",
"type": "INDIVIDUAL"
}
],
"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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.",
"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',
search_to_reflect: true,
filing_type: 'UCC1',
state: 'AL',
debtors: [
{
mailing_address: '123 Main St',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
capacity: 'TRUST',
suffix: 'Sr.',
last_name: 'Doe',
first_name: 'John',
type: 'INDIVIDUAL'
}
],
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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.',
type: 'TEXT'
}
})
};
fetch('https://api.baselayer.com/people/{person_id}/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/people/{person_id}/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',
'search_to_reflect' => true,
'filing_type' => 'UCC1',
'state' => 'AL',
'debtors' => [
[
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'capacity' => 'TRUST',
'suffix' => 'Sr.',
'last_name' => 'Doe',
'first_name' => 'John',
'type' => 'INDIVIDUAL'
]
],
'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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.',
'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/people/{person_id}/lien_submissions"
payload := strings.NewReader("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\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/people/{person_id}/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 \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\n \"type\": \"TEXT\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/people/{person_id}/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 \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\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 Ucc1 Lien Filing Submission For Person
Creates a new lien filing submission against a specified person in a draft state. This endpoint enables clients to submit all necessary information required for a lien filing, including the type of filing, relevant parties (secured parties and debtors), and a comprehensive description of the collateral.
curl --request POST \
--url https://api.baselayer.com/people/{person_id}/lien_submissions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"search_to_reflect": true,
"filing_type": "UCC1",
"state": "AL",
"debtors": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "TRUST",
"suffix": "Sr.",
"last_name": "Doe",
"first_name": "John",
"type": "INDIVIDUAL"
}
],
"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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.",
"type": "TEXT"
}
}
'import requests
url = "https://api.baselayer.com/people/{person_id}/lien_submissions"
payload = {
"reference_data": "123456",
"submission_filing_name": "My new lien filing",
"search_to_reflect": True,
"filing_type": "UCC1",
"state": "AL",
"debtors": [
{
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"capacity": "TRUST",
"suffix": "Sr.",
"last_name": "Doe",
"first_name": "John",
"type": "INDIVIDUAL"
}
],
"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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.",
"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',
search_to_reflect: true,
filing_type: 'UCC1',
state: 'AL',
debtors: [
{
mailing_address: '123 Main St',
city: 'Springfield',
state: 'IL',
postal_code: '62701',
capacity: 'TRUST',
suffix: 'Sr.',
last_name: 'Doe',
first_name: 'John',
type: 'INDIVIDUAL'
}
],
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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.',
type: 'TEXT'
}
})
};
fetch('https://api.baselayer.com/people/{person_id}/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/people/{person_id}/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',
'search_to_reflect' => true,
'filing_type' => 'UCC1',
'state' => 'AL',
'debtors' => [
[
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'IL',
'postal_code' => '62701',
'capacity' => 'TRUST',
'suffix' => 'Sr.',
'last_name' => 'Doe',
'first_name' => 'John',
'type' => 'INDIVIDUAL'
]
],
'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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.',
'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/people/{person_id}/lien_submissions"
payload := strings.NewReader("{\n \"reference_data\": \"123456\",\n \"submission_filing_name\": \"My new lien filing\",\n \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\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/people/{person_id}/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 \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\n \"type\": \"TEXT\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/people/{person_id}/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 \"search_to_reflect\": true,\n \"filing_type\": \"UCC1\",\n \"state\": \"AL\",\n \"debtors\": [\n {\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"IL\",\n \"postal_code\": \"62701\",\n \"capacity\": \"TRUST\",\n \"suffix\": \"Sr.\",\n \"last_name\": \"Doe\",\n \"first_name\": \"John\",\n \"type\": \"INDIVIDUAL\"\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, including but not limited to the property located at 123 Main Street, Anytown, CA 90210.\",\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
Path Parameters
The unique identifier of the person to file a lien against.
"f5c20033-77c9-4622-a8ea-99bd58317f6f"
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 Optional field to update the mailing address for the business debtor associated with this lien filing. Use this to specify a new address if different from the one on record.
Show child attributes
Show child attributes
This request model is specifically utilized for updating the mailing address information of a designated debtor party. It facilitates the modification of address details to ensure accurate and current records.
- LienFilingAssignedBusinessDebtorPartyRequest (v1)
- LienFilingAssignedPersonDebtorPartyRequest (v1)
Show child attributes
Show child attributes
Response
Successfully created a draft 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"