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.
An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked Idempotent-Replayed: true, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.
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.
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.
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.
The identifier of the business search associated with these lien filings.
Example:
"13bffc01-7eba-40b7-960e-32132fd3ea15"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Baselayer","colors":{"primary":"#384ce3","light":"#c6dbf6","dark":"#2232b5"},"logo":{"light":"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a","dark":"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a","href":"https://www.baselayer.com"},"favicon":"https://mintcdn.com/baselayer-81245324/y8jjNyo-CIhfj2Df/favicon.ico?fit=max\u0026auto=format\u0026n=y8jjNyo-CIhfj2Df\u0026q=85\u0026s=5f1029f95d2abd5d4ffd1699330f82ff","navbar":{"links":[{"href":"https://console.baselayer.com","label":"Console"}]},"fonts":{"heading":{"family":"Season Mix","source":"fonts/SeasonMix-Variable.woff2","format":"woff2"},"body":{"family":"Uncut Sans","source":"fonts/UncutSans-Variable.woff2","format":"woff2"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"baselayer-81245324","hasAudioNarration":false,"actualSubdomain":"baselayer-81245324","customDomains":["docs.baselayer.com"],"gitSource":{"type":"github","owner":"osiris-ratings","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"c01b8a96-72e8-47f2-acae-28665212b8cb","liveDeploymentHistoryId":"6ae2cd9ed5f357b7dcda2db3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2cd9ed5f357b7dcda2db3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b13c39bc6f1b8c505ffe","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":270},{"language":"default","tag":"Changelog","count":162},{"language":"default","tag":"Businesses","count":133},{"language":"default","tag":"Webhooks","count":81},{"language":"default","tag":"Webhook Events","count":68},{"language":"default","tag":"PRODUCT GUIDES","count":61},{"language":"default","tag":"Verify Businesses \u0026 People","count":60},{"language":"default","tag":"Know Your Agent","count":54},{"language":"default","tag":"Business Verification","count":49},{"language":"default","tag":"Portfolio Monitoring","count":48}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #navbar{background:#384ce3!important}html:not(.dark) #navbar div,html:not(.dark) #navbar nav{background-color:transparent!important;backdrop-filter:none!important}html:not(.dark) #navbar *{border-color:rgba(255,255,255,.18)!important}html:not(.dark) #navbar a,html:not(.dark) #navbar button,html:not(.dark) #navbar div,html:not(.dark) #navbar p,html:not(.dark) #navbar span,html:not(.dark) #navbar svg{color:#fff!important}html:not(.dark) #navbar button{background:rgba(255,255,255,.12)!important;border-color:rgba(255,255,255,.25)!important}"}],"page":{"pagePath":"api-reference/lien-search/start-liens-search","slug":"/api-reference/lien-search/start-liens-search","pageMetadata":{"title":"Start Liens Search","description":"This endpoint starts a liens search for a given person or business.\nExactly one of `business_id` or `person_id` must be provided. If `person_id`\nis provided, `search_states` must be provided.\n\nBy default, this endpoint executes synchronously and returns the completed\nresult. Send ``Prefer: respond-async`` to opt into asynchronous execution,\nwhich returns ``202 Accepted`` immediately and delivers results via\nwebhooks or polling.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_searches","href":"/api-reference/lien-search/start-liens-search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"This endpoint starts a liens search for a given person or business.\\nExactly one of \", _jsx(_components.code, {\n children: \"business_id\"\n }), \" or \", _jsx(_components.code, {\n children: \"person_id\"\n }), \" must be provided. If \", _jsx(_components.code, {\n children: \"person_id\"\n }), \"\\nis provided, \", _jsx(_components.code, {\n children: \"search_states\"\n }), \" must be provided.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"By default, this endpoint executes synchronously and returns the completed\\nresult. Send \", _jsx(_components.code, {\n children: \"Prefer: respond-async\"\n }), \" to opt into asynchronous execution,\\nwhich returns \", _jsx(_components.code, {\n children: \"202 Accepted\"\n }), \" immediately and delivers results via\\nwebhooks or polling.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start Liens Search","description":"This endpoint starts a liens search for a given person or business.\nExactly one of `business_id` or `person_id` must be provided. If `person_id`\nis provided, `search_states` must be provided.\n\nBy default, this endpoint executes synchronously and returns the completed\nresult. Send ``Prefer: respond-async`` to opt into asynchronous execution,\nwhich returns ``202 Accepted`` immediately and delivers results via\nwebhooks or polling.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_searches","href":"/api-reference/lien-search/start-liens-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/baselayer-81245324/8f3f8776472b6600/kya-nudge.js"],"openApiReferenceData":{"operation":{"tags":["Lien Search"],"summary":"Start Liens Search","description":"This endpoint starts a liens search for a given person or business.\nExactly one of `business_id` or `person_id` must be provided. If `person_id`\nis provided, `search_states` must be provided.\n\nBy default, this endpoint executes synchronously and returns the completed\nresult. Send ``Prefer: respond-async`` to opt into asynchronous execution,\nwhich returns ``202 Accepted`` immediately and delivers results via\nwebhooks or polling.","operationId":"start_liens_search_lien_searches_post","security":["b89deea2-fc16-4f08-aea1-545bdf74d5bd"],"parameters":["c4850776-670e-48dc-9c15-81fc4b5cb60c","c3532877-d96c-4acc-8dfa-94ef850e0b4c"],"requestBody":"4bf6b092-f827-44ad-bc4d-565a7f016ea3","responses":{"201":"de2846ea-09db-49bb-85d1-4a1ba61cfe6f","422":"08567a30-1e03-4f4f-9b2c-b02698ba1bad"},"method":"post","type":"path","servers":["788562d2-18e0-4de1-8ca6-c9b3fd720b2d"],"path":"/lien_searches","baseUrlOptions":["https://api.baselayer.com/"],"title":"Start Liens Search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c4850776-670e-48dc-9c15-81fc4b5cb60c":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","description":"An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked `Idempotent-Replayed: true`, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","description":"An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked `Idempotent-Replayed: true`, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked `Idempotent-Replayed: true`, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource."},"c3532877-d96c-4acc-8dfa-94ef850e0b4c":{"name":"Prefer","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Prefer","description":"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","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Prefer","description":"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","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"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."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"BusinessLiensSearchRequest (v1)","description":"Represents a request to initiate a liens search for a business.","required":["business_id"],"example":{"type":"Business","business_id":"1991a845-6721-48c9-8463-92b2b4e09e64","search_states":["CA","NY"]},"properties":{"business_id":{"type":"string","format":"uuid","title":"Business Id","description":"The ID of the business the liens search task should be run against. Mutually exclusive with person_id.","isRequired":true,"uniqueKey":"oneOf.0.business_id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","const":"Business","title":"Type","default":"Business","uniqueKey":"oneOf.0.type","typeLabel":"string"},"search_states":{"oneOf":[{"type":"array","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"oneOf.0.search_states.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Override States for Liens Search","description":"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.","uniqueKey":"oneOf.0.search_states.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Search for liens only in domestic state","description":"When set to `null`, the liens search will exclusively target the domestic state of the business for business searches. This is not supported for individual searches. A domestic state refers to the state within which the business has filed its articles of incorporation, and is recognized as its home state for legal and tax purposes. This is in contrast to any other states where the business might operate but is considered a foreign entity. \n\n\nThe search, therefore, focuses on liens within this domestic jurisdiction, aligning with the legal recognition and operational base of the business.","uniqueKey":"oneOf.0.search_states.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.search_states","typeLabel":"enum\u003cstring>[] | null"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"BusinessLiensSearchRequest (v1) · object"},{"type":"object","title":"PersonLiensSearchRequest (v1)","description":"Represents a request to initiate a liens search for a person.","required":["person_id","search_states"],"example":{"type":"Business","search_states":["CA","NY"]},"properties":{"person_id":{"type":"string","format":"uuid","title":"Person Id","description":"The ID of the person the liens search task should be run against.","isRequired":true,"uniqueKey":"oneOf.1.person_id","typeLabel":"string\u003cuuid>"},"search_states":{"items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"oneOf.1.search_states.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Search States","description":"The states to search for liens in.","isRequired":true,"uniqueKey":"oneOf.1.search_states","typeLabel":"enum\u003cstring>[]"},"type":{"type":"string","const":"Person","title":"Type","default":"Person","uniqueKey":"oneOf.1.type","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"PersonLiensSearchRequest (v1) · object"},{"type":"object","title":"BusinessSearchLiensSearchRequest (v1)","description":"Represents a request to initiate a liens search for a business search.","required":["business_search_id"],"example":{"type":"Business","search_states":["CA","NY"]},"properties":{"business_search_id":{"type":"string","format":"uuid","title":"Business Search Id","description":"The ID of the business search the liens search task should be run against.","isRequired":true,"uniqueKey":"oneOf.2.business_search_id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","const":"BusinessSearch","title":"Type","default":"BusinessSearch","uniqueKey":"oneOf.2.type","typeLabel":"string"},"search_states":{"oneOf":[{"type":"array","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"oneOf.2.search_states.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Override States for Liens Search","description":"If provided, the search will exclusively target liens within these states, irrespective of the resolved business's registered states.","uniqueKey":"oneOf.2.search_states.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Search for liens only in domestic state","description":"When set to `null`, the liens search will exclusively target the domestic state of the resolved business for business searches. ","uniqueKey":"oneOf.2.search_states.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.search_states","typeLabel":"enum\u003cstring>[] | null"},"additional_search_entities":{"oneOf":[{"type":"array","items":{"properties":{"name":{"description":"The name of the entity to search for.","maxLength":256,"minLength":1,"title":"Name","type":"string","isRequired":true,"uniqueKey":"oneOf.2.additional_search_entities.oneOf.0.items.[INDEX].name","typeLabel":"string"},"type":{"enum":["Business","Person"],"title":"BusinessOrPersonType","type":"string","description":"The type of the entity to search for.","isRequired":true,"uniqueKey":"oneOf.2.additional_search_entities.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"search_states":{"items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"oneOf.2.additional_search_entities.oneOf.0.items.[INDEX].search_states.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","minItems":1,"title":"Search States","description":"The states to search for liens in.","isRequired":true,"uniqueKey":"oneOf.2.additional_search_entities.oneOf.0.items.[INDEX].search_states","typeLabel":"enum\u003cstring>[]"}},"additionalProperties":false,"type":"object","required":["name","type","search_states"],"title":"AdditionalLiensSearchEntityRequest (v1)","description":"Represents a request to add an entity to a liens search.","uniqueKey":"oneOf.2.additional_search_entities.oneOf.0.items.[INDEX]","typeLabel":"AdditionalLiensSearchEntityRequest (v1) · object"},"title":"Additional Search Entities","description":"A list of additional entities to be searched along with the business search in the liens search.","example":[{"name":"John Doe","search_states":["CA"],"type":"Person"}],"uniqueKey":"oneOf.2.additional_search_entities.oneOf.0","typeLabel":"AdditionalLiensSearchEntityRequest (v1) · object[]"},{"type":"null","title":"Additional Search Entities","description":"A list of additional entities to be searched along with the business search in the liens search.","example":[{"name":"John Doe","search_states":["CA"],"type":"Person"}],"uniqueKey":"oneOf.2.additional_search_entities.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.additional_search_entities","typeLabel":"AdditionalLiensSearchEntityRequest (v1) · object[] | null"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"BusinessSearchLiensSearchRequest (v1) · object"}],"uniqueKey":"","typeLabel":"BusinessLiensSearchRequest (v1) · object | PersonLiensSearchRequest (v1) · object | BusinessSearchLiensSearchRequest (v1) · object"},"examples":{"Example":{"title":"Example","value":{"type":"Business","business_id":"1991a845-6721-48c9-8463-92b2b4e09e64","search_states":["CA","NY"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"de2846ea-09db-49bb-85d1-4a1ba61cfe6f":{"description":"Response","content":{"application/json":{"schema":{"description":"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.","properties":{"id":{"description":"The identifier of this liens search response.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"search_entities":{"description":"A list of entities searched in the liens search.","items":{"properties":{"name":{"description":"The name of the entity to search for.","maxLength":256,"minLength":1,"title":"Name","type":"string","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].name","typeLabel":"string"},"type":{"enum":["Business","Person"],"title":"BusinessOrPersonType","type":"string","description":"The type of the entity to search for.","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"search_states":{"description":"The states to search for liens in.","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"search_entities.items.[INDEX].search_states.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"title":"Search States","type":"array","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].search_states","typeLabel":"enum\u003cstring>[]"},"normalized_name":{"readOnly":true,"title":"Normalized Name","type":"string","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].normalized_name","typeLabel":"string"}},"required":["name","type","search_states","normalized_name"],"title":"AdditionalLiensSearchEntityResponse (v1)","type":"object","uniqueKey":"search_entities.items.[INDEX]","typeLabel":"AdditionalLiensSearchEntityResponse (v1) · object"},"title":"Search Entities","type":"array","isRequired":true,"uniqueKey":"search_entities","typeLabel":"AdditionalLiensSearchEntityResponse (v1) · object[]"},"state":{"enum":["PENDING","EXECUTING","COMPLETED","FAILED","CANCELLED"],"title":"TaskState","type":"string","description":"The current state of the liens search request.","isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"filings":{"description":"A list of lien filings associated with the search request.","items":{"description":"Contains detailed information about a lien filing, including the filing\nnumber, type, date, status, and associated business and search request.\nThe model also links to any amendments and the involved parties.","properties":{"id":{"description":"The identifier of this lien filing record.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"state":{"enum":["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"],"title":"StateAbbreviation","type":"string","description":"State abbreviation code where the lien is filed.","examples":["CA"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"filing_number":{"description":"Sequential identifier assigned by the filing office.","examples":["P98172"],"title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_number","typeLabel":"string"},"filing_type":{"description":"Describes the nature of the filing.","examples":["Lien for Loan Default"],"title":"Filing Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_type","typeLabel":"string"},"filing_date":{"description":"Official date when the lien was recorded.","examples":["2023-09-18"],"format":"date","title":"Filing Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_date","typeLabel":"string\u003cdate>"},"lapse_date":{"description":"The expiry date for the lien's claim on collateral.","examples":["2023-04-15"],"format":"date","title":"Lapse Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].lapse_date","typeLabel":"string\u003cdate>"},"status":{"description":"Reflects the current legal status of the lien.","examples":["Under Appeal"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].status","typeLabel":"string"},"number_of_pages":{"description":"Reflects the volume of documentation for the lien filing.","examples":[14],"title":"Number Of Pages","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].number_of_pages","typeLabel":"integer"},"last_updated_at":{"description":"The date the lien filing record was last updated.","format":"date","title":"Last Updated At","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].last_updated_at","typeLabel":"string\u003cdate>"},"document_filename":{"oneOf":[{"type":"string","title":"The downloadable liens document filename.","description":"When present, it indicates that a document is available for download; Use get_lien_filing_documents or get_lien_filing_documents_for_business_id to download the documents.","example":"docket_47182.pdf","uniqueKey":"filings.items.[INDEX].document_filename.oneOf.0","typeLabel":"string"},{"type":"null","title":"The downloadable document is not available.","description":"No downloadable documents are available for this lien filing.","uniqueKey":"filings.items.[INDEX].document_filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].document_filename","typeLabel":"string | null"},"parties":{"default":[],"description":"A list of parties associated with this lien filing, encompassing both debtors and secured parties. This relationship is critical for identifying all entities with a vested interest in the lien's terms and outcome.","items":{"description":"Represents an entity involved in a lien as either a debtor or a secured party.\nThis model captures common attributes and relationships of these parties.","properties":{"id":{"description":"The identifier of this lien filing record.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"role":{"description":"Categorizes the party as either a debtor owing the debt or a secured party holding the collateral interest.","enum":["Debtor","Secured Party","Record Owner"],"title":"LienPartyRole","type":"string","examples":["Debtor"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"name":{"description":"Legal name of the party; crucial for due diligence and legal proceedings related to the lien.","examples":["Louis Schneider"],"title":"Name","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].name","typeLabel":"string"},"address":{"oneOf":[{"type":"object","title":"AddressSummaryResponse (v1)","description":"Address of the party; provides the physical location for legal notices or contact purposes.","required":["id","street","city","state","zip","latitude","longitude"],"properties":{"id":{"description":"Unique identifier for the address.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.id","typeLabel":"string\u003cuuid>"},"street":{"description":"Street name of the address.","examples":["913 Hendrix Gardens Suite 492"],"title":"Street","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.street","typeLabel":"string"},"city":{"description":"City name of the address.","examples":["Jasonfurt"],"title":"City","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.city","typeLabel":"string"},"state":{"enum":["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"],"title":"StateAbbreviation","type":"string","description":"State 2 letter abbreviation of the address.","examples":["VA"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.state","typeLabel":"enum\u003cstring>"},"zip":{"description":"Zip code of the address.","examples":["19773"],"title":"Zip","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.zip","typeLabel":"string"},"latitude":{"description":"Latitude of the address.","examples":[38.03012],"title":"Latitude","type":"number","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.latitude","typeLabel":"number"},"longitude":{"description":"Longitude of the address.","examples":[78.47665],"title":"Longitude","type":"number","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.longitude","typeLabel":"number"},"rdi":{"oneOf":[{"type":"string","title":"AddressRDI","description":"Residential Delivery Indicator of the address.","enum":["Residential","Commercial"],"example":"Commercial","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Residential Delivery Indicator of the address.","example":"Commercial","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi","typeLabel":"enum\u003cstring> | null"},"deliverable":{"oneOf":[{"type":"boolean","title":"Deliverable","description":"Indicates whether the address is deliverable.","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Deliverable","description":"Indicates whether the address is deliverable.","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable","typeLabel":"boolean | null"},"cmra":{"oneOf":[{"type":"boolean","title":"Cmra","description":"Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Cmra","description":"Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra","typeLabel":"boolean | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL to the address details.","format":"uri","maxLength":2083,"minLength":1,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","title":"Url","description":"The URL to the address details.","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url","typeLabel":"string\u003curi> | null"},"delivery_type":{"oneOf":[{"type":"string","title":"USPSDeliveryType","description":"The USPS delivery type.","enum":["FIRM","GENERAL_DELIVERY","HIGH_RISE","POST_OFFICE","RURAL_ROUTE","STREET"],"example":"STREET","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The USPS delivery type.","example":"STREET","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type","typeLabel":"enum\u003cstring> | null"}},"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0","typeLabel":"AddressSummaryResponse (v1) · object"},{"type":"null","description":"Address of the party; provides the physical location for legal notices or contact purposes.","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address","typeLabel":"AddressSummaryResponse (v1) · object | null"},"type":{"description":"The type of lien party, indicating whether the party is an individual or an organization.\nA computed property that returns the role of the lien party. \nNote: This `type` property is planned to be deprecated in favor of the `role` field in future versions.","examples":["individual","organization"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].type","typeLabel":"string"},"mailing_address":{"oneOf":[{"type":"string","title":"Mailing Address","description":"Street of the party's address as written on the filing itself, when known. It may accompany `address` rather than replace it: `address` is the verified address record behind the party when there is one, and these components are what the filing says — the only address a party with no verified record has.","example":"1 Market Street","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Mailing Address","description":"Street of the party's address as written on the filing itself, when known. It may accompany `address` rather than replace it: `address` is the verified address record behind the party when there is one, and these components are what the filing says — the only address a party with no verified record has.","example":"1 Market Street","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","description":"City of the party's address as recorded on the filing itself; see `mailing_address`.","example":"San Francisco","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","description":"City of the party's address as recorded on the filing itself; see `mailing_address`.","example":"San Francisco","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","title":"StateAbbreviation","description":"State of the party's address as recorded on the filing itself; see `mailing_address`.","enum":["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":"CA","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"State of the party's address as recorded on the filing itself; see `mailing_address`.","example":"CA","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state","typeLabel":"enum\u003cstring> | null"},"postal_code":{"oneOf":[{"type":"string","title":"Postal Code","description":"Postal code of the party's address as recorded on the filing itself; see `mailing_address`.","example":"94105","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Postal Code","description":"Postal code of the party's address as recorded on the filing itself; see `mailing_address`.","example":"94105","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code","typeLabel":"string | null"}},"required":["id","role","name","address","type"],"title":"LienPartyResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX]","typeLabel":"LienPartyResponse (v1) · object"},"title":"Parties","type":"array","uniqueKey":"filings.items.[INDEX].parties","typeLabel":"LienPartyResponse (v1) · object[]"},"amendments":{"default":[],"description":"A chronological list of amendments to this lien filing, detailing any continuations, terminations, or modifications. This historical record is fundamental for tracking the evolution and current standing of the lien.","items":{"description":"Represents a change or update to a lien filing, such as a continuation,\ntermination, or assignment that affects the lien's validity or terms.","properties":{"filing_number":{"description":"The document filing number.","examples":["H76162"],"title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_number","typeLabel":"string"},"filing_type":{"description":"The document filing type.","examples":["Notarized Letter"],"title":"Filing Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_type","typeLabel":"string"},"filing_date":{"description":"The date of the lien filing.","examples":["2023-11-27"],"format":"date","title":"Filing Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_date","typeLabel":"string\u003cdate>"},"number_of_pages":{"description":"Number of image pages in the library for this filing number.","examples":[4],"title":"Number Of Pages","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].number_of_pages","typeLabel":"integer"}},"required":["filing_number","filing_type","filing_date","number_of_pages"],"title":"LienAmendmentResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX]","typeLabel":"LienAmendmentResponse (v1) · object"},"title":"Amendments","type":"array","uniqueKey":"filings.items.[INDEX].amendments","typeLabel":"LienAmendmentResponse (v1) · object[]"},"collateral_type":{"oneOf":[{"type":"string","title":"CollateralType","description":"The classified type of collateral secured by this lien filing (e.g. blanket, all_receivables, real_property). Null when the collateral type has not been determined.","enum":["blanket","all_receivables","named_receivables","all_equipment","named_equipment","all_inventory","named_inventory","real_property","agricultural","other","not_applicable"],"uniqueKey":"filings.items.[INDEX].collateral_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The classified type of collateral secured by this lien filing (e.g. blanket, all_receivables, real_property). Null when the collateral type has not been determined.","uniqueKey":"filings.items.[INDEX].collateral_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].collateral_type","typeLabel":"enum\u003cstring> | null"},"collateral_statements":{"default":[],"description":"A sequence of collateral statements associated with this lien filing, enumerating the specific assets secured by the lien. The order of these statements can denote the priority of claims against the assets.","items":{"description":"Represents the text descriptions of collateral pledged against a lien as\nrecorded in a UCC filing. Each statement details the specific assets\nsecured by the lien and is sorted by a 'sort_order' to maintain\nthe intended sequence of claims.","properties":{"text":{"description":"A detailed description of the collateral that is subject to the lien.","examples":["2022 Blue Honda Civic"],"title":"Text","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX].text","typeLabel":"string"},"sort_order":{"description":"An integer representing the display or priority order of the collateral statements.","title":"Sort Order","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX].sort_order","typeLabel":"integer"}},"required":["text","sort_order"],"title":"LienCollateralStatementResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX]","typeLabel":"LienCollateralStatementResponse (v1) · object"},"title":"Collateral Statements","type":"array","uniqueKey":"filings.items.[INDEX].collateral_statements","typeLabel":"LienCollateralStatementResponse (v1) · object[]"},"lien_amount":{"oneOf":[{"type":"number","title":"Lien Amount","description":"The total monetary amount owed for a tax lien filing. Null for non-tax filings. Serialized as a JSON number.","example":15432.5,"uniqueKey":"filings.items.[INDEX].lien_amount.oneOf.0","typeLabel":"number"},{"type":"null","title":"Lien Amount","description":"The total monetary amount owed for a tax lien filing. Null for non-tax filings. Serialized as a JSON number.","example":15432.5,"uniqueKey":"filings.items.[INDEX].lien_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].lien_amount","typeLabel":"number | null"},"match_level":{"oneOf":[{"type":"string","title":"MatchType","description":"The match level of the lien filing to the business name","enum":["NO_MATCH","SIMILAR","EXACT"],"uniqueKey":"filings.items.[INDEX].match_level.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The match level of the lien filing to the business name","uniqueKey":"filings.items.[INDEX].match_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].match_level","typeLabel":"enum\u003cstring> | null"},"search_entity_name":{"oneOf":[{"type":"string","title":"Search Entity Name","description":"The name of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Search Entity Name","description":"The name of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].search_entity_name","typeLabel":"string | null"},"search_entity_type":{"oneOf":[{"type":"string","title":"BusinessOrPersonType","description":"The type of the entity that the lien filing matched to.","enum":["Business","Person"],"uniqueKey":"filings.items.[INDEX].search_entity_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The type of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].search_entity_type","typeLabel":"enum\u003cstring> | null"}},"required":["id","state","filing_number","filing_type","filing_date","lapse_date","status","number_of_pages","last_updated_at"],"title":"LienFilingResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX]","typeLabel":"LienFilingResponse (v1) · object"},"title":"Filings","type":"array","isRequired":true,"uniqueKey":"filings","typeLabel":"LienFilingResponse (v1) · object[]"},"last_updated_at":{"description":"The date the lien search result was last updated.","examples":["2024-06-01"],"format":"date","title":"Last Updated At","type":"string","isRequired":true,"uniqueKey":"last_updated_at","typeLabel":"string\u003cdate>"},"idempotency_key":{"oneOf":[{"type":"string","title":"Idempotency Key","description":"The Idempotency-Key header the request that created this resource carried, if any.","uniqueKey":"idempotency_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency Key","description":"The Idempotency-Key header the request that created this resource carried, if any.","uniqueKey":"idempotency_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"idempotency_key","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","title":"Error","description":"Any errors that occurred during the liens search request.","example":"TimeoutError: The Liens Search could not be completed.","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","title":"Error","description":"Any errors that occurred during the liens search request.","example":"TimeoutError: The Liens Search could not be completed.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"searched_states":{"oneOf":[{"type":"array","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"searched_states.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"States Specified for Liens Search","description":"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.","example":["FL","CA"],"uniqueKey":"searched_states.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Liens Search Limited to Domestic State","description":"Indicates that the liens search was limited to the domestic state of the business. A domestic state is defined as the state where the business filed its articles of incorporation and is considered its legal home state for tax purposes. This contrasts with any other states where the business might operate as a foreign entity. The search was thus focused on liens within this domestic jurisdiction, in line with the business's legal recognition and operational base.","uniqueKey":"searched_states.oneOf.1","typeLabel":"null"}],"uniqueKey":"searched_states","typeLabel":"enum\u003cstring>[] | null"},"business_id":{"oneOf":[{"type":"string","title":"Business Id","description":"The identifier of the business associated with these lien filings.","format":"uuid","example":"2d96141a-66be-4dcc-91cb-208a0a7978f8","uniqueKey":"business_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Business Id","description":"The identifier of the business associated with these lien filings.","example":"2d96141a-66be-4dcc-91cb-208a0a7978f8","uniqueKey":"business_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"business_id","typeLabel":"string\u003cuuid> | null"},"person_id":{"oneOf":[{"type":"string","title":"Person Id","description":"The identifier of the person associated with these lien filings.","format":"uuid","example":"ae3a53f8-517f-4c05-ad5f-05a938364917","uniqueKey":"person_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Person Id","description":"The identifier of the person associated with these lien filings.","example":"ae3a53f8-517f-4c05-ad5f-05a938364917","uniqueKey":"person_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_id","typeLabel":"string\u003cuuid> | null"},"business_search_id":{"oneOf":[{"type":"string","title":"Business Search Id","description":"The identifier of the business search associated with these lien filings.","format":"uuid","example":"13bffc01-7eba-40b7-960e-32132fd3ea15","uniqueKey":"business_search_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Business Search Id","description":"The identifier of the business search associated with these lien filings.","example":"13bffc01-7eba-40b7-960e-32132fd3ea15","uniqueKey":"business_search_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"business_search_id","typeLabel":"string\u003cuuid> | null"}},"required":["id","search_entities","state","filings","last_updated_at"],"title":"LiensSearchResponse (v1)","type":"object","uniqueKey":"","typeLabel":"LiensSearchResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","search_entities":[{"name":"\u003cstring>","type":"Business","search_states":["AL"],"normalized_name":"\u003cstring>"}],"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":"\u003cstring>","search_entity_type":"Business"}],"last_updated_at":"2024-06-01","idempotency_key":"\u003cstring>","error":"TimeoutError: The Liens Search could not be completed.","searched_states":["FL","CA"],"business_id":"2d96141a-66be-4dcc-91cb-208a0a7978f8","person_id":"ae3a53f8-517f-4c05-ad5f-05a938364917","business_search_id":"13bffc01-7eba-40b7-960e-32132fd3ea15"}}},"exampleType":"generated"},"application/vnd.baselayer.v1+json":{"schema":{"description":"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.","properties":{"id":{"description":"The identifier of this liens search response.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"search_entities":{"description":"A list of entities searched in the liens search.","items":{"properties":{"name":{"description":"The name of the entity to search for.","maxLength":256,"minLength":1,"title":"Name","type":"string","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].name","typeLabel":"string"},"type":{"enum":["Business","Person"],"title":"BusinessOrPersonType","type":"string","description":"The type of the entity to search for.","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"search_states":{"description":"The states to search for liens in.","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"search_entities.items.[INDEX].search_states.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"title":"Search States","type":"array","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].search_states","typeLabel":"enum\u003cstring>[]"},"normalized_name":{"readOnly":true,"title":"Normalized Name","type":"string","isRequired":true,"uniqueKey":"search_entities.items.[INDEX].normalized_name","typeLabel":"string"}},"required":["name","type","search_states","normalized_name"],"title":"AdditionalLiensSearchEntityResponse (v1)","type":"object","uniqueKey":"search_entities.items.[INDEX]","typeLabel":"AdditionalLiensSearchEntityResponse (v1) · object"},"title":"Search Entities","type":"array","isRequired":true,"uniqueKey":"search_entities","typeLabel":"AdditionalLiensSearchEntityResponse (v1) · object[]"},"state":{"enum":["PENDING","EXECUTING","COMPLETED","FAILED","CANCELLED"],"title":"TaskState","type":"string","description":"The current state of the liens search request.","isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"filings":{"description":"A list of lien filings associated with the search request.","items":{"description":"Contains detailed information about a lien filing, including the filing\nnumber, type, date, status, and associated business and search request.\nThe model also links to any amendments and the involved parties.","properties":{"id":{"description":"The identifier of this lien filing record.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"state":{"enum":["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"],"title":"StateAbbreviation","type":"string","description":"State abbreviation code where the lien is filed.","examples":["CA"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"filing_number":{"description":"Sequential identifier assigned by the filing office.","examples":["P98172"],"title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_number","typeLabel":"string"},"filing_type":{"description":"Describes the nature of the filing.","examples":["Lien for Loan Default"],"title":"Filing Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_type","typeLabel":"string"},"filing_date":{"description":"Official date when the lien was recorded.","examples":["2023-09-18"],"format":"date","title":"Filing Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].filing_date","typeLabel":"string\u003cdate>"},"lapse_date":{"description":"The expiry date for the lien's claim on collateral.","examples":["2023-04-15"],"format":"date","title":"Lapse Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].lapse_date","typeLabel":"string\u003cdate>"},"status":{"description":"Reflects the current legal status of the lien.","examples":["Under Appeal"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].status","typeLabel":"string"},"number_of_pages":{"description":"Reflects the volume of documentation for the lien filing.","examples":[14],"title":"Number Of Pages","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].number_of_pages","typeLabel":"integer"},"last_updated_at":{"description":"The date the lien filing record was last updated.","format":"date","title":"Last Updated At","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].last_updated_at","typeLabel":"string\u003cdate>"},"document_filename":{"oneOf":[{"type":"string","title":"The downloadable liens document filename.","description":"When present, it indicates that a document is available for download; Use get_lien_filing_documents or get_lien_filing_documents_for_business_id to download the documents.","example":"docket_47182.pdf","uniqueKey":"filings.items.[INDEX].document_filename.oneOf.0","typeLabel":"string"},{"type":"null","title":"The downloadable document is not available.","description":"No downloadable documents are available for this lien filing.","uniqueKey":"filings.items.[INDEX].document_filename.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].document_filename","typeLabel":"string | null"},"parties":{"default":[],"description":"A list of parties associated with this lien filing, encompassing both debtors and secured parties. This relationship is critical for identifying all entities with a vested interest in the lien's terms and outcome.","items":{"description":"Represents an entity involved in a lien as either a debtor or a secured party.\nThis model captures common attributes and relationships of these parties.","properties":{"id":{"description":"The identifier of this lien filing record.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"role":{"description":"Categorizes the party as either a debtor owing the debt or a secured party holding the collateral interest.","enum":["Debtor","Secured Party","Record Owner"],"title":"LienPartyRole","type":"string","examples":["Debtor"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"name":{"description":"Legal name of the party; crucial for due diligence and legal proceedings related to the lien.","examples":["Louis Schneider"],"title":"Name","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].name","typeLabel":"string"},"address":{"oneOf":[{"type":"object","title":"AddressSummaryResponse (v1)","description":"Address of the party; provides the physical location for legal notices or contact purposes.","required":["id","street","city","state","zip","latitude","longitude"],"properties":{"id":{"description":"Unique identifier for the address.","format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.id","typeLabel":"string\u003cuuid>"},"street":{"description":"Street name of the address.","examples":["913 Hendrix Gardens Suite 492"],"title":"Street","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.street","typeLabel":"string"},"city":{"description":"City name of the address.","examples":["Jasonfurt"],"title":"City","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.city","typeLabel":"string"},"state":{"enum":["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"],"title":"StateAbbreviation","type":"string","description":"State 2 letter abbreviation of the address.","examples":["VA"],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.state","typeLabel":"enum\u003cstring>"},"zip":{"description":"Zip code of the address.","examples":["19773"],"title":"Zip","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.zip","typeLabel":"string"},"latitude":{"description":"Latitude of the address.","examples":[38.03012],"title":"Latitude","type":"number","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.latitude","typeLabel":"number"},"longitude":{"description":"Longitude of the address.","examples":[78.47665],"title":"Longitude","type":"number","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.longitude","typeLabel":"number"},"rdi":{"oneOf":[{"type":"string","title":"AddressRDI","description":"Residential Delivery Indicator of the address.","enum":["Residential","Commercial"],"example":"Commercial","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Residential Delivery Indicator of the address.","example":"Commercial","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.rdi","typeLabel":"enum\u003cstring> | null"},"deliverable":{"oneOf":[{"type":"boolean","title":"Deliverable","description":"Indicates whether the address is deliverable.","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Deliverable","description":"Indicates whether the address is deliverable.","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.deliverable","typeLabel":"boolean | null"},"cmra":{"oneOf":[{"type":"boolean","title":"Cmra","description":"Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Cmra","description":"Indicates whether the address is a Commercial Mail Receiving Agency (CMRA).","example":false,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.cmra","typeLabel":"boolean | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL to the address details.","format":"uri","maxLength":2083,"minLength":1,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","title":"Url","description":"The URL to the address details.","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.url","typeLabel":"string\u003curi> | null"},"delivery_type":{"oneOf":[{"type":"string","title":"USPSDeliveryType","description":"The USPS delivery type.","enum":["FIRM","GENERAL_DELIVERY","HIGH_RISE","POST_OFFICE","RURAL_ROUTE","STREET"],"example":"STREET","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The USPS delivery type.","example":"STREET","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0.delivery_type","typeLabel":"enum\u003cstring> | null"}},"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.0","typeLabel":"AddressSummaryResponse (v1) · object"},{"type":"null","description":"Address of the party; provides the physical location for legal notices or contact purposes.","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].address","typeLabel":"AddressSummaryResponse (v1) · object | null"},"type":{"description":"The type of lien party, indicating whether the party is an individual or an organization.\nA computed property that returns the role of the lien party. \nNote: This `type` property is planned to be deprecated in favor of the `role` field in future versions.","examples":["individual","organization"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].type","typeLabel":"string"},"mailing_address":{"oneOf":[{"type":"string","title":"Mailing Address","description":"Street of the party's address as written on the filing itself, when known. It may accompany `address` rather than replace it: `address` is the verified address record behind the party when there is one, and these components are what the filing says — the only address a party with no verified record has.","example":"1 Market Street","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Mailing Address","description":"Street of the party's address as written on the filing itself, when known. It may accompany `address` rather than replace it: `address` is the verified address record behind the party when there is one, and these components are what the filing says — the only address a party with no verified record has.","example":"1 Market Street","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].mailing_address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","description":"City of the party's address as recorded on the filing itself; see `mailing_address`.","example":"San Francisco","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","description":"City of the party's address as recorded on the filing itself; see `mailing_address`.","example":"San Francisco","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","title":"StateAbbreviation","description":"State of the party's address as recorded on the filing itself; see `mailing_address`.","enum":["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":"CA","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"State of the party's address as recorded on the filing itself; see `mailing_address`.","example":"CA","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].state","typeLabel":"enum\u003cstring> | null"},"postal_code":{"oneOf":[{"type":"string","title":"Postal Code","description":"Postal code of the party's address as recorded on the filing itself; see `mailing_address`.","example":"94105","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Postal Code","description":"Postal code of the party's address as recorded on the filing itself; see `mailing_address`.","example":"94105","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].parties.items.[INDEX].postal_code","typeLabel":"string | null"}},"required":["id","role","name","address","type"],"title":"LienPartyResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].parties.items.[INDEX]","typeLabel":"LienPartyResponse (v1) · object"},"title":"Parties","type":"array","uniqueKey":"filings.items.[INDEX].parties","typeLabel":"LienPartyResponse (v1) · object[]"},"amendments":{"default":[],"description":"A chronological list of amendments to this lien filing, detailing any continuations, terminations, or modifications. This historical record is fundamental for tracking the evolution and current standing of the lien.","items":{"description":"Represents a change or update to a lien filing, such as a continuation,\ntermination, or assignment that affects the lien's validity or terms.","properties":{"filing_number":{"description":"The document filing number.","examples":["H76162"],"title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_number","typeLabel":"string"},"filing_type":{"description":"The document filing type.","examples":["Notarized Letter"],"title":"Filing Type","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_type","typeLabel":"string"},"filing_date":{"description":"The date of the lien filing.","examples":["2023-11-27"],"format":"date","title":"Filing Date","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].filing_date","typeLabel":"string\u003cdate>"},"number_of_pages":{"description":"Number of image pages in the library for this filing number.","examples":[4],"title":"Number Of Pages","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX].number_of_pages","typeLabel":"integer"}},"required":["filing_number","filing_type","filing_date","number_of_pages"],"title":"LienAmendmentResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].amendments.items.[INDEX]","typeLabel":"LienAmendmentResponse (v1) · object"},"title":"Amendments","type":"array","uniqueKey":"filings.items.[INDEX].amendments","typeLabel":"LienAmendmentResponse (v1) · object[]"},"collateral_type":{"oneOf":[{"type":"string","title":"CollateralType","description":"The classified type of collateral secured by this lien filing (e.g. blanket, all_receivables, real_property). Null when the collateral type has not been determined.","enum":["blanket","all_receivables","named_receivables","all_equipment","named_equipment","all_inventory","named_inventory","real_property","agricultural","other","not_applicable"],"uniqueKey":"filings.items.[INDEX].collateral_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The classified type of collateral secured by this lien filing (e.g. blanket, all_receivables, real_property). Null when the collateral type has not been determined.","uniqueKey":"filings.items.[INDEX].collateral_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].collateral_type","typeLabel":"enum\u003cstring> | null"},"collateral_statements":{"default":[],"description":"A sequence of collateral statements associated with this lien filing, enumerating the specific assets secured by the lien. The order of these statements can denote the priority of claims against the assets.","items":{"description":"Represents the text descriptions of collateral pledged against a lien as\nrecorded in a UCC filing. Each statement details the specific assets\nsecured by the lien and is sorted by a 'sort_order' to maintain\nthe intended sequence of claims.","properties":{"text":{"description":"A detailed description of the collateral that is subject to the lien.","examples":["2022 Blue Honda Civic"],"title":"Text","type":"string","isRequired":true,"uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX].text","typeLabel":"string"},"sort_order":{"description":"An integer representing the display or priority order of the collateral statements.","title":"Sort Order","type":"integer","isRequired":true,"uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX].sort_order","typeLabel":"integer"}},"required":["text","sort_order"],"title":"LienCollateralStatementResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX].collateral_statements.items.[INDEX]","typeLabel":"LienCollateralStatementResponse (v1) · object"},"title":"Collateral Statements","type":"array","uniqueKey":"filings.items.[INDEX].collateral_statements","typeLabel":"LienCollateralStatementResponse (v1) · object[]"},"lien_amount":{"oneOf":[{"type":"number","title":"Lien Amount","description":"The total monetary amount owed for a tax lien filing. Null for non-tax filings. Serialized as a JSON number.","example":15432.5,"uniqueKey":"filings.items.[INDEX].lien_amount.oneOf.0","typeLabel":"number"},{"type":"null","title":"Lien Amount","description":"The total monetary amount owed for a tax lien filing. Null for non-tax filings. Serialized as a JSON number.","example":15432.5,"uniqueKey":"filings.items.[INDEX].lien_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].lien_amount","typeLabel":"number | null"},"match_level":{"oneOf":[{"type":"string","title":"MatchType","description":"The match level of the lien filing to the business name","enum":["NO_MATCH","SIMILAR","EXACT"],"uniqueKey":"filings.items.[INDEX].match_level.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The match level of the lien filing to the business name","uniqueKey":"filings.items.[INDEX].match_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].match_level","typeLabel":"enum\u003cstring> | null"},"search_entity_name":{"oneOf":[{"type":"string","title":"Search Entity Name","description":"The name of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Search Entity Name","description":"The name of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].search_entity_name","typeLabel":"string | null"},"search_entity_type":{"oneOf":[{"type":"string","title":"BusinessOrPersonType","description":"The type of the entity that the lien filing matched to.","enum":["Business","Person"],"uniqueKey":"filings.items.[INDEX].search_entity_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The type of the entity that the lien filing matched to.","uniqueKey":"filings.items.[INDEX].search_entity_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filings.items.[INDEX].search_entity_type","typeLabel":"enum\u003cstring> | null"}},"required":["id","state","filing_number","filing_type","filing_date","lapse_date","status","number_of_pages","last_updated_at"],"title":"LienFilingResponse (v1)","type":"object","uniqueKey":"filings.items.[INDEX]","typeLabel":"LienFilingResponse (v1) · object"},"title":"Filings","type":"array","isRequired":true,"uniqueKey":"filings","typeLabel":"LienFilingResponse (v1) · object[]"},"last_updated_at":{"description":"The date the lien search result was last updated.","examples":["2024-06-01"],"format":"date","title":"Last Updated At","type":"string","isRequired":true,"uniqueKey":"last_updated_at","typeLabel":"string\u003cdate>"},"idempotency_key":{"oneOf":[{"type":"string","title":"Idempotency Key","description":"The Idempotency-Key header the request that created this resource carried, if any.","uniqueKey":"idempotency_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency Key","description":"The Idempotency-Key header the request that created this resource carried, if any.","uniqueKey":"idempotency_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"idempotency_key","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","title":"Error","description":"Any errors that occurred during the liens search request.","example":"TimeoutError: The Liens Search could not be completed.","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","title":"Error","description":"Any errors that occurred during the liens search request.","example":"TimeoutError: The Liens Search could not be completed.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"searched_states":{"oneOf":[{"type":"array","items":{"enum":["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"],"title":"StateAbbreviation","type":"string","uniqueKey":"searched_states.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"States Specified for Liens Search","description":"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.","example":["FL","CA"],"uniqueKey":"searched_states.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Liens Search Limited to Domestic State","description":"Indicates that the liens search was limited to the domestic state of the business. A domestic state is defined as the state where the business filed its articles of incorporation and is considered its legal home state for tax purposes. This contrasts with any other states where the business might operate as a foreign entity. The search was thus focused on liens within this domestic jurisdiction, in line with the business's legal recognition and operational base.","uniqueKey":"searched_states.oneOf.1","typeLabel":"null"}],"uniqueKey":"searched_states","typeLabel":"enum\u003cstring>[] | null"},"business_id":{"oneOf":[{"type":"string","title":"Business Id","description":"The identifier of the business associated with these lien filings.","format":"uuid","example":"2d96141a-66be-4dcc-91cb-208a0a7978f8","uniqueKey":"business_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Business Id","description":"The identifier of the business associated with these lien filings.","example":"2d96141a-66be-4dcc-91cb-208a0a7978f8","uniqueKey":"business_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"business_id","typeLabel":"string\u003cuuid> | null"},"person_id":{"oneOf":[{"type":"string","title":"Person Id","description":"The identifier of the person associated with these lien filings.","format":"uuid","example":"ae3a53f8-517f-4c05-ad5f-05a938364917","uniqueKey":"person_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Person Id","description":"The identifier of the person associated with these lien filings.","example":"ae3a53f8-517f-4c05-ad5f-05a938364917","uniqueKey":"person_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_id","typeLabel":"string\u003cuuid> | null"},"business_search_id":{"oneOf":[{"type":"string","title":"Business Search Id","description":"The identifier of the business search associated with these lien filings.","format":"uuid","example":"13bffc01-7eba-40b7-960e-32132fd3ea15","uniqueKey":"business_search_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Business Search Id","description":"The identifier of the business search associated with these lien filings.","example":"13bffc01-7eba-40b7-960e-32132fd3ea15","uniqueKey":"business_search_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"business_search_id","typeLabel":"string\u003cuuid> | null"}},"required":["id","search_entities","state","filings","last_updated_at"],"title":"LiensSearchResponse (v1)","type":"object","uniqueKey":"","typeLabel":"LiensSearchResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","search_entities":[{"name":"\u003cstring>","type":"Business","search_states":["AL"],"normalized_name":"\u003cstring>"}],"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":"\u003cstring>","search_entity_type":"Business"}],"last_updated_at":"2024-06-01","idempotency_key":"\u003cstring>","error":"TimeoutError: The Liens Search could not be completed.","searched_states":["FL","CA"],"business_id":"2d96141a-66be-4dcc-91cb-208a0a7978f8","person_id":"ae3a53f8-517f-4c05-ad5f-05a938364917","business_search_id":"13bffc01-7eba-40b7-960e-32132fd3ea15"}}},"exampleType":"generated"}},"exampleType":"generated"},"08567a30-1e03-4f4f-9b2c-b02698ba1bad":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b89deea2-fc16-4f08-aea1-545bdf74d5bd":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"788562d2-18e0-4de1-8ca6-c9b3fd720b2d":{"url":"https://api.baselayer.com/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"baselayer-81245324","siteName":"Baselayer","title":"Start Liens Search - Baselayer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T05:45:38.711Z","originalFileLocation":"api-reference/lien-search/start-liens-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Baselayer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start Liens Search - Baselayer\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Baselayer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://baselayer-81245324.mintlify.app/_mintlify/api/og/v2?division=Business+Lien+Search\u0026amp;title=Start+Liens+Search\u0026amp;description=This+endpoint+starts+a+liens+search+for+a+given+person+or+business.%0AExactly+one+of+%60business_id%60+or+%60person_id%60+must+be+provided.+If+%60person_id%60%0Ais+provided%2C+%60s\u0026amp;theme=da3e09036423c5729d7edf96\u0026amp;signature=83ef4445294641a802346a5b309d43608fd11f9e41be39c4767947fc2c4dbeee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Start Liens Search - Baselayer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://baselayer-81245324.mintlify.app/_mintlify/api/og/v2?division=Business+Lien+Search\u0026amp;title=Start+Liens+Search\u0026amp;description=This+endpoint+starts+a+liens+search+for+a+given+person+or+business.%0AExactly+one+of+%60business_id%60+or+%60person_id%60+must+be+provided.+If+%60person_id%60%0Ais+provided%2C+%60s\u0026amp;theme=da3e09036423c5729d7edf96\u0026amp;signature=83ef4445294641a802346a5b309d43608fd11f9e41be39c4767947fc2c4dbeee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Baselayer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#384ce3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/lien-search/start-liens-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.baselayer.com/#organization\",\"name\":\"Baselayer\",\"url\":\"https://docs.baselayer.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.baselayer.com#website\",\"name\":\"Baselayer\",\"url\":\"https://docs.baselayer.com\",\"publisher\":{\"@id\":\"https://docs.baselayer.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search#webpage\",\"url\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search\",\"name\":\"Start Liens Search\",\"description\":\"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.\",\"dateModified\":\"2026-10-29T05:45:38.711Z\",\"isPartOf\":{\"@id\":\"https://docs.baselayer.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Baselayer\",\"item\":\"https://docs.baselayer.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start Liens Search\",\"item\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search#apireference\",\"headline\":\"Start Liens Search\",\"name\":\"Start Liens Search\",\"description\":\"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.\",\"url\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.baselayer.com/api-reference/lien-search/start-liens-search#webpage\"},\"dateModified\":\"2026-10-29T05:45:38.711Z\",\"publisher\":{\"@id\":\"https://docs.baselayer.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.baselayer.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Baselayer\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Baselayer","nav":{"global":null,"tabs":[{"tab":"Get Started","icon":"rocket","pages":[{"title":"Get Started","href":"/docs/meet-baselayer"}]},{"tab":"Verify Businesses \u0026 People","icon":"book-open","pages":[{"title":"Verify Businesses \u0026 People","href":"/docs/business-verification-basics"}]},{"tab":"Know Your Agent","icon":"robot","pages":[{"title":"Know Your Agent","href":"/docs/kya-overview"}]},{"tab":"Hosted Enrollment","icon":"id-card","pages":[{"title":"Hosted Enrollment","href":"/hosted-enrollment/overview"}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/docs/mcp"}]},{"tab":"API Reference","icon":"square-terminal","anchors":[{"anchor":"Businesses","icon":"building","groups":[{"group":"Business Verification","pages":[{"group":"KYB Search","pages":[{"title":"Post Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /searches","href":"/api-reference/search/post-search"},{"title":"Get Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /searches/{id}","href":"/api-reference/search/get-search"},{"title":"Get Task Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /searches/{id}/status","href":"/api-reference/search/get-task-status"},{"title":"Get Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /searches","href":"/api-reference/search/get-searches"},{"title":"Export Search To Pdf","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /searches/{id}/export","href":"/api-reference/search/export-search-to-pdf"}]},{"group":"Batch Search","pages":[{"title":"List search batches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /searches/batches","href":"/api-reference/search/list-search-batches"},{"title":"Get Search Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /searches/batch/{id}","href":"/api-reference/search/get-search-batch"}]},{"group":"Reason Codes","pages":[{"title":"List every reason code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /reason_codes","href":"/api-reference/reason-codes/list-every-reason-code"}]},{"group":"Business Information","pages":[{"title":"Get Business","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}","href":"/api-reference/business/get-business"},{"title":"Get Business Officers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/officers","href":"/api-reference/business/get-business-officers"},{"title":"Get Business Registrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/registrations","href":"/api-reference/business/get-business-registrations"},{"title":"Get Business Application History","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/applications","href":"/api-reference/business/get-business-application-history"},{"title":"Get Business Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/searches","href":"/api-reference/business/get-business-searches"},{"title":"Get Business Search Combinations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/search_combinations","href":"/api-reference/business/get-business-search-combinations"},{"title":"Get Registration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /registrations/{id}","href":"/api-reference/business/get-registration"},{"title":"Get Address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /addresses/{address_id}","href":"/api-reference/address/get-address"},{"title":"Get Exclusions For Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /businesses/{id}/exclusions","href":"/api-reference/exclusions/get-exclusions-for-search"}]},{"group":"TIN Verification","pages":[{"title":"Submit Tin Verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tin_verifications","href":"/api-reference/tin-verification/submit-tin-verification"},{"title":"Get Tin Verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tin_verifications/{id}","href":"/api-reference/tin-verification/get-tin-verification"},{"title":"List Tin Verifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tin_verifications","href":"/api-reference/tin-verification/list-tin-verifications"}]},{"group":"OFAC Batch Screening","pages":[{"title":"Post Ofac Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ofac/searches/batches","href":"/api-reference/ofac/post-ofac-batch"},{"title":"Get Ofac Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ofac/searches/batches/{batch_id}","href":"/api-reference/ofac/get-ofac-batch"},{"title":"List Ofac Batches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ofac/searches/batches","href":"/api-reference/ofac/list-ofac-batches"},{"title":"Get Ofac Batch File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ofac/searches/batches/{batch_id}/download","href":"/api-reference/ofac/get-ofac-batch-file"}]},{"group":"Consortium","pages":[{"title":"Search Consortium","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /consortium/searches","href":"/api-reference/consortium/search-consortium"},{"title":"Post Consortium Search Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /consortium/searches/batches","href":"/api-reference/consortium/post-consortium-search-batch"},{"title":"Post Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /consortium/submissions","href":"/api-reference/consortium/post-submission"},{"title":"Get Consortium Search Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /consortium/searches/batches/{batch_id}","href":"/api-reference/consortium/get-consortium-search-batch"},{"title":"Get Submissions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /consortium/submissions","href":"/api-reference/consortium/get-submissions"},{"title":"Download Consortium Search Results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /consortium/searches/batches/{batch_id}/download","href":"/api-reference/consortium/download-consortium-search-results"},{"title":"Download Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /consortium/submissions/{submission_id}/download","href":"/api-reference/consortium/download-submission"}]},{"group":"International KYB","pages":[{"title":"Post International Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /international/searches","href":"/api-reference/international/post-international-search"},{"title":"Get International Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /international/searches/{id}","href":"/api-reference/international/get-international-search"},{"title":"Get International Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /international/searches","href":"/api-reference/international/get-international-searches"},{"title":"Search International Registrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /international/registrations","href":"/api-reference/international/search-international-registrations"},{"title":"List International Countries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /international/countries","href":"/api-reference/international/list-international-countries"}]},{"group":"Pre.Fill \u0026 Autocomplete","pages":[{"title":"Business Prefill","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /prefill/businesses","href":"/api-reference/prefill/business-prefill"},{"title":"Mint an autocomplete session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /autocomplete/sessions","href":"/api-reference/autocomplete/mint-an-autocomplete-session"},{"title":"Autocomplete","description":"Suggest businesses matching a partial name, for typeahead UIs.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /autocomplete","href":"/api-reference/business-autocomplete/autocomplete"}]}]},{"group":"Liens","pages":[{"group":"Business Lien Search","pages":[{"title":"Start Liens Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_searches","href":"/api-reference/lien-search/start-liens-search"},{"title":"Get All Lien Searches","description":"This endpoint returns all lien searches.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches","href":"/api-reference/lien-search/get-all-lien-searches"},{"title":"Get Liens Search Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches/{liens_search_request_id}/status","href":"/api-reference/lien-search/get-liens-search-status"},{"title":"Get Liens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches/{liens_search_request_id}","href":"/api-reference/lien-search/get-liens"},{"title":"Get Lien Filing Documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches/{liens_search_request_id}/filings/{filing_id}","href":"/api-reference/lien-search/get-lien-filing-documents"}]},{"group":"Adhoc Lien Search","pages":[{"title":"Start Liens Adhoc Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_searches/adhoc","href":"/api-reference/lien-search/start-liens-adhoc-search"},{"title":"Get Adhoc Lien Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches/adhoc","href":"/api-reference/lien-search/get-adhoc-lien-searches"},{"title":"Get Adhoc Liens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_searches/adhoc/{liens_search_request_id}","href":"/api-reference/lien-search/get-adhoc-liens"}]},{"group":"Lien Filing","expanded":false,"pages":[{"title":"Create New Ucc1 Lien Filing Submission For Business","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /businesses/{business_id}/lien_submissions","href":"/api-reference/lien-filing/create-new-ucc1-lien-filing-submission-for-business"},{"title":"Create New Standalone Ucc1 Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions","href":"/api-reference/lien-filing/create-new-standalone-ucc1-lien-filing-submission"},{"title":"Import Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/import","href":"/api-reference/lien-filing/import-lien-filing-submission"},{"title":"Import Lien Filings In Bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/import/batches","href":"/api-reference/lien-filing/import-lien-filings-in-bulk"},{"title":"Lookup Initial Filing For Amendment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/initial_filing_lookup","href":"/api-reference/lien-filing/lookup-initial-filing-for-amendment"},{"title":"Create New Ucc3 Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/{filing_id}/amend","href":"/api-reference/lien-filing/create-new-ucc3-lien-filing-submission"},{"title":"Upload Lien Submission Attachment Item Attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/{filing_id}/attachments","href":"/api-reference/lien-filing/upload-lien-submission-attachment-item-attachment"},{"title":"Cancel Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/{filing_id}/cancel","href":"/api-reference/lien-filing/cancel-lien-filing-submission"},{"title":"Submit Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lien_submissions/{filing_id}/submit","href":"/api-reference/lien-filing/submit-lien-filing-submission"},{"title":"Create New Ucc1 Lien Filing Submission For Person","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /people/{person_id}/lien_submissions","href":"/api-reference/lien-filing/create-new-ucc1-lien-filing-submission-for-person"},{"title":"Get Lien Filing Submissions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions","href":"/api-reference/lien-filing/get-lien-filing-submissions"},{"title":"List Lien Filing Import Batches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/import/batches","href":"/api-reference/lien-filing/list-lien-filing-import-batches"},{"title":"Get Lien Filing Import Batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/import/batches/{batch_id}","href":"/api-reference/lien-filing/get-lien-filing-import-batch"},{"title":"Download Lien Filing Import Batch Results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/import/batches/{batch_id}/download","href":"/api-reference/lien-filing/download-lien-filing-import-batch-results"},{"title":"Fetch Existing Lien Filing","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}","href":"/api-reference/lien-filing/fetch-existing-lien-filing"},{"title":"Get Lien Submission Attachments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}/attachments","href":"/api-reference/lien-filing/get-lien-submission-attachments"},{"title":"Get Lien Submission Attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}/attachments/{attachment_id}","href":"/api-reference/lien-filing/get-lien-submission-attachment"},{"title":"Get Lien Submission Filed Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}/filed_document","href":"/api-reference/lien-filing/get-lien-submission-filed-document"},{"title":"Get Lien Submission Preview Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}/preview_document","href":"/api-reference/lien-filing/get-lien-submission-preview-document"},{"title":"Get Lien Submission Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lien_submissions/{filing_id}/submission_document","href":"/api-reference/lien-filing/get-lien-submission-document"},{"title":"Patch Existing Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /lien_submissions/{filing_id}","href":"/api-reference/lien-filing/patch-existing-lien-filing-submission"},{"title":"Delete Lien Filing Submission","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /lien_submissions/{filing_id}","href":"/api-reference/lien-filing/delete-lien-filing-submission"},{"title":"Delete Lien Submission Attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /lien_submissions/{filing_id}/attachments/{attachment_id}","href":"/api-reference/lien-filing/delete-lien-submission-attachment"}]}]},{"group":"Litigations","pages":[{"group":"Business Docket Search","pages":[{"title":"Start Docket Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /docket_searches","href":"/api-reference/litigation-\u0026-bankruptcy/start-docket-search"},{"title":"Get All Docket Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches","href":"/api-reference/litigation-\u0026-bankruptcy/get-all-docket-searches"},{"title":"Get Docket Search Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/{search_request_id}/status","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-search-status"},{"title":"Get All Dockets By Search Request Id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/{search_request_id}","href":"/api-reference/litigation-\u0026-bankruptcy/get-all-dockets-by-search-request-id"}]},{"group":"Adhoc Docket Search","pages":[{"title":"Start Docket Adhoc Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /docket_searches/adhoc","href":"/api-reference/litigation-\u0026-bankruptcy/start-docket-adhoc-search"},{"title":"Get Adhoc Docket Searches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/adhoc","href":"/api-reference/litigation-\u0026-bankruptcy/get-adhoc-docket-searches"},{"title":"Get Adhoc Docket Search By Search Request Id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/adhoc/{search_request_id}","href":"/api-reference/litigation-\u0026-bankruptcy/get-adhoc-docket-search-by-search-request-id"}]},{"group":"Docket Details","pages":[{"title":"Order Docket Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /dockets/{docket_id}/details","href":"/api-reference/litigation-\u0026-bankruptcy/order-docket-details"},{"title":"Get Docket Details Request Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/details/{docket_details_request_id}/status","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-details-request-status"},{"title":"Get Docket Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dockets/{docket_id}/details","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-details"},{"title":"Get Docket Details By Request Id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/details/{docket_details_request_id}","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-details-by-request-id"}]},{"group":"Docket Exhibits","pages":[{"title":"Order Docket Exhibit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /dockets/exhibits/{docket_exhibit_id}","href":"/api-reference/litigation-\u0026-bankruptcy/order-docket-exhibit"},{"title":"Get Docket Exhibit Request Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docket_searches/exhibits/{docket_exhibit_request_id}/status","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-exhibit-request-status"},{"title":"Get Docket Exhibit Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dockets/exhibits/{docket_exhibit_id}","href":"/api-reference/litigation-\u0026-bankruptcy/get-docket-exhibit-document"}]}]},{"group":"Online","pages":[{"group":"Web Presence","pages":[{"title":"Post Web Presence Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /web_presence_requests","href":"/api-reference/web-presence/post-web-presence-request"},{"title":"Get Web Presence Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /web_presence_requests/{id}","href":"/api-reference/web-presence/get-web-presence-request"},{"title":"List Web Presence Requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /web_presence_requests","href":"/api-reference/web-presence/list-web-presence-requests"}]},{"group":"Website Analysis","pages":[{"title":"Post Website Analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /website_analysis_requests","href":"/api-reference/website-analysis/post-website-analysis"},{"title":"Get Website Analysis Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website_analysis_requests/{id}","href":"/api-reference/website-analysis/get-website-analysis-request"},{"title":"Get Website Analysis Requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website_analysis_requests","href":"/api-reference/website-analysis/get-website-analysis-requests"},{"title":"Get Website Analysis Screenshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website_analysis/{id}/screenshot","href":"/api-reference/website-analysis/get-website-analysis-screenshot"}]},{"group":"Industry Prediction","pages":[{"title":"Post Naics Prediction Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /naics_prediction_requests","href":"/api-reference/industry-prediction/post-naics-prediction-request"},{"title":"Get Industry Prediction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /naics_prediction_requests/{id}","href":"/api-reference/industry-prediction/get-industry-prediction"},{"title":"Get Industry Prediction Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /naics_prediction_requests/{id}/status","href":"/api-reference/industry-prediction/get-industry-prediction-status"}]}]},{"group":"Portfolio Monitoring","expanded":false,"pages":[{"group":"Items","pages":[{"title":"Create Portfolio Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/items","href":"/api-reference/portfolio-monitoring/create-portfolio-item"},{"title":"Create Portfolio Items Bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/items/bulk","href":"/api-reference/portfolio-monitoring/create-portfolio-items-bulk"},{"title":"Get Portfolio Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items","href":"/api-reference/portfolio-monitoring/get-portfolio-items"},{"title":"Get Portfolio Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}","href":"/api-reference/portfolio-monitoring/get-portfolio-item"},{"title":"Update Portfolio Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /portfolio/items/{item_id}","href":"/api-reference/portfolio-monitoring/update-portfolio-item"},{"title":"Delete Portfolio Item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /portfolio/items/{item_id}","href":"/api-reference/portfolio-monitoring/delete-portfolio-item"}]},{"group":"Groups","pages":[{"title":"Create Portfolio Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/groups","href":"/api-reference/portfolio-monitoring/create-portfolio-group"},{"title":"Get Portfolio Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups","href":"/api-reference/portfolio-monitoring/get-portfolio-groups"},{"title":"Get Portfolio Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups/{group_id}","href":"/api-reference/portfolio-monitoring/get-portfolio-group"},{"title":"Get Portfolio Group Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups/{group_id}/items","href":"/api-reference/portfolio-monitoring/get-portfolio-group-items"},{"title":"Update Portfolio Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /portfolio/groups/{group_id}","href":"/api-reference/portfolio-monitoring/update-portfolio-group"},{"title":"Delete Portfolio Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /portfolio/groups/{group_id}","href":"/api-reference/portfolio-monitoring/delete-portfolio-group"}]},{"group":"Monitoring Policies","pages":[{"group":"Available Policies","pages":[{"title":"Get Monitoring Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /monitoring_policies","href":"/api-reference/portfolio-monitoring/get-monitoring-policies"}]},{"group":"Portfolio","pages":[{"title":"Get Portfolio Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/monitoring_policy","href":"/api-reference/portfolio-monitoring/get-portfolio-monitoring-policy"},{"title":"Update Portfolio Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /portfolio/monitoring_policy","href":"/api-reference/portfolio-monitoring/update-portfolio-monitoring-policy"}]},{"group":"Group","pages":[{"title":"Get Portfolio Group Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups/{group_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/get-portfolio-group-monitoring-policy"},{"title":"Update Portfolio Group Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /portfolio/groups/{group_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/update-portfolio-group-monitoring-policy"},{"title":"Delete Portfolio Group Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /portfolio/groups/{group_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/delete-portfolio-group-monitoring-policy"}]},{"group":"Item","pages":[{"title":"Get Portfolio Item Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/get-portfolio-item-monitoring-policy"},{"title":"Update Portfolio Item Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /portfolio/items/{item_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/update-portfolio-item-monitoring-policy"},{"title":"Delete Portfolio Item Monitoring Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /portfolio/items/{item_id}/monitoring_policy","href":"/api-reference/portfolio-monitoring/delete-portfolio-item-monitoring-policy"}]}]},{"group":"Notification Policies","pages":[{"group":"Policy Definitions","pages":[{"title":"Get Notification Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notification_policies","href":"/api-reference/portfolio-monitoring/get-notification-policies"},{"title":"Get Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notification_policies/{notification_policy_id}","href":"/api-reference/portfolio-monitoring/get-notification-policy"},{"title":"Update Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /notification_policies/{notification_policy_id}","href":"/api-reference/portfolio-monitoring/update-notification-policy"},{"title":"Delete Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /notification_policies/{notification_policy_id}","href":"/api-reference/portfolio-monitoring/delete-notification-policy"}]},{"group":"Portfolio","pages":[{"title":"Create Portfolio Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/notification_policies","href":"/api-reference/portfolio-monitoring/create-portfolio-notification-policy"},{"title":"Get Portfolio Notification Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/notification_policies","href":"/api-reference/portfolio-monitoring/get-portfolio-notification-policies"}]},{"group":"Group","pages":[{"title":"Create Portfolio Group Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/groups/{group_id}/notification_policies","href":"/api-reference/portfolio-monitoring/create-portfolio-group-notification-policy"},{"title":"Get Portfolio Group Notification Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups/{group_id}/notification_policies","href":"/api-reference/portfolio-monitoring/get-portfolio-group-notification-policies"}]},{"group":"Item","pages":[{"title":"Create Portfolio Item Notification Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /portfolio/items/{item_id}/notification_policies","href":"/api-reference/portfolio-monitoring/create-portfolio-item-notification-policy"},{"title":"Get Portfolio Item Notification Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/notification_policies","href":"/api-reference/portfolio-monitoring/get-portfolio-item-notification-policies"}]}]},{"group":"Updates \u0026 Notifications","pages":[{"title":"Get Portfolio Group Updates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/groups/{group_id}/updates","href":"/api-reference/portfolio-monitoring/get-portfolio-group-updates"},{"title":"Get Portfolio Item Changes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/changes","href":"/api-reference/portfolio-monitoring/get-portfolio-item-changes"},{"title":"Get Portfolio Item Notifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/notifications","href":"/api-reference/portfolio-monitoring/get-portfolio-item-notifications"},{"title":"Get Portfolio Item Updates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/updates","href":"/api-reference/portfolio-monitoring/get-portfolio-item-updates"},{"title":"Get Portfolio Updates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/updates","href":"/api-reference/portfolio-monitoring/get-portfolio-updates"}]},{"group":"Snapshots","pages":[{"title":"Get Portfolio Item Snapshot Diff","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/diff","href":"/api-reference/portfolio-monitoring/get-portfolio-item-snapshot-diff"},{"title":"Get Portfolio Item Snapshots","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/snapshots","href":"/api-reference/portfolio-monitoring/get-portfolio-item-snapshots"},{"title":"Get Portfolio Item Snapshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /portfolio/items/{item_id}/snapshots/{snapshot_id}","href":"/api-reference/portfolio-monitoring/get-portfolio-item-snapshot"}]}]}]},{"anchor":"People","icon":"user","pages":[{"title":"People","href":"/api-reference/people/create-person"}]},{"anchor":"Know Your Agent","icon":"robot","pages":[{"title":"Know Your Agent","href":"/api-reference/credentials/mint-a-credential-for-a-person-or-a-business-operator"}]},{"anchor":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/api-reference/organization-management/create-organization-for-federation"}]},{"anchor":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/api-reference/webhook-management/create-webhook-endpoint"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/texas-comptroller-franchise-tax-standing"}]}]},"basePath":"","title":"Start Liens Search - Baselayer","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}