curl --request GET \
--url https://api.baselayer.com/lien_searches/{liens_search_request_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/lien_searches/{liens_search_request_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/lien_searches/{liens_search_request_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_searches/{liens_search_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_searches/{liens_search_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/lien_searches/{liens_search_request_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches/{liens_search_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"search_entities": [
{
"name": "<string>",
"type": "Business",
"search_states": [
"AL"
],
"normalized_name": "<string>"
}
],
"state": "PENDING",
"filings": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "CA",
"filing_number": "P98172",
"filing_type": "Lien for Loan Default",
"filing_date": "2023-09-18",
"lapse_date": "2023-04-15",
"status": "Under Appeal",
"number_of_pages": 14,
"last_updated_at": "2023-12-25",
"document_filename": "docket_47182.pdf",
"parties": [],
"amendments": [],
"collateral_type": "blanket",
"collateral_statements": [],
"lien_amount": 15432.5,
"match_level": "NO_MATCH",
"search_entity_name": "<string>",
"search_entity_type": "Business"
}
],
"last_updated_at": "2024-06-01",
"error": "TimeoutError: The Liens Search could not be completed.",
"searched_states": [
"FL",
"CA"
],
"business_id": "bc145d0c-aea1-4572-844a-2d11ca1f85c0",
"person_id": "9cb64976-4cc4-4f52-8171-ce8744d52333",
"business_search_id": "0b8d7416-e62c-420e-a593-7c86f26b1590"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Get Liens
This endpoint retrieves a specific lien search request by its unique identifier. It returns a LiensSearchRequest object that includes the state of the request and a list of lien filings associated with the request.
The lien filings provide detailed information about each lien, including the filing number, type, date, status, and associated business and search request. The model also links to any amendments and the involved parties.
curl --request GET \
--url https://api.baselayer.com/lien_searches/{liens_search_request_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.baselayer.com/lien_searches/{liens_search_request_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.baselayer.com/lien_searches/{liens_search_request_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_searches/{liens_search_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.baselayer.com/lien_searches/{liens_search_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.baselayer.com/lien_searches/{liens_search_request_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches/{liens_search_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"search_entities": [
{
"name": "<string>",
"type": "Business",
"search_states": [
"AL"
],
"normalized_name": "<string>"
}
],
"state": "PENDING",
"filings": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "CA",
"filing_number": "P98172",
"filing_type": "Lien for Loan Default",
"filing_date": "2023-09-18",
"lapse_date": "2023-04-15",
"status": "Under Appeal",
"number_of_pages": 14,
"last_updated_at": "2023-12-25",
"document_filename": "docket_47182.pdf",
"parties": [],
"amendments": [],
"collateral_type": "blanket",
"collateral_statements": [],
"lien_amount": 15432.5,
"match_level": "NO_MATCH",
"search_entity_name": "<string>",
"search_entity_type": "Business"
}
],
"last_updated_at": "2024-06-01",
"error": "TimeoutError: The Liens Search could not be completed.",
"searched_states": [
"FL",
"CA"
],
"business_id": "bc145d0c-aea1-4572-844a-2d11ca1f85c0",
"person_id": "9cb64976-4cc4-4f52-8171-ce8744d52333",
"business_search_id": "0b8d7416-e62c-420e-a593-7c86f26b1590"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
The unique identifier of the liens search request.
"49bba8a2-458b-4ea8-afd6-10ee452083bc"
Response
Response
Represents the response from a liens search request. This includes the unique identifier of the request, the current state of the request, and a list of lien filings associated with the request.
The identifier of this liens search response.
A list of entities searched in the liens search.
Show child attributes
Show child attributes
The current state of the liens search request.
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED A list of lien filings associated with the search request.
Show child attributes
Show child attributes
The date the lien search result was last updated.
"2024-06-01"
Any errors that occurred during the liens search request.
"TimeoutError: The Liens Search could not be completed."
Indicates the list of states specified in the liens search request. When states are provided, the search was limited to liens within these specified states, regardless of the business's registered states.
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 ["FL", "CA"]
The identifier of the business associated with these lien filings.
"bc145d0c-aea1-4572-844a-2d11ca1f85c0"
The identifier of the person associated with these lien filings.
"9cb64976-4cc4-4f52-8171-ce8744d52333"
The identifier of the business search associated with these lien filings.
"0b8d7416-e62c-420e-a593-7c86f26b1590"