Skip to main content
GET
Retrieve a specific title entry
Returns the title entry with document paths rewritten to presigned URLs where applicable. For preview organizations, complete entries may include account_facts — crystallized yes/no judgements for title review derived from the reconciliation engine. This field is not generally available and should be treated as preview / not-GA surface.

Authorizations

Authorization
string
header
required

API key or Clerk JWT supplied as Authorization: Bearer

Path Parameters

id
string
required

Unique identifier of the title entry

Response

Successful response

website
string
required

Organization identifier

entryId
string
required

Unique identifier for this database entry

userId
string
required

User who created this entry

job_status
enum<string>
required

Processing status of the job

Available options:
pending,
input_parsing,
enriching,
generating_forms,
complete,
error
createdAt
any
required

Timestamp when this entry was created. Stored loosely by the API and may be a number, string, or date-like value.

s3Index
string
required

S3 path prefix for this entry's documents

VIN
string
required

Vehicle Identification Number (17 characters)

state
string
required

State where the vehicle is titled/registered

Borrower
string
required

Primary borrower name on the loan

attachment
object[]
required

User-uploaded documents like driver licenses, vehicle titles, etc.

loanData
object
required

Legacy loan data field (can be any type or AccountData)

account_data
object
required
account_status
enum<string>
required

Account status to determine workflows (scrapers, etc.)

Available options:
originated,
poa_sent,
poa_signed,
filing_en_route,
filing_received,
lien_delay,
lien_error,
lien_filed,
lien_perfected,
account_paid,
lien_release_pending,
lien_release_complete
lenderLoanId
string
required

Lender's internal loan/account number

tracking_url_provider
string
required

Service provider for shipping tracking (if applicable)

webhook_events
string[]

Only exists on sent webhooks to help users quickly parse specific fields

user_email
string

Email of the user who created this entry

processingStartTime
number

Epoch timestamp when processing started

groupId
string

User group ID for organizational access control

last_modified
number

Timestamp when this entry was last modified

processingTimeMs
number

Total processing duration in milliseconds

existingEntryId
string

If this is a duplicate entry, points to the original entry ID

bdaJobs
object

Background document analysis job statuses

private_enrichment_pending
boolean

Whether a private enrichment job has been enqueued and is still pending

lmsData
object

Loan management system data

is_elt
boolean

Whether this account uses Electronic Lien & Title system

elt_data
object
form_statement_of_fact
string

S3 path to the Statement of Fact form PDF

form_lien_add
string

S3 path to the Add Lien form PDF

form_title_application
string

S3 path to the Title Application form PDF

form_duplicate_title
string

S3 path to the Duplicate Title request form PDF

form_repo_affidavit
string

S3 path to the Repossession Affidavit PDF

form_lien_release_letter
string

S3 path to the Lien Release Letter PDF

forms_poa
object[]

Array of Power of Attorney forms

form_payoff_authorization
string

S3 path to the Payoff Authorization form PDF

form_letter_of_guarantee
string

S3 path to the Letter of Guarantee PDF

form_final_packet
string

S3 path to the Final Packet PDF (contains all generated forms combined)

form_title_delivery
string

S3 path to the title delivery form PDF

form_ucc1
string

S3 path to the UCC-1 form PDF

final_packet_indices
string

Page indices showing which forms appear on which pages of the final packet

form_instructions
string

S3 path to the Instructions PDF

form_ohv_declaration
string

S3 path to the Off-Highway Vehicle Declaration PDF

form_odometer_disclosure
string

S3 path to the Odometer Disclosure form PDF

form_addr_oats
string

S3 path to the Address OATS form PDF

form_vin_verification
string

S3 path to the VIN Verification form PDF

form_low_speed_affidavit
string

S3 path to the Low Speed Vehicle Affidavit PDF

forms_name_oats
object[]

Array of Name OATS forms

forms_non_obligor
object[]

Array of Non-Obligor forms

form_updates
object

Mapping of DynamoDBEntry.form* key to s3 metadata.json file containing overview of form updates

form_downloads
object

Mapping of DynamoDBEntry.form* key to download count

forms_status
enum<string>

Latest form generation status for this title entry

Available options:
generated,
skipped_no_data,
skipped_no_spec,
skipped_no_state,
error
nmvtis_txn_id
string

Transaction ID for NMVTIS vehicle history report

nmvtis_pull
string

S3 URL to JSON file containing the NMVTIS pull results as AccountData

nmvtis_found_status
enum<string>

NMVTIS pull status: 'found' (record exists), 'not_found' (no record), 'error' (CG failure, retry), 'unavailable' (source down)

Available options:
pending,
found,
not_found,
error,
unavailable,
skipped
nmvtis_report_pdf
string

S3 path to the NMVTIS vehicle history report PDF

nmvtis_last_fetch
string

Timestamp of last NMVTIS data fetch

state_txn_id
string

Transaction ID for state DMV data pull (Yassi, DMV123, or internal)

state_pull
string

S3 URL to JSON file containing the state DMV pull results as AccountData

state_found_status
enum<string>

State DMV pull status: 'found' (record exists), 'not_found' (no record), 'error' (CG failure, retry), 'unavailable' (source down)

Available options:
pending,
found,
not_found,
error,
unavailable,
skipped
state_report_pdf
string

S3 path to the state DMV report PDF

state_last_fetch
string

Timestamp of last state DMV data fetch

portal_screenshot
string

S3 path to a screenshot of the DMV portal showing current vehicle status

portal_pull
string

S3 URL to JSON file containing the DMV portal pull results as AccountData

portal_found_status
enum<string>

DMV portal pull status: 'found' (record exists), 'not_found' (no record), 'error' (CG failure, retry), 'unavailable' (portal down)

Available options:
pending,
found,
not_found,
error,
unavailable,
skipped
portal_last_fetch
string

Timestamp of last DMV portal data fetch

public_pull
string

S3 URL to JSON file containing public enrichment results as AccountData

public_report_pdf
string

S3 path to the public enrichment report PDF

public_found_status
enum<string>

Public enrichment pull status

Available options:
pending,
found,
not_found,
error,
unavailable,
skipped
public_txn_id
string

Transaction ID for public enrichment

public_last_fetch
string

Timestamp of last public enrichment data fetch

sftp_exported_at
number

Epoch timestamp when this entry was exported over SFTP

insurance_last_fetch
string<date-time>

Timestamp of last insurance data fetch

insurance_search_raw_data
object

Raw insurance search data

insurance_search_result
string

Insurance search result status

insurance_update_result
string

Insurance update result status

signature_requests
object[]

Electronic signature requests including signed documents, certificates, and collected driver licenses

fee_estimate
object
submission_id
string

Submission workflow identifier associated with this title entry

account_discrepancies
object
deprecated

Deprecated. Discrepancies found between different data sources (document uploads, NMVTIS, state portals, etc.) for this account. Each discrepancy shows field path and conflicting values with their sources.

account_matches
object
deprecated

Deprecated. Fields where multiple data sources agree on the same value, providing validation confidence for critical data points like title numbers, dates, etc.

account_facts
object

Preview / not-GA. Crystallized yes/no judgements for title review, derived from the reconcile engine. Returned only for eligible preview organizations when job_status is complete.

Example:
enrichment_slack_channel_id
string

Slack channel ID for the enrichment thread

enrichment_slack_message_ts
string

Slack message timestamp for the enrichment thread

enrichment_slack_thread_started_at
number

Epoch timestamp when the enrichment Slack thread was started