> ## Documentation Index > Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Adhoc Liens > This endpoint retrieves a specific adhoc lien search request by its unique identifier. It returns a LiensSearchRequest object that includes the state of the request and a list of lien filings associated with the request. The lien filings provide detailed information about each lien, including the filing number, type, date, status, and associated business and search request. The model also links to any amendments and the involved parties. ## OpenAPI ````yaml /api-reference/openapi.json get /lien_searches/adhoc/{liens_search_request_id} openapi: 3.1.0 info: title: baselayer-api-service version: 0.1.0 servers: - url: https://api.baselayer.com/ security: [] paths: /lien_searches/adhoc/{liens_search_request_id}: get: tags: - Lien Search summary: Get Adhoc Liens description: >- This endpoint retrieves a specific adhoc lien search request by its unique identifier. It returns a LiensSearchRequest object that includes the state of the request and a list of lien filings associated with the request. The lien filings provide detailed information about each lien, including the filing number, type, date, status, and associated business and search request. The model also links to any amendments and the involved parties. operationId: get_adhoc_liens_lien_searches_adhoc__liens_search_request_id__get parameters: - name: liens_search_request_id in: path required: true schema: type: string format: uuid title: Adhoc Liens Search Request ID description: The unique identifier of the adhoc liens search request. examples: - 3fbc6a5b-b22a-4dc8-a91e-71603790e979 description: The unique identifier of the adhoc liens search request. responses: '200': description: Response content: application/json: schema: $ref: '#/components/schemas/v1.AdhocLiensSearchResponse' application/vnd.baselayer.v1+json: schema: $ref: '#/components/schemas/v1.AdhocLiensSearchResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: v1.AdhocLiensSearchResponse: description: >- Represents the response from an adhoc liens search request. This includes the unique identifier of the request, the current state of the request, and a list of lien filings associated with the request. properties: id: description: The identifier of this liens search response. format: uuid title: Id type: string name: description: The name used for the ad-hoc liens search. title: Name type: string state: $ref: '#/components/schemas/v1.TaskState' description: The current state of the liens search request. error: anyOf: - type: string - type: 'null' default: null description: Any errors that occurred during the liens search request. examples: - 'TimeoutError: The Liens Search could not be completed.' title: Error filings: description: A list of lien filings associated with the search request. items: $ref: '#/components/schemas/v1.LienFilingResponse' title: Filings type: array 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 searched_states: description: Indicates the list of states specified in the liens search request. examples: - - FL - CA items: $ref: '#/components/schemas/v1.StateAbbreviation' title: States Specified for Liens Search type: array required: - id - name - state - filings - last_updated_at - searched_states title: AdhocLiensSearchResponse (v1) type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError v1.TaskState: enum: - PENDING - EXECUTING - COMPLETED - FAILED - CANCELLED title: TaskState type: string v1.LienFilingResponse: description: |- Contains detailed information about a lien filing, including the filing number, type, date, status, and associated business and search request. The 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 state: $ref: '#/components/schemas/v1.StateAbbreviation' description: State abbreviation code where the lien is filed. examples: - CA filing_number: description: Sequential identifier assigned by the filing office. examples: - P98172 title: Filing Number type: string filing_type: description: Describes the nature of the filing. examples: - Lien for Loan Default title: Filing Type type: string filing_date: description: Official date when the lien was recorded. examples: - '2023-09-18' format: date title: Filing Date type: string lapse_date: description: The expiry date for the lien's claim on collateral. examples: - '2023-04-15' format: date title: Lapse Date type: string status: description: Reflects the current legal status of the lien. examples: - Under Appeal title: Status type: string number_of_pages: description: Reflects the volume of documentation for the lien filing. examples: - 14 title: Number Of Pages type: integer document_filename: anyOf: - 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. examples: - docket_47182.pdf title: The downloadable liens document filename. type: string - description: No downloadable documents are available for this lien filing. title: The downloadable document is not available. type: 'null' default: null title: Document Filename 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: $ref: '#/components/schemas/v1.LienPartyResponse' title: Parties type: array 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: $ref: '#/components/schemas/v1.LienAmendmentResponse' title: Amendments type: array collateral_type: anyOf: - $ref: '#/components/schemas/v1.CollateralType' - type: 'null' default: 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. 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: $ref: '#/components/schemas/v1.LienCollateralStatementResponse' title: Collateral Statements type: array lien_amount: anyOf: - type: number - type: 'null' description: >- The total monetary amount owed for a tax lien filing. Null for non-tax filings. Serialized as a JSON number. examples: - 15432.5 title: Lien Amount last_updated_at: description: The date the lien filing record was last updated. format: date title: Last Updated At type: string match_level: anyOf: - $ref: '#/components/schemas/v1.MatchType' - type: 'null' default: null description: The match level of the lien filing to the business name search_entity_name: anyOf: - type: string - type: 'null' default: null description: The name of the entity that the lien filing matched to. title: Search Entity Name search_entity_type: anyOf: - $ref: '#/components/schemas/v1.BusinessOrPersonType' - type: 'null' default: null description: The type of the entity that the lien filing matched to. required: - id - state - filing_number - filing_type - filing_date - lapse_date - status - number_of_pages - last_updated_at title: LienFilingResponse (v1) type: object v1.StateAbbreviation: 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 ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError v1.LienPartyResponse: description: >- Represents an entity involved in a lien as either a debtor or a secured party. This 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 role: $ref: '#/components/schemas/v1.LienPartyRole' description: >- Categorizes the party as either a debtor owing the debt or a secured party holding the collateral interest. examples: - Debtor 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 address: anyOf: - $ref: '#/components/schemas/v1.AddressSummaryResponse' - type: 'null' description: >- Address of the party; provides the physical location for legal notices or contact purposes. mailing_address: anyOf: - type: string - type: 'null' default: null 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. examples: - 1 Market Street title: Mailing Address city: anyOf: - type: string - type: 'null' default: null description: >- City of the party's address as recorded on the filing itself; see `mailing_address`. examples: - San Francisco title: City state: anyOf: - $ref: '#/components/schemas/v1.StateAbbreviation' - type: 'null' default: null description: >- State of the party's address as recorded on the filing itself; see `mailing_address`. examples: - CA postal_code: anyOf: - type: string - type: 'null' default: null description: >- Postal code of the party's address as recorded on the filing itself; see `mailing_address`. examples: - '94105' title: Postal Code type: description: >- The type of lien party, indicating whether the party is an individual or an organization. A computed property that returns the role of the lien party. Note: This `type` property is planned to be deprecated in favor of the `role` field in future versions. examples: - individual - organization title: Type type: string required: - id - role - name - address - type title: LienPartyResponse (v1) type: object v1.LienAmendmentResponse: description: |- Represents a change or update to a lien filing, such as a continuation, termination, 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 filing_type: description: The document filing type. examples: - Notarized Letter title: Filing Type type: string filing_date: description: The date of the lien filing. examples: - '2023-11-27' format: date title: Filing Date type: string number_of_pages: description: Number of image pages in the library for this filing number. examples: - 4 title: Number Of Pages type: integer required: - filing_number - filing_type - filing_date - number_of_pages title: LienAmendmentResponse (v1) type: object v1.CollateralType: description: Classifies the collateral grant on a lien filing. enum: - blanket - all_receivables - named_receivables - all_equipment - named_equipment - all_inventory - named_inventory - real_property - agricultural - other - not_applicable title: CollateralType type: string v1.LienCollateralStatementResponse: description: |- Represents the text descriptions of collateral pledged against a lien as recorded in a UCC filing. Each statement details the specific assets secured by the lien and is sorted by a 'sort_order' to maintain the 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 sort_order: description: >- An integer representing the display or priority order of the collateral statements. title: Sort Order type: integer required: - text - sort_order title: LienCollateralStatementResponse (v1) type: object v1.MatchType: enum: - NO_MATCH - SIMILAR - EXACT title: MatchType type: string v1.BusinessOrPersonType: enum: - Business - Person title: BusinessOrPersonType type: string v1.LienPartyRole: description: |- Enum class delineating the role of parties in a lien transaction as defined by the UCC. enum: - Debtor - Secured Party - Record Owner title: LienPartyRole type: string v1.AddressSummaryResponse: description: |- Response model for address summary data. This model defines the structure for address summary API responses. properties: id: description: Unique identifier for the address. format: uuid title: Id type: string street: description: Street name of the address. examples: - 913 Hendrix Gardens Suite 492 title: Street type: string city: description: City name of the address. examples: - Jasonfurt title: City type: string state: $ref: '#/components/schemas/v1.StateAbbreviation' description: State 2 letter abbreviation of the address. examples: - VA zip: description: Zip code of the address. examples: - '19773' title: Zip type: string latitude: description: Latitude of the address. examples: - 38.03012 title: Latitude type: number longitude: description: Longitude of the address. examples: - 78.47665 title: Longitude type: number rdi: anyOf: - $ref: '#/components/schemas/v1.AddressRDI' - type: 'null' default: null description: Residential Delivery Indicator of the address. examples: - Commercial deliverable: anyOf: - type: boolean - type: 'null' default: null description: Indicates whether the address is deliverable. examples: - false title: Deliverable cmra: anyOf: - type: boolean - type: 'null' default: null description: >- Indicates whether the address is a Commercial Mail Receiving Agency (CMRA). examples: - false title: Cmra url: anyOf: - format: uri maxLength: 2083 minLength: 1 type: string - type: 'null' default: null description: The URL to the address details. title: Url delivery_type: anyOf: - $ref: '#/components/schemas/v1.USPSDeliveryType' - type: 'null' default: null description: The USPS delivery type. examples: - STREET - FIRM required: - id - street - city - state - zip - latitude - longitude title: AddressSummaryResponse (v1) type: object v1.AddressRDI: enum: - Residential - Commercial title: AddressRDI type: string v1.USPSDeliveryType: description: |- Enum representing the different types of USPS delivery points. Used to classify addresses based on how mail is delivered to them. enum: - FIRM - GENERAL_DELIVERY - HIGH_RISE - POST_OFFICE - RURAL_ROUTE - STREET title: USPSDeliveryType type: string securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````