Start Liens Search
curl --request POST \
--url https://api.baselayer.com/lien_searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "Business",
"business_id": "832d7b08-001b-45cd-aa65-627bbf2bc2c0",
"search_states": [
"NY",
"CA"
]
}
'import requests
url = "https://api.baselayer.com/lien_searches"
payload = {
"type": "Business",
"business_id": "832d7b08-001b-45cd-aa65-627bbf2bc2c0",
"search_states": ["NY", "CA"]
}
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({
type: 'Business',
business_id: '832d7b08-001b-45cd-aa65-627bbf2bc2c0',
search_states: ['NY', 'CA']
})
};
fetch('https://api.baselayer.com/lien_searches', 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",
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([
'type' => 'Business',
'business_id' => '832d7b08-001b-45cd-aa65-627bbf2bc2c0',
'search_states' => [
'NY',
'CA'
]
]),
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_searches"
payload := strings.NewReader("{\n \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/lien_searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches")
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 \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}"
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": {}
}
]
}Business Lien Search
Start Liens Search
This endpoint starts a liens search for a given person or business.
Exactly one of business_id or person_id must be provided. If person_id
is provided, search_states must be provided.
By default, this endpoint executes synchronously and returns the completed
result. Send Prefer: respond-async to opt into asynchronous execution,
which returns 202 Accepted immediately and delivers results via
webhooks or polling.
POST
/
lien_searches
Start Liens Search
curl --request POST \
--url https://api.baselayer.com/lien_searches \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "Business",
"business_id": "832d7b08-001b-45cd-aa65-627bbf2bc2c0",
"search_states": [
"NY",
"CA"
]
}
'import requests
url = "https://api.baselayer.com/lien_searches"
payload = {
"type": "Business",
"business_id": "832d7b08-001b-45cd-aa65-627bbf2bc2c0",
"search_states": ["NY", "CA"]
}
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({
type: 'Business',
business_id: '832d7b08-001b-45cd-aa65-627bbf2bc2c0',
search_states: ['NY', 'CA']
})
};
fetch('https://api.baselayer.com/lien_searches', 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",
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([
'type' => 'Business',
'business_id' => '832d7b08-001b-45cd-aa65-627bbf2bc2c0',
'search_states' => [
'NY',
'CA'
]
]),
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_searches"
payload := strings.NewReader("{\n \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.baselayer.com/lien_searches")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches")
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 \"type\": \"Business\",\n \"business_id\": \"832d7b08-001b-45cd-aa65-627bbf2bc2c0\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}"
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
Headers
Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.
Example:
"respond-async"
Body
application/json
- BusinessLiensSearchRequest (v1)
- PersonLiensSearchRequest (v1)
- BusinessSearchLiensSearchRequest (v1)
Represents a request to initiate a liens search for a business.
The ID of the business the liens search task should be run against. Mutually exclusive with person_id.
Allowed value:
"Business"This is required for individual searches. For business searches, specifies an override list of states for the liens search. If provided, the search will exclusively target liens within these states, irrespective of the business's registered states.
Available options:
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 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.
Available options:
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.
Example:
"2024-06-01"
Any errors that occurred during the liens search request.
Example:
"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.
Available options:
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 Example:
["FL", "CA"]
The identifier of the business associated with these lien filings.
Example:
"bc145d0c-aea1-4572-844a-2d11ca1f85c0"
The identifier of the person associated with these lien filings.
Example:
"9cb64976-4cc4-4f52-8171-ce8744d52333"
The identifier of the business search associated with these lien filings.
Example:
"0b8d7416-e62c-420e-a593-7c86f26b1590"