---
title: "Get Liens Search Status"
method: GET
path: "/lien_searches/{liens_search_request_id}/status"
tags: ["Lien Search"]
---

# Get Liens Search Status

`GET /lien_searches/{liens_search_request_id}/status`

This endpoint retrieves the status of a specific lien search request by its unique
identifier. It returns a LiensSearchState object that includes
the state of the request.

## Path parameters

- `liens_search_request_id` string, uuid, required — The unique identifier of the liens search request.

## Response `200`

Successful Response

- V1LiensSearchState — Represents the status of a liens search request. This includes the unique identifier of the request, the current state of the request, and any errors that occurred during the request.
  - `id` string, uuid, required — The identifier of this liens search response.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `error` string, nullable — Any errors that occurred during the liens search request.
  - `last_updated_at` string, date, required — The date the lien search result was last updated.
  - `searched_states` StateAbbreviation[], nullable — 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.
  - `person_id` string, uuid, nullable — The identifier of the person associated with these lien filings.
  - `business_id` string, uuid, nullable — The identifier of the business associated with these lien filings.
  - `business_search_id` string, uuid, nullable — The identifier of the business search associated with these lien filings.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/revisions/0cc89938bc26/schema)