> ## 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 Liens Search 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.



## OpenAPI

````yaml /api-reference/openapi.json get /lien_searches/{liens_search_request_id}/status
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /lien_searches/{liens_search_request_id}/status:
    get:
      tags:
        - Lien Search
      summary: Get Liens Search Status
      description: >-
        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.
      operationId: >-
        get_liens_search_status_lien_searches__liens_search_request_id__status_get
      parameters:
        - name: liens_search_request_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Liens Search Request ID
            description: The unique identifier of the liens search request.
            examples:
              - 32efbaf2-8037-4218-a368-13d844a6fdf8
          description: The unique identifier of the liens search request.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1.LiensSearchState'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    v1.LiensSearchState:
      properties:
        id:
          description: The identifier of this liens search response.
          format: uuid
          title: Id
          type: string
        state:
          $ref: '#/components/schemas/TaskState'
          description: The current state of the liens search request.
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: Any errors that occurred during the liens search request.
          examples:
            - 'TimeoutError: The Liens Search could not be completed.'
        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:
          anyOf:
            - items:
                $ref: '#/components/schemas/StateAbbreviation'
              type: array
              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.
              examples:
                - - CA
                  - GA
            - 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.
              title: Liens Search Limited to Domestic State
              type: 'null'
          title: Searched States
        person_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Person Id
          description: The identifier of the person associated with these lien filings.
          examples:
            - f6f56773-54c8-4fb1-a550-bbee60a364e8
        business_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Business Id
          description: The identifier of the business associated with these lien filings.
          examples:
            - 9fbd8770-34bb-4798-8c8c-538fcdf23bd3
        business_search_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Business Search Id
          description: >-
            The identifier of the business search associated with these lien
            filings.
          examples:
            - 7a9f00b7-2a1a-46fe-88d4-0c172b046151
      type: object
      required:
        - id
        - state
        - last_updated_at
      title: LiensSearchState (v1)
      description: >-
        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.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TaskState:
      enum:
        - PENDING
        - EXECUTING
        - COMPLETED
        - FAILED
        - CANCELLED
      title: TaskState
      type: string
    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
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````