curl --request POST \
--url https://api.baselayer.com/lien_searches/adhoc \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "John Doe",
"search_states": [
"NY",
"CA"
]
}
'import requests
url = "https://api.baselayer.com/lien_searches/adhoc"
payload = {
"name": "John Doe",
"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({name: 'John Doe', search_states: ['NY', 'CA']})
};
fetch('https://api.baselayer.com/lien_searches/adhoc', 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/adhoc",
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([
'name' => 'John Doe',
'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/adhoc"
payload := strings.NewReader("{\n \"name\": \"John Doe\",\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/adhoc")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"John Doe\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches/adhoc")
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 \"name\": \"John Doe\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"searched_states": [
"FL",
"CA"
],
"error": "TimeoutError: The Liens Search could not be completed."
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Start Liens Adhoc Search
Start an ad-hoc liens search using a name and explicit search states.
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.
curl --request POST \
--url https://api.baselayer.com/lien_searches/adhoc \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "John Doe",
"search_states": [
"NY",
"CA"
]
}
'import requests
url = "https://api.baselayer.com/lien_searches/adhoc"
payload = {
"name": "John Doe",
"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({name: 'John Doe', search_states: ['NY', 'CA']})
};
fetch('https://api.baselayer.com/lien_searches/adhoc', 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/adhoc",
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([
'name' => 'John Doe',
'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/adhoc"
payload := strings.NewReader("{\n \"name\": \"John Doe\",\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/adhoc")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"John Doe\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.baselayer.com/lien_searches/adhoc")
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 \"name\": \"John Doe\",\n \"search_states\": [\n \"NY\",\n \"CA\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"searched_states": [
"FL",
"CA"
],
"error": "TimeoutError: The Liens Search could not be completed."
}{
"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.
"respond-async"
Body
Start a liens search by name and target states (no business or person record).
The name to search liens for.
1 - 256The states to search for liens in.
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 an adhoc 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.
The name used for the ad-hoc liens search.
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"
Indicates the list of states specified in the liens search request.
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"]
Any errors that occurred during the liens search request.
"TimeoutError: The Liens Search could not be completed."