Entitylight · Schema

UccSearch

CompanyBusinessAPIUCCLitigationMonitoring

Properties

Name Type Description
id string
status string
debtorName string The debtor name searched
state string
createdAt string ISO 8601
completedAt stringnull ISO 8601
coverage object 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 object Filings whose debtor matches debtorName exactly, ignoring case, punctuation and legal suffixes
totalOnSite object The result count the filing office printed, where it prints one; it can include other debtors' filings
truncated boolean The filing office listed more pages than one search reads, so older filings may be missing
uccFilings array Newest first. Addresses and image links are read for the newest 30
View JSON Schema on GitHub

JSON Schema

entitylight-ucc-search-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/entitylight/json-schema/entitylight-ucc-search-schema.json",
  "title": "UccSearch",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/entitylight-openapi.json#/components/schemas/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
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/entitylight-ucc-search"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.

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