Skip to main content
POST
Lookup Initial Filing For Amendment

Authorizations

X-API-Key
string
header
required

Body

application/json

The initial financing statement details to resolve, as they appear on the UCC-1.

state
enum<string>
required

The state abbreviation of the jurisdiction the initial financing statement is filed in.

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
Example:

"IL"

filing_number
string
required

The filing number the filing office assigned the initial financing statement (UCC-1) being amended.

Required string length: 1 - 64
Example:

"P98172"

filing_date
string<date>
required

The date the initial financing statement was filed. Cannot be in the future and cannot predate the revised UCC Article 9 effective date (2001-07-01).

Example:

"2023-04-20"

filing_name
string | null

A custom name for the filing record this lookup creates, when it creates one (only filer's reference).

Maximum string length: 128
Example:

"Acme Inc — 2023 equipment lien"

allow_unverified
boolean
default:false

When the filing cannot be found in Baselayer or the public record, whether to hold it anyway as an unverified imported filing built from the details supplied here. Off by default so an exploratory search creates nothing; set it only after the filer confirms the initial filing could not be verified.

Response

The lookup resolved (or reported not_found) without creating a record.

How the initial-filing lookup resolved, and the record a UCC-3 can now be created against via POST /lien_submissions/{filing_id}/amend.

outcome
enum<string>
required

Which kind of record the lookup resolved the initial financing statement to, or not_found when nothing matched and no unverified filing was requested.

Available options:
filed_via_baselayer,
imported,
imported_unverified,
not_found
Example:

"imported"

created
boolean
required

Whether this lookup created the returned filing record, as opposed to resolving one the organization already held.

warnings
enum<string>[]
required

Non-blocking flags about the match: a file date that disagrees with the matched filing (filing_date_mismatch), a file date past the filing's lapse date (filing_date_after_lapse_date), a filing that no longer stands (filing_not_active), or an unverified import whose filing has since appeared in the public record (public_record_available).

Non-blocking flags an initial-filing lookup raises about its match.

Available options:
filing_date_mismatch,
filing_date_after_lapse_date,
filing_not_active,
public_record_available,
secured_party_preferences_missing
filing
LienFilingSubmissionUCC1Response (v1) · object

Represents the response structure for a lien filing submission. This model includes all the details provided during the creation of a lien filing submission along with additional system-generated information such as the unique identifier, the current status of the submission, and the filing number if the lien has been recorded.