Lien filing created

{
  "filing_type": "UCC1",
  "__event__": {
    "type": "LienFiling.created",
    "origin": "api",
    "notices": null,
    "organization_id": null,
    "application_id": null,
    "external_id": null,
    "application_type": null
  },
  "reference_data": "Filing for a 1967 Ford Mustang",
  "submission_filing_name": "My Lien Filing",
  "search_to_reflect": true,
  "email_contact": "<string>",
  "real_estate_info": {
    "type": "FILE_IN_REAL_ESTATE_RECORDS",
    "covers_timber": true,
    "covers_as_extracted_collateral": true,
    "filed_as_fixture": true,
    "real_estate_record_owner": {
      "type": "ORGANIZATION",
      "mailing_address": "123 Main St",
      "city": "Springfield",
      "state": "AL",
      "postal_code": "62701",
      "organization_name": "Acme Inc"
    },
    "real_estate_description": "<string>"
  },
  "miscellaneous_info": "<string>",
  "jurisdiction_county": "<string>",
  "debtors": [
    {
      "capacity": "ESTATE",
      "city": "Springfield",
      "id": "6622b049-a93c-4748-8057-b5824fc52d0e",
      "mailing_address": "123 Main St",
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Debtor",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "secured_parties": [
    {
      "city": "Springfield",
      "id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
      "is_assignor": null,
      "mailing_address": "123 Main St",
      "masked": null,
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Secured Party",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "collateral_statements": {
    "collateral_statement_designation": null,
    "text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
    "type": "TEXT"
  },
  "principal_indebted_amount": "<string>",
  "documentary_tax_stamp_required": true,
  "assigned_business_debtor": {
    "business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
    "capacity": "ESTATE",
    "city": "Springfield",
    "id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
    "mailing_address": "123 Main St",
    "organization_name": "Acme Inc",
    "organization_type": "LLC",
    "postal_code": "62701",
    "role": "Debtor",
    "state": "IL",
    "type": "ORGANIZATION"
  },
  "assigned_debtor": {
    "type": "ORGANIZATION",
    "role": "Debtor",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "state": "AL",
    "postal_code": "62701",
    "organization_name": "Acme Inc",
    "capacity": "NONE_OF_THE_ABOVE",
    "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filing_number": "UCC1-1234567890",
  "filing_date": "2023-01-01",
  "lapse_date": "2024-04-20",
  "has_downloadable_document": false,
  "origin": "filed_via_baselayer",
  "status": "Active"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

WEBHOOK

LienFiling.created

{
  "filing_type": "UCC1",
  "__event__": {
    "type": "LienFiling.created",
    "origin": "api",
    "notices": null,
    "organization_id": null,
    "application_id": null,
    "external_id": null,
    "application_type": null
  },
  "reference_data": "Filing for a 1967 Ford Mustang",
  "submission_filing_name": "My Lien Filing",
  "search_to_reflect": true,
  "email_contact": "<string>",
  "real_estate_info": {
    "type": "FILE_IN_REAL_ESTATE_RECORDS",
    "covers_timber": true,
    "covers_as_extracted_collateral": true,
    "filed_as_fixture": true,
    "real_estate_record_owner": {
      "type": "ORGANIZATION",
      "mailing_address": "123 Main St",
      "city": "Springfield",
      "state": "AL",
      "postal_code": "62701",
      "organization_name": "Acme Inc"
    },
    "real_estate_description": "<string>"
  },
  "miscellaneous_info": "<string>",
  "jurisdiction_county": "<string>",
  "debtors": [
    {
      "capacity": "ESTATE",
      "city": "Springfield",
      "id": "6622b049-a93c-4748-8057-b5824fc52d0e",
      "mailing_address": "123 Main St",
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Debtor",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "secured_parties": [
    {
      "city": "Springfield",
      "id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
      "is_assignor": null,
      "mailing_address": "123 Main St",
      "masked": null,
      "organization_name": "Acme Inc",
      "organization_type": "COOPERATIVE",
      "postal_code": "62701",
      "role": "Secured Party",
      "state": "IL",
      "type": "ORGANIZATION"
    }
  ],
  "collateral_statements": {
    "collateral_statement_designation": null,
    "text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
    "type": "TEXT"
  },
  "principal_indebted_amount": "<string>",
  "documentary_tax_stamp_required": true,
  "assigned_business_debtor": {
    "business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
    "capacity": "ESTATE",
    "city": "Springfield",
    "id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
    "mailing_address": "123 Main St",
    "organization_name": "Acme Inc",
    "organization_type": "LLC",
    "postal_code": "62701",
    "role": "Debtor",
    "state": "IL",
    "type": "ORGANIZATION"
  },
  "assigned_debtor": {
    "type": "ORGANIZATION",
    "role": "Debtor",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "mailing_address": "123 Main St",
    "city": "Springfield",
    "state": "AL",
    "postal_code": "62701",
    "organization_name": "Acme Inc",
    "capacity": "NONE_OF_THE_ABOVE",
    "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filing_number": "UCC1-1234567890",
  "filing_date": "2023-01-01",
  "lapse_date": "2024-04-20",
  "has_downloadable_document": false,
  "origin": "filed_via_baselayer",
  "status": "Active"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Body

application/json

LienFilingCreatedWebhook_LienFilingSubmissionUCC1Response (v1)
LienFilingCreatedWebhook_LienFilingSubmissionUCC3Response (v1)
LienFilingCreatedWebhook_LienFilingSubmissionImportedResponse (v1)

filing_type

string

default:UCC1

required

Initial financing statement, which is the first filing of a lien.

Allowed value: "UCC1"

__event__

WebhookMetadata · object

Show child attributes

reference_data

string | null

Reference text that will show up in the UCC form under box 8 (OPTIONAL FILER REFERENCE DATA).

Maximum string length: 128

Example:

"Filing for a 1967 Ford Mustang"

submission_filing_name

string | null

A custom name for the filing (only filer's reference).

Maximum string length: 128

Example:

"My Lien Filing"

search_to_reflect

boolean | null

When set to true, a search will be conducted on the debtor post-filing to verify that the filing has been properly registered by the filing office.

email_contact

string | null

This email will receive all correspondence concerning this lien filing.

Maximum string length: 256

real_estate_info

LienFilingRealEstateInfo (v1) · object

This model represents the real estate record in a lien filing submission.

LienFilingRealEstateInfo (v1)
LienFilingNoRealEstateInfo (v1)

Show child attributes

miscellaneous_info

string | null

Miscellaneous information associated with the lien filing submission.

Maximum string length: 256

state

enum<string> | null

The state abbreviation for the jurisdiction where the lien is to be filed.

Available options:

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

jurisdiction_county

string | null

The county where the lien is being filed. This is typically the county where the debtor's property or collateral is located.

Maximum string length: 128

debtors

(LienFilingOrganizationDebtorPartyResponse (v1) · object | LienFilingIndividualDebtorPartyResponse (v1) · object)[] | null

An enumeration of debtors implicated in the lien filing process, excluding the assigned debtor on anchored filings. Standalone filings return every debtor in this list.

Represents the response structure for an organization acting as a debtor in a lien filing.

This model encapsulates detailed information about an organizational debtor, including its identification, contact details, and specific attributes relevant to its role in the lien. It is designed to provide a comprehensive view of the debtor's information as returned by the API in response to lien-related queries or operations.

LienFilingOrganizationDebtorPartyResponse (v1)
LienFilingIndividualDebtorPartyResponse (v1)

Show child attributes

Example:

[
  {
    "capacity": "ESTATE",
    "city": "Springfield",
    "id": "6622b049-a93c-4748-8057-b5824fc52d0e",
    "mailing_address": "123 Main St",
    "organization_name": "Acme Inc",
    "organization_type": "COOPERATIVE",
    "postal_code": "62701",
    "role": "Debtor",
    "state": "IL",
    "type": "ORGANIZATION"
  }
]

secured_parties

(LienFilingOrganizationSecuredPartyResponse (v1) · object | LienFilingIndividualSecuredPartyResponse (v1) · object)[] | null

A list of secured parties involved in the lien filing.

Represents the response structure for an organization acting as a secured party in a lien filing.

This model encapsulates detailed information about an organizational secured party, including their identification, contact details, and specific attributes relevant to their role in the lien. It is designed to provide a comprehensive view of the secured party's information as returned by the API in response to lien-related queries or operations.

LienFilingOrganizationSecuredPartyResponse (v1)
LienFilingIndividualSecuredPartyResponse (v1)

Show child attributes

Example:

[
  {
    "city": "Springfield",
    "id": "01bec728-36f8-4ba7-a6b6-4ec79c0cc35e",
    "is_assignor": null,
    "mailing_address": "123 Main St",
    "masked": null,
    "organization_name": "Acme Inc",
    "organization_type": "COOPERATIVE",
    "postal_code": "62701",
    "role": "Secured Party",
    "state": "IL",
    "type": "ORGANIZATION"
  }
]

collateral_statements

LienFilingCollateralStatementText (v1) · object

This structure represents the schema for a collateral statement in the form of text provided for a lien filing submission.

LienFilingCollateralStatementText (v1)
LienFilingCollateralStatementAttachmentsResponse (v1)

Show child attributes

Example:

{
  "collateral_statement_designation": null,
  "text": "Commercial real estate located at 123 Business Blvd, Tech City, TX",
  "type": "TEXT"
}

alternative_name_designation

enum<string> | null

Designation for the lien filing that specifies an alternativename under which the lien might be filed or recognized. This can includedesignations like agricultural liens, bailee/bailor relationships,or other specific types that affect how the lien is treated or categorized legally.

Available options:

AGLIEN,

BAILEE_BAILOR,

CONSIGNEE_CONSIGNOR,

LESSEE_LESSOR,

NON_UCC_FILING,

SELLER_BUYER,

LICENSEE,

DEBTOR_SECURED_PARTY

alternative_filing_type

enum<string> | null

Field that specifies the type of lien filing in alternativecontexts. This can include types like transmitting utility, manufactured home, public finance, or not applicable.

Available options:

TRANSMITTING_UTILITY,

MANUFACTURED_HOME,

PUBLIC_FINANCE,

NOT_APPLICABLE

principal_indebted_amount

string | null

The principal indebted amount in the lien filing submission.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$

documentary_tax_stamp_required

boolean | null

Whether a documentary tax stamp is required for the lien filing submission. When set to true all Documentary Stamps due and payable or to become due and payable pursuant, have been paid. If set to false, the lien filing submission will not require a documentary tax stamp.

tax_exempt_reason

enum<string> | null

The tax exempt reason for the lien filing submission.

Available options:

DEBTOR_COOPERATIVE_MARKETING_ASSOCIATION,

DEBTOR_CREDIT_UNION,

DEBTOR_TELEPHONE_COOPERATIVE,

GOVERNMENT_AGENCY,

JUDGEMENT_LIEN,

MUNICIPALITY,

REORGANIZATION,

SECURITIES,

STATE_AGENCY,

NOT_EXEMPT

assigned_business_debtor

LienFilingAssignedBusinessDebtorPartyResponse (v1) · object | null

deprecated

Represents the response structure for an assigned business debtor party in a lien filing.

This model includes details about the business entity acting as a debtor, such as its unique identifier, organizational information, and mailing address. It also incorporates additional response-specific fields like the party's ID.

Show child attributes

Example:

{
  "business_id": "8271b0c9-c2f6-4954-9779-a8fd9e0bb305",
  "capacity": "ESTATE",
  "city": "Springfield",
  "id": "4fe66964-32c1-4d44-b146-14ab7b461dee",
  "mailing_address": "123 Main St",
  "organization_name": "Acme Inc",
  "organization_type": "LLC",
  "postal_code": "62701",
  "role": "Debtor",
  "state": "IL",
  "type": "ORGANIZATION"
}

assigned_debtor

LienFilingAssignedBusinessDebtorPartyResponse (v1) · object

Represents the response structure for an assigned business debtor party in a lien filing.

LienFilingAssignedBusinessDebtorPartyResponse (v1)
LienFilingAssignedPersonDebtorPartyResponse (v1)

Show child attributes

string<uuid>

The unique identifier for the lien filing submission.

filing_status

enum<string>

The current state of the lien filing submission.

Available options:

Draft,

Requested,

InReview,

NeedsAttention,

Submitted,

Filed,

Cancelled

filing_number

string | null

The filing number assigned to the lien, when the lien filing has been recorded by the jurisdiction. This is a unique identifier for the lien, and is used to reference the lien in subsequent transactions.

Maximum string length: 128

Example:

"UCC1-1234567890"

filing_date

string<date> | null

The date when the lien filing was submitted to the jurisdiction.

Example:

"2023-01-01"

lapse_date

string<date> | null

The date when the lien will lapse. Assigned when the lien filing is submitted to the jurisdiction.

Example:

"2024-04-20"

has_downloadable_document

boolean

default:false

Indicates whether a downloadable document (e.g., the filed lien in PDF format) is available for this lien filing submission. This is typically true when the lien filing has been officially recorded by the jurisdiction.

origin

enum<string>

default:filed_via_baselayer

How the organization came to own this lien filing: it was filed through Baselayer, or imported by the organization from a filing that already exists in the public record.

Available options:

filed_via_baselayer,

imported

status

enum<string> | null

The lien's standing once it has been filed, derived from its lapse date under UCC §9-515 rather than read off a stored column — a filed lien whose lapse date has passed reports Lapsed here without anything having had to age it. Reads the same way as an imported filing's status. For a filing made THROUGH Baselayer both §9-515 clauses live in the filing's own UCC-3 amendments, so the field is populated only where those have been read: the initial-filing lookup (POST /lien_submissions/initial_filing_lookup). It is omitted elsewhere rather than answered from unread evidence.

Available options:

Active,

Inactive,

Lapsed,

Released,

Satisfied,

Expired,

Pending,

Contested,

Disputed,

Perfected,

Unperfected,

Void,

Invalid,

Enforcement,

Foreclosure,

Subordinated,

Avoided,

Terminated,

Draft,

InPreperation,

Unknown

Example:

"Active"

Response

Successful Response

Webhook Management

Webhook Events

Lien filing created

Body

Response