curl --request PATCH \
--url https://api.baselayer.com/lien_submissions/{filing_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"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"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"principal_indebted_amount": 123,
"documentary_tax_stamp_required": true,
"assigned_business_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
}
}
'import requests
url = "https://api.baselayer.com/lien_submissions/{filing_id}"
payload = {
"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"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"principal_indebted_amount": 123,
"documentary_tax_stamp_required": True,
"assigned_business_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
},
real_estate_description: '<string>'
},
miscellaneous_info: '<string>',
jurisdiction_county: '<string>',
debtors: [
{
capacity: 'ESTATE',
city: 'Springfield',
mailing_address: '123 Main St',
organization_name: 'Acme Inc',
organization_type: 'COOPERATIVE',
postal_code: '62701',
state: 'IL',
type: 'ORGANIZATION'
}
],
secured_parties: [
{
city: 'Springfield',
mailing_address: '123 Main St',
organization_name: 'Acme Inc',
organization_type: 'COOPERATIVE',
postal_code: '62701',
state: 'IL',
type: 'ORGANIZATION'
}
],
collateral_statements: {
text: 'Commercial real estate located at 123 Business Blvd, Tech City, TX',
type: 'TEXT'
},
principal_indebted_amount: 123,
documentary_tax_stamp_required: true,
assigned_business_debtor: {
type: 'ORGANIZATION',
mailing_address: '123 Main St',
city: 'Springfield',
state: 'AL',
postal_code: '62701',
organization_name: 'Acme Inc',
capacity: 'NONE_OF_THE_ABOVE'
},
assigned_debtor: {
type: 'ORGANIZATION',
mailing_address: '123 Main St',
city: 'Springfield',
state: 'AL',
postal_code: '62701',
organization_name: 'Acme Inc',
capacity: 'NONE_OF_THE_ABOVE'
}
})
};
fetch('https://api.baselayer.com/lien_submissions/{filing_id}', 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/{filing_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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'
],
'real_estate_description' => '<string>'
],
'miscellaneous_info' => '<string>',
'jurisdiction_county' => '<string>',
'debtors' => [
[
'capacity' => 'ESTATE',
'city' => 'Springfield',
'mailing_address' => '123 Main St',
'organization_name' => 'Acme Inc',
'organization_type' => 'COOPERATIVE',
'postal_code' => '62701',
'state' => 'IL',
'type' => 'ORGANIZATION'
]
],
'secured_parties' => [
[
'city' => 'Springfield',
'mailing_address' => '123 Main St',
'organization_name' => 'Acme Inc',
'organization_type' => 'COOPERATIVE',
'postal_code' => '62701',
'state' => 'IL',
'type' => 'ORGANIZATION'
]
],
'collateral_statements' => [
'text' => 'Commercial real estate located at 123 Business Blvd, Tech City, TX',
'type' => 'TEXT'
],
'principal_indebted_amount' => 123,
'documentary_tax_stamp_required' => true,
'assigned_business_debtor' => [
'type' => 'ORGANIZATION',
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'AL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'capacity' => 'NONE_OF_THE_ABOVE'
],
'assigned_debtor' => [
'type' => 'ORGANIZATION',
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'AL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'capacity' => 'NONE_OF_THE_ABOVE'
]
]),
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/{filing_id}"
payload := strings.NewReader("{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.baselayer.com/lien_submissions/{filing_id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/{filing_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\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": "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": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Patch Existing Lien Filing Submission
Patches an existing lien filing submission with new information provided by the user. This endpoint allows for the modification of lien filing submissions that are in a draft state.
This route manages both UCC-1 and UCC-3 lien filing types. For specific
details on the request models for each type, please refer to the
LienFilingSubmissionUpdateUCC1Request and LienFilingSubmissionUpdateUCC3Request
schemas.
Users can update debtor and secured party information, as well as add or remove attachments related to the lien filing, depending on the filing type.
Party lists replace the corresponding role atomically. An empty list explicitly clears that role. Draft parties are stored exactly as entered, including incomplete rows; completeness is enforced when the filing is submitted.
Preserve each party’s id when echoing a GET response. A party
without an id creates a new entry; it does not replace a party
protected by a Filed assignment, whose historical link is retained.
It is important to note that only lien filings in a draft state can be updated. Attempting to update a lien filing that has already been submitted will result in an error.
The updated information will be validated according to the lien filing requirements before being saved. If the validation fails, the update will not be processed, and an error message will be returned.
Successful updates will return the updated lien filing submission details.
curl --request PATCH \
--url https://api.baselayer.com/lien_submissions/{filing_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"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"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"principal_indebted_amount": 123,
"documentary_tax_stamp_required": true,
"assigned_business_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
}
}
'import requests
url = "https://api.baselayer.com/lien_submissions/{filing_id}"
payload = {
"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"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"secured_parties": [
{
"city": "Springfield",
"mailing_address": "123 Main St",
"organization_name": "Acme Inc",
"organization_type": "COOPERATIVE",
"postal_code": "62701",
"state": "IL",
"type": "ORGANIZATION"
}
],
"collateral_statements": {
"text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
"type": "TEXT"
},
"principal_indebted_amount": 123,
"documentary_tax_stamp_required": True,
"assigned_business_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
},
"assigned_debtor": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"capacity": "NONE_OF_THE_ABOVE"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
},
real_estate_description: '<string>'
},
miscellaneous_info: '<string>',
jurisdiction_county: '<string>',
debtors: [
{
capacity: 'ESTATE',
city: 'Springfield',
mailing_address: '123 Main St',
organization_name: 'Acme Inc',
organization_type: 'COOPERATIVE',
postal_code: '62701',
state: 'IL',
type: 'ORGANIZATION'
}
],
secured_parties: [
{
city: 'Springfield',
mailing_address: '123 Main St',
organization_name: 'Acme Inc',
organization_type: 'COOPERATIVE',
postal_code: '62701',
state: 'IL',
type: 'ORGANIZATION'
}
],
collateral_statements: {
text: 'Commercial real estate located at 123 Business Blvd, Tech City, TX',
type: 'TEXT'
},
principal_indebted_amount: 123,
documentary_tax_stamp_required: true,
assigned_business_debtor: {
type: 'ORGANIZATION',
mailing_address: '123 Main St',
city: 'Springfield',
state: 'AL',
postal_code: '62701',
organization_name: 'Acme Inc',
capacity: 'NONE_OF_THE_ABOVE'
},
assigned_debtor: {
type: 'ORGANIZATION',
mailing_address: '123 Main St',
city: 'Springfield',
state: 'AL',
postal_code: '62701',
organization_name: 'Acme Inc',
capacity: 'NONE_OF_THE_ABOVE'
}
})
};
fetch('https://api.baselayer.com/lien_submissions/{filing_id}', 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/{filing_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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'
],
'real_estate_description' => '<string>'
],
'miscellaneous_info' => '<string>',
'jurisdiction_county' => '<string>',
'debtors' => [
[
'capacity' => 'ESTATE',
'city' => 'Springfield',
'mailing_address' => '123 Main St',
'organization_name' => 'Acme Inc',
'organization_type' => 'COOPERATIVE',
'postal_code' => '62701',
'state' => 'IL',
'type' => 'ORGANIZATION'
]
],
'secured_parties' => [
[
'city' => 'Springfield',
'mailing_address' => '123 Main St',
'organization_name' => 'Acme Inc',
'organization_type' => 'COOPERATIVE',
'postal_code' => '62701',
'state' => 'IL',
'type' => 'ORGANIZATION'
]
],
'collateral_statements' => [
'text' => 'Commercial real estate located at 123 Business Blvd, Tech City, TX',
'type' => 'TEXT'
],
'principal_indebted_amount' => 123,
'documentary_tax_stamp_required' => true,
'assigned_business_debtor' => [
'type' => 'ORGANIZATION',
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'AL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'capacity' => 'NONE_OF_THE_ABOVE'
],
'assigned_debtor' => [
'type' => 'ORGANIZATION',
'mailing_address' => '123 Main St',
'city' => 'Springfield',
'state' => 'AL',
'postal_code' => '62701',
'organization_name' => 'Acme Inc',
'capacity' => 'NONE_OF_THE_ABOVE'
]
]),
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/{filing_id}"
payload := strings.NewReader("{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.baselayer.com/lien_submissions/{filing_id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/{filing_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filing_type\": \"UCC1\",\n \"reference_data\": \"Filing for a 1967 Ford Mustang\",\n \"submission_filing_name\": \"My Lien Filing\",\n \"search_to_reflect\": true,\n \"email_contact\": \"<string>\",\n \"real_estate_info\": {\n \"type\": \"FILE_IN_REAL_ESTATE_RECORDS\",\n \"covers_timber\": true,\n \"covers_as_extracted_collateral\": true,\n \"filed_as_fixture\": true,\n \"real_estate_record_owner\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\"\n },\n \"real_estate_description\": \"<string>\"\n },\n \"miscellaneous_info\": \"<string>\",\n \"jurisdiction_county\": \"<string>\",\n \"debtors\": [\n {\n \"capacity\": \"ESTATE\",\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"secured_parties\": [\n {\n \"city\": \"Springfield\",\n \"mailing_address\": \"123 Main St\",\n \"organization_name\": \"Acme Inc\",\n \"organization_type\": \"COOPERATIVE\",\n \"postal_code\": \"62701\",\n \"state\": \"IL\",\n \"type\": \"ORGANIZATION\"\n }\n ],\n \"collateral_statements\": {\n \"text\": \"Commercial real estate located at 123 Business Blvd, Tech City, TX\",\n \"type\": \"TEXT\"\n },\n \"principal_indebted_amount\": 123,\n \"documentary_tax_stamp_required\": true,\n \"assigned_business_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\n },\n \"assigned_debtor\": {\n \"type\": \"ORGANIZATION\",\n \"mailing_address\": \"123 Main St\",\n \"city\": \"Springfield\",\n \"state\": \"AL\",\n \"postal_code\": \"62701\",\n \"organization_name\": \"Acme Inc\",\n \"capacity\": \"NONE_OF_THE_ABOVE\"\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": "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": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
The unique identifier of the lien filing submission to update.
Body
- LienFilingSubmissionUpdateUCC1Request (v1)
- LienFilingSubmissionUpdateUCC3Request (v1)
The LienFilingSubmissionUpdateRequest object is designed for updating
an existing lien filing submission.
It enables modifications to specific fields such as the collateral description, secured parties, and the submission filing name.
This functionality is essential for incorporating new or altered information after the initial creation of a lien filing submission, ensuring that updates remain aligned with the original submission's requirements while providing the necessary flexibility for changes.
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
{
"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 updated the lien filing submission record.
- LienFilingSubmissionUCC1Response (v1)
- LienFilingSubmissionUCC3Response (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": "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"
}
]
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": "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"
}
]
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": "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"
}
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. After a Filed continuation against this filing, this is the renewed date.
"2024-04-20"
Whether a PDF copy of the latest successful submission is available. This is separate from the official filed document.
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 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 the standing is derived from the filing's own row, which is kept current from that filing's Filed UCC-3 amendments: a Filed termination pins Terminated, and a Filed continuation renews the lapse date. Terminated is final; otherwise a lapse date that has passed reads Lapsed, and anything else reads Active.
Active, Inactive, Lapsed, Released, Satisfied, Expired, Pending, Contested, Disputed, Perfected, Unperfected, Void, Invalid, Enforcement, Foreclosure, Subordinated, Avoided, Terminated, Draft, InPreperation, Unknown "Active"