> ## 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 All Lien Searches

> This endpoint returns all lien searches.



## OpenAPI

````yaml /api-reference/openapi.json get /lien_searches
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /lien_searches:
    get:
      tags:
        - Lien Search
      summary: Get All Lien Searches
      description: This endpoint returns all lien searches.
      operationId: get_all_lien_searches_lien_searches_get
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            title: Limit
            description: The maximum number of lien searches to return.
            default: 10
          description: The maximum number of lien searches to return.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            title: Offset
            description: >-
              The number of lien searches to skip before starting to return the
              lien searches.
            default: 0
          description: >-
            The number of lien searches to skip before starting to return the
            lien searches.
        - name: type
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/SearchRequestSubjectType'
            title: Type
            description: The type of lien searches to return.
            examples:
              - Business
              - Person
              - BusinessSearch
          description: The type of lien searches to return.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/v1.LiensSearchState'
                title: Response Get All Lien Searches Lien Searches Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    SearchRequestSubjectType:
      type: string
      enum:
        - Business
        - Person
        - BusinessSearch
      title: SearchRequestSubjectType
      description: >-
        Discriminator for bodies of POST /lien_searches and POST
        /docket_searches requests.

        Names a business record, a person record, or a business search
    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

````