> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worthai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bankruptcies Judgements & Liens (BJL)

> Retrieve bankruptcies, judgements, and liens associated with a business



## OpenAPI

````yaml get /facts/business/{businessId}/bjl
openapi: 3.1.0
info:
  title: Integration Service
  description: >-
    This service is responsible for all integrations and contains all
    integration information about the business.
  contact: {}
  version: '1.0'
servers:
  - url: https://api.joinworth.com/integration/api/v1
    variables: {}
  - url: http://localhost:3005/api/v1/accounting/taxStatus
    variables: {}
  - url: http://example.com
    variables: {}
  - url: http://localhost:3000/api/v1
    variables: {}
security: []
tags:
  - name: Banking
  - name: Financials
  - name: Accounting
  - name: Public Records
  - name: manual-filing
  - name: Taxation
  - name: OpenCorporates
  - name: ZoomInfo
  - name: Verification
  - name: Verification
  - name: FAQ Chatbot
  - name: Applicants
  - name: Extract Document Details
  - name: Charts / Stats
  - name: Credit Bureau (Equifax)
  - name: Insights
    description: >-
      AI Insights Assistant that can help generate an insights report.
      Additionally users can converse with a chatbot about their report.
  - name: Risk Alerts
  - name: Queue Management
  - name: Data Scrape
  - name: White Label
  - name: File Executions
  - name: Files
  - name: OCR
  - name: Customer Integration Settings
  - name: Facts
    description: >-
      Facts provide a common interface to pick the most authoritative values for
      attribues that may be sourced from different sources.


      E.g.: Which address do we surface as the primary address for a business?
      Determine that by collecting all addresses we have and returning the
      address with the highest degree of confidence.
  - name: Adverse Media
  - name: Misc
    description: ''
paths:
  /facts/business/{businessId}/bjl:
    parameters: []
    get:
      tags:
        - Facts
      summary: Bankruptcies Judgements & Liens (BJL)
      description: Retrieve bankruptcies, judgements, and liens associated with a business
      operationId: BankruptciesJudgements&Liens(BJL)
      parameters:
        - name: businessId
          in: path
          description: ''
          required: true
          style: simple
          schema:
            type: string
            examples:
              - 62fcb73a-b8b8-4e90-b843-de33ac3b9813
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Fri, 28 Feb 2025 11:44:56 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '2676'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: keep-alive
            Content-Security-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: >-
                    default-src 'self';base-uri 'self';font-src 'self' https:
                    data:;form-action 'self';frame-ancestors 'self';img-src
                    'self' data:;object-src 'none';script-src
                    'self';script-src-attr 'none';style-src 'self' https:
                    'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Opener-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Cross-Origin-Resource-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Origin-Agent-Cluster:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '?1'
            Referrer-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-referrer
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=15552000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-DNS-Prefetch-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'off'
            X-Download-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: noopen
            X-Frame-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '0'
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Origin
            Access-Control-Allow-Credentials:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'true'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: W/"a74-dx2D1mMtt2pAUoC43V3YleKQ8ys"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BJLSuccess'
                  - examples:
                      - status: success
                        message: Business BJL details fetched successfully
                        data:
                          bankruptcies:
                            name: bankruptcies
                            value:
                              count: 0
                              most_recent: null
                              most_recent_status: null
                            description: Bankruptcies associated to this business
                            source.confidence: 1
                            source.platformId: 17
                            alternatives: []
                          judgements:
                            name: judgements
                            value: null
                            alternatives: []
                          liens:
                            name: liens
                            value:
                              count: 1
                              most_recent: '2025-05-15T00:00:00.000Z'
                              most_recent_status: active
                              most_recent_amount: null
                              total_open_lien_amount: 4445
                            description: Liens associated to this business
                            source.confidence: 1
                            source.platformId: 17
                            alternatives: []
                          num_bankruptcies:
                            name: num_bankruptcies
                            value: 0
                            dependencies:
                              - bankruptcies
                            alternatives: []
                          num_judgements:
                            name: num_judgements
                            value: null
                            alternatives: []
                            dependencies:
                              - judgements
                          num_liens:
                            name: num_liens
                            value: 1
                            dependencies:
                              - liens
                            alternatives: []
                contentMediaType: application/json; charset=utf-8
              example:
                status: success
                message: Business BJL details fetched successfully
                data:
                  bankruptcies:
                    name: bankruptcies
                    value:
                      count: 0
                      most_recent: null
                      most_recent_status: null
                    description: Bankruptcies associated to this business
                    source.confidence: 1
                    source.platformId: 17
                    alternatives: []
                  judgements:
                    name: judgements
                    value: null
                    alternatives: []
                  liens:
                    name: liens
                    value:
                      count: 1
                      most_recent: '2025-05-15T00:00:00.000Z'
                      most_recent_status: active
                      most_recent_amount: null
                      total_open_lien_amount: 4445
                    description: Liens associated to this business
                    source.confidence: 1
                    source.platformId: 17
                    alternatives: []
                  num_bankruptcies:
                    name: num_bankruptcies
                    value: 0
                    dependencies:
                      - bankruptcies
                    alternatives: []
                  num_judgements:
                    name: num_judgements
                    value: null
                    alternatives: []
                    dependencies:
                      - judgements
                  num_liens:
                    name: num_liens
                    value: 1
                    dependencies:
                      - liens
                    alternatives: []
      deprecated: false
      servers:
        - url: https://api.joinworth.com/integration/api/v1
          variables: {}
components:
  schemas:
    BJLSuccess:
      title: BJLSuccess
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/BJLData'
      examples:
        - status: success
          message: Business BJL details fetched successfully
          data:
            bankruptcies:
              name: bankruptcies
              value:
                count: 0
                most_recent: null
                most_recent_status: null
              description: Bankruptcies associated to this business
              source.confidence: 1
              source.platformId: 17
              ruleApplied:
                name: factWithHighestConfidence
                description: >-
                  Get the fact with the highest confidence and weight if the
                  same confidence
              alternatives: []
            judgements:
              name: judgements
              value: null
              alternatives: []
            liens:
              name: liens
              value:
                count: 1
                most_recent: '2025-05-15T00:00:00.000Z'
                most_recent_status: active
                most_recent_amount: null
                total_open_lien_amount: 4445
              description: Liens associated to this business
              source.confidence: 1
              source.platformId: 17
              ruleApplied:
                name: factWithHighestConfidence
                description: >-
                  Get the fact with the highest confidence and weight if the
                  same confidence
              alternatives: []
            num_bankruptcies:
              name: num_bankruptcies
              value: 0
              dependencies:
                - bankruptcies
              alternatives: []
            num_judgements:
              name: num_judgements
              value: null
              alternatives: []
              dependencies:
                - judgements
            num_liens:
              name: num_liens
              value: 1
              dependencies:
                - liens
              alternatives: []
    BJLData:
      title: BJLData
      type: object
      properties:
        bankruptcies:
          $ref: '#/components/schemas/BJLDetailField'
        judgements:
          $ref: '#/components/schemas/BJLDetailField'
        liens:
          $ref: '#/components/schemas/BJLDetailField'
        num_bankruptcies:
          $ref: '#/components/schemas/BJLCountField'
        num_judgements:
          $ref: '#/components/schemas/BJLCountField'
        num_liens:
          $ref: '#/components/schemas/BJLCountField'
    BJLDetailField:
      title: BJLDetailField
      type: object
      properties:
        name:
          type: string
          description: Field name identifier
        value:
          oneOf:
            - $ref: '#/components/schemas/BankruptcyValue'
            - $ref: '#/components/schemas/JudgementValue'
            - $ref: '#/components/schemas/LienValue'
            - type: 'null'
          description: Detailed information about the BJL record
        description:
          type: string
          description: Human-readable description of the field
        source.confidence:
          type: number
          minimum: 0
          maximum: 1
          description: Confidence score of the data source
        source.platformId:
          type: integer
          description: ID of the platform providing the data
        ruleApplied:
          $ref: '#/components/schemas/RuleApplied'
        alternatives:
          type: array
          items: {}
          description: Alternative data sources or values
      required:
        - name
        - alternatives
    BJLCountField:
      title: BJLCountField
      type: object
      properties:
        name:
          type: string
          description: Field name identifier
        value:
          type:
            - integer
            - 'null'
          description: Count of records
        dependencies:
          type: array
          items:
            type: string
          description: List of fields this count depends on
        alternatives:
          type: array
          items: {}
          description: Alternative data sources or values
      required:
        - name
        - alternatives
    BankruptcyValue:
      title: BankruptcyValue
      type: object
      properties:
        count:
          type: integer
          description: Number of bankruptcy records
        most_recent:
          type:
            - string
            - 'null'
          format: date-time
          description: Date of the most recent bankruptcy
        most_recent_status:
          type:
            - string
            - 'null'
          description: Status of the most recent bankruptcy
    JudgementValue:
      title: JudgementValue
      type: object
      properties:
        count:
          type: integer
          description: Number of judgement records
        most_recent:
          type:
            - string
            - 'null'
          format: date-time
          description: Date of the most recent judgement
        most_recent_status:
          type:
            - string
            - 'null'
          description: Status of the most recent judgement
        most_recent_amount:
          type:
            - number
            - 'null'
          description: Amount of the most recent judgement
    LienValue:
      title: LienValue
      type: object
      properties:
        count:
          type: integer
          description: Number of lien records
        most_recent:
          type:
            - string
            - 'null'
          format: date-time
          description: Date of the most recent lien
        most_recent_status:
          type:
            - string
            - 'null'
          enum:
            - active
            - released
            - satisfied
            - null
          description: Status of the most recent lien
        most_recent_amount:
          type:
            - number
            - 'null'
          description: Amount of the most recent lien
        total_open_lien_amount:
          type:
            - number
            - 'null'
          description: Total amount of all open liens
    RuleApplied:
      title: RuleApplied
      type: object
      properties:
        name:
          type: string
          description: Name of the rule applied
        description:
          type: string
          description: Description of what the rule does

````