find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/entitylight:entitylight-ucc-searches-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Entitylight Ucc Searches API
  version: 1.0.0
  description: Look up a business's Secretary of State record, UCC filings and court cases, with names as filed, and watch businesses for new filings and lawsuits.
servers:
- url: https://api.entitylight.com/v1
security:
- apiKey: []
tags:
- name: Ucc Searches
paths:
  /ucc-searches:
    post:
      summary: Search UCC filings by debtor name
      description: Searches the state filing office's UCC records for the debtor (its own search site, or the data it publishes in CO and CT), keeps filings whose debtor matches the name exactly, and reads party addresses and image links for the newest 30 where the office shows them free. Counts as one lookup; a search where nothing was searched isn't charged.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UccSearchRequest'
      responses:
        '202':
          description: Started; read it again or wait for ucc_search.completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UccSearch'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: The plan has no lookups left
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Invalid fields, or a state without UCC search by debtor name
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than 60 requests a minute for this key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Ucc Searches
      operationId: postUccSearches
      x-operation-id-source: derived
  /ucc-searches/{uccSearchId}:
    get:
      summary: Get a UCC search
      parameters:
      - name: uccSearchId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: The search
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UccSearch'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No UCC search with that id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than 60 requests a minute for this key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Ucc Searches
      operationId: getUccSearchesByUccSearchId
      x-operation-id-source: derived
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                - path
                - message
                additionalProperties: false
          required:
          - code
          - message
          additionalProperties: false
      required:
      - error
      additionalProperties: false
    UccSearchRequest:
      type: object
      properties:
        debtorName:
          type: string
          minLength: 2
          maxLength: 200
          description: The debtor's legal name, as it would be filed
        state:
          description: 'Two-letter code of the state whose filing office to search: AK, AL, CO, CT, FL, ID, IL, KY, MD, MI, NC, NJ, OH, OK, OR, RI, TN, WI'
          type: string
        webhookUrl:
          description: An https URL that gets ucc_search.completed for this search instead of the organization's webhook
          type: string
          maxLength: 2048
      required:
      - debtorName
      - state
    UccSearch:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        status:
          type: string
          enum:
          - running
          - completed
        debtorName:
          type: string
          description: The debtor name searched
        state:
          type: string
          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
        createdAt:
          type: string
          description: ISO 8601
        completedAt:
          description: ISO 8601
          type:
          - string
          - 'null'
        coverage:
          type: object
          properties:
            status:
              type: string
              enum:
              - pending
              - searched
              - not_covered
              - failed
            reason:
              anyOf:
              - type: string
                enum:
                - not_found
                - ambiguous
                - too_many_results
                - not_run
                - unavailable
              - type: 'null'
              description: 'Set only when status is failed. not_found: no business is registered under that exact name in that state (see businessAlternatives). ambiguous: the name matches more than one registration, or only close ones; pick one from businessAlternatives with POST /lookups/{id}/pick. too_many_results: the court listed more cases than could be read; courtCases still holds the cases that were read, and older ones may be missing. not_run: the lookup ended before this source ran. unavailable: the source didn''t answer after retries.'
          required:
          - status
          - reason
          additionalProperties: false
          description: searched, not_covered, failed, or pending while the search runs. A failed search found nothing because nothing was searched; it never means no filings.
        filingsFound:
          anyOf:
          - type: integer
            minimum: -9007199254740991
            maximum: 9007199254740991
          - type: 'null'
          description: Filings whose debtor matches debtorName exactly, ignoring case, punctuation and legal suffixes
        totalOnSite:
          anyOf:
          - type: integer
            minimum: -9007199254740991
            maximum: 9007199254740991
          - type: 'null'
          description: The result count the filing office printed, where it prints one; it can include other debtors' filings
        truncated:
          type: boolean
          description: The filing office listed more pages than one search reads, so older filings may be missing
        uccFilings:
          type: array
          items:
            type: object
            properties:
              state:
                type: string
              filingNumber:
                type: string
              filingType:
                type:
                - string
                - 'null'
              filingDate:
                description: YYYY-MM-DD
                type:
                - string
                - 'null'
              lapseDate:
                description: YYYY-MM-DD
                type:
                - string
                - 'null'
              status:
                type:
                - string
                - 'null'
              debtorName:
                description: The debtor as filed
                type:
                - string
                - 'null'
              securedPartyName:
                type: string
              securedPartyAddress:
                type:
                - string
                - 'null'
              collateralText:
                type:
                - string
                - 'null'
              imageUrl:
                type:
                - string
                - 'null'
              sourceUrl:
                description: The filing's own page on the filing office's site, where the office gives each filing a plain link
                type:
                - string
                - 'null'
              throughRepresentative:
                type: boolean
                description: The secured party filed as a representative (a filing agent), so the actual lender isn't on the record
              debtors:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      description: As filed
                    address:
                      description: As the filing office prints it; null where its free search doesn't show addresses
                      type:
                      - string
                      - 'null'
                  required:
                  - name
                  - address
                  additionalProperties: false
                description: Every debtor on the filing, with addresses where the filing office's free search shows them
              securedParties:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      description: As filed
                    address:
                      description: As the filing office prints it; null where its free search doesn't show addresses
                      type:
                      - string
                      - 'null'
                  required:
                  - name
                  - address
                  additionalProperties: false
                description: Every secured party on the filing, with addresses where the filing office's free search shows them
            required:
            - state
            - filingNumber
            - filingType
            - filingDate
            - lapseDate
            - status
            - debtorName
            - securedPartyName
            - securedPartyAddress
            - collateralText
            - imageUrl
            - sourceUrl
            - throughRepresentative
            - debtors
            - securedParties
            additionalProperties: false
          description: Newest first. Addresses and image links are read for the newest 30
      required:
      - id
      - status
      - debtorName
      - state
      - createdAt
      - completedAt
      - coverage
      - filingsFound
      - totalOnSite
      - truncated
      - uccFilings
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer