curl --request POST \
--url https://api.baselayer.com/lien_submissions/{filing_id}/amend \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456-100",
"submission_filing_name": "Filing for a 1967 Ford Mustang",
"filing_type": "UCC3"
}
'import requests
url = "https://api.baselayer.com/lien_submissions/{filing_id}/amend"
payload = {
"reference_data": "123456-100",
"submission_filing_name": "Filing for a 1967 Ford Mustang",
"filing_type": "UCC3"
}
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-100',
submission_filing_name: 'Filing for a 1967 Ford Mustang',
filing_type: 'UCC3'
})
};
fetch('https://api.baselayer.com/lien_submissions/{filing_id}/amend', 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}/amend",
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-100',
'submission_filing_name' => 'Filing for a 1967 Ford Mustang',
'filing_type' => 'UCC3'
]),
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}/amend"
payload := strings.NewReader("{\n \"reference_data\": \"123456-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\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/{filing_id}/amend")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference_data\": \"123456-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/{filing_id}/amend")
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-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\n}"
response = http.request(request)
puts response.read_body{
"filing_type": "UCC3",
"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>",
"amendment_action": {
"type": "TERMINATION"
},
"authorizing_party": {
"type": "ORGANIZATION",
"role": "Secured Party",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"masked": true,
"is_assignor": true,
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"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",
"state": "AL",
"amending_filing": {
"filing_type": "UCC1",
"reference_data": "Filing for a 1967 Ford Mustang",
"submission_filing_name": "My Lien Filing",
"search_to_reflect": true,
"email_contact": "<string>",
"real_estate_info": {
"type": "FILE_IN_REAL_ESTATE_RECORDS",
"covers_timber": true,
"covers_as_extracted_collateral": true,
"filed_as_fixture": true,
"real_estate_record_owner": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"state": "AL",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"id": "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"
}
}{
"code": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Create New Ucc3 Lien Filing Submission
Create a new UCC-3 lien filing submission to amend an existing UCC-1 filing.
This endpoint allows users to initiate an amendment process for an existing UCC-1 lien filing. It creates a new UCC-3 filing submission, which can be used to modify, continue, or terminate the original UCC-1 filing.
The filing_id in the URL represents the unique identifier of the original UCC-1 filing
that is being amended. The request body contains the necessary information to create
the new UCC-3 filing, including details such as the submission filing name and any
reference data.
Upon successful creation, a draft UCC-3 lien filing submission record is generated, allowing for further modifications before final submission.
curl --request POST \
--url https://api.baselayer.com/lien_submissions/{filing_id}/amend \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"reference_data": "123456-100",
"submission_filing_name": "Filing for a 1967 Ford Mustang",
"filing_type": "UCC3"
}
'import requests
url = "https://api.baselayer.com/lien_submissions/{filing_id}/amend"
payload = {
"reference_data": "123456-100",
"submission_filing_name": "Filing for a 1967 Ford Mustang",
"filing_type": "UCC3"
}
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-100',
submission_filing_name: 'Filing for a 1967 Ford Mustang',
filing_type: 'UCC3'
})
};
fetch('https://api.baselayer.com/lien_submissions/{filing_id}/amend', 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}/amend",
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-100',
'submission_filing_name' => 'Filing for a 1967 Ford Mustang',
'filing_type' => 'UCC3'
]),
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}/amend"
payload := strings.NewReader("{\n \"reference_data\": \"123456-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\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/{filing_id}/amend")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference_data\": \"123456-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_submissions/{filing_id}/amend")
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-100\",\n \"submission_filing_name\": \"Filing for a 1967 Ford Mustang\",\n \"filing_type\": \"UCC3\"\n}"
response = http.request(request)
puts response.read_body{
"filing_type": "UCC3",
"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>",
"amendment_action": {
"type": "TERMINATION"
},
"authorizing_party": {
"type": "ORGANIZATION",
"role": "Secured Party",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"masked": true,
"is_assignor": true,
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"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",
"state": "AL",
"amending_filing": {
"filing_type": "UCC1",
"reference_data": "Filing for a 1967 Ford Mustang",
"submission_filing_name": "My Lien Filing",
"search_to_reflect": true,
"email_contact": "<string>",
"real_estate_info": {
"type": "FILE_IN_REAL_ESTATE_RECORDS",
"covers_timber": true,
"covers_as_extracted_collateral": true,
"filed_as_fixture": true,
"real_estate_record_owner": {
"type": "ORGANIZATION",
"mailing_address": "123 Main St",
"city": "Springfield",
"state": "AL",
"postal_code": "62701",
"organization_name": "Acme Inc",
"organization_type": "SOLE_PROPRIETORSHIP"
},
"real_estate_description": "<string>"
},
"miscellaneous_info": "<string>",
"state": "AL",
"jurisdiction_county": "<string>",
"debtors": [
{
"capacity": "ESTATE",
"city": "Springfield",
"id": "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"
}
}{
"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 amend.
"27bf2b9b-e4ee-4d1d-b5be-f1681d9f84e5"
Body
The request object containing all the Lien Filing Submission details, specifically for UCC-3 filings.
Amendment or continuation of a previously filed financing statement.
"UCC3"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.
256Represents a UCC-3 termination filing.
This model defines the structure for a termination action in a UCC-3 filing. It is used to indicate the termination of a previously filed UCC-1 financing statement, signifying that the secured party no longer claims a security interest under that statement.
- LienFilingUCC3TerminationAction (v1)
- LienFilingUCC3ContinuationAction (v1)
- LienFilingUCC3AssignmentAction (v1)
- LienFilingUCC3DebtorAmendmentAction (v1)
- LienFilingUCC3SecuredPartyAmendmentAction (v1)
- LienFilingUCC3CollateralAmendmentAction (v1)
Show child attributes
Show child attributes
Represents an authorizing debtor in a UCC-3 filing which may also be an assignor, if the amendment action is an assignment.
- LienFilingUCC3AuthorizingPartyDebtor (v1)
- LienFilingUCC3AuthorizingPartySecuredParty (v1)
Show child attributes
Show child attributes
Response
Successfully created a draft UCC-3 lien filing submission record.
Amendment or continuation of a previously filed financing statement.
"UCC3"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.
256Represents a UCC-3 termination filing.
This model defines the structure for a termination action in a UCC-3 filing. It is used to indicate the termination of a previously filed UCC-1 financing statement, signifying that the secured party no longer claims a security interest under that statement.
- LienFilingUCC3TerminationAction (v1)
- LienFilingUCC3ContinuationAction (v1)
- LienFilingUCC3AssignmentActionResponse (v1)
- LienFilingUCC3DebtorAmendmentActionResponse (v1)
- LienFilingUCC3SecuredPartyAmendmentActionResponse (v1)
- LienFilingUCC3CollateralAmendmentActionResponse (v1)
Show child attributes
Show child attributes
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)
- LienFilingOrganizationDebtorPartyResponse (v1)
- LienFilingIndividualDebtorPartyResponse (v1)
- 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 state abbreviation for the jurisdiction where the amendment is to be filed. It is the jurisdiction of the filing being amended, copied when the amendment is created through POST /lien_submissions/{filing_id}/amend, and is not recomputed afterwards.
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 filing that is being amended.
Show child attributes
Show child attributes