Research legal records

Middesk supports additional risk assessment by pulling legal records for a business or person:

  • Litigations (legal cases)
  • Bankruptcy filings
  • People criminal history

Separately or combined, these records help identify potential legal risks, assess reputation, and make informed decisions about business relationships.

Legal record searches are available as add-ons within the Business Verification solution. A Verify report is required to order legal records. These products can be ordered simultaneously or after a Verify order as add-ons.

Searching for litigations

Middesk’s Litigations product enables you to access court case records associated with businesses and individuals.

Middesk searches for various types of court cases, including:

  • Civil litigation, contract disputes, business disputes, and other civil matters
  • Debt collection cases, actions to recover unpaid debts
  • Commercial disputes, business-to-business legal conflicts
  • Other case types, additional legal proceedings as available in public records

How to retrieve litigations

Retrieving litigations requires that you first create a business, then request an order for that business.

  • For business litigations, request a litigations order
  • For associated people litigations, request a people_litigations order

You can do this in the Dashboard or the API.

For people litigations, you can filter the types of cases returned by configuring your account settings in the Dashboard. This helps you focus on relevant case types for your use case.

Understand litigation results

The litigations response contains detailed information about each court case found associated with the business or person.

Litigation object structure

Each litigation object includes the following key attributes:

FieldTypeDescription
idstringUnique litigation identifier assigned by Middesk
case_namestringThe official name of the court case
case_numberstringThe case identifier assigned by the court
case_statusstringCurrent status: Open, Closed, or Unknown
case_typestringCategory of the case (for example, Debt Collection, Unknown)
filing_datestringThe date when the case was filed
judgmentarrayDocket entries with dates and text descriptions
jurisdictionsstringThe location where the case was filed
party_typestringThe role of the entity: Plaintiff, Defendant, Petitioner, and so on
Example litigation response
1{
2 "object": "list",
3 "data": [
4 {
5 "id": "litigation_00000000000000000000000000",
6 "case_name": "First National Bank v. Example Business Inc",
7 "case_number": "2023-CV-12345",
8 "case_status": "Open",
9 "case_type": "Debt Collection",
10 "filing_date": "2023-06-15",
11 "judgment": [
12 {
13 "entry_date": "2023-06-15",
14 "text": "Complaint filed by plaintiff"
15 },
16 {
17 "entry_date": "2023-07-20",
18 "text": "Answer filed by defendant"
19 }
20 ],
21 "jurisdictions": "San Francisco County Superior Court, CA",
22 "party_type": "Defendant"
23 }
24 ]
25}

How to order litigations

Litigation searches require a completed Verify order. You can order both together as a bundle or sequentially.

Order verify and litigations together in a single request.

1

Create a business

$curl -X POST https://api.middesk.com/v1/businesses \
> -H "Authorization: Bearer YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "name": "Acme Corporation",
> "addresses": [
> {
> "address_line1": "123 Main Street",
> "city": "San Francisco",
> "state": "CA",
> "postal_code": "94105"
> }
> ],
> "orders": [
> { "product": "business_verification_verify" },
> { "product": "litigations" }
> ]
> }'
2

Wait for verification to complete

Wait for the business.updated webhook indicating the business status is in_review. Check the litigations review task for search results.

How to order people litigations

People litigation searches require a completed Verify order. You can order both together as a bundle or sequentially.

Order verify and people litigations together in a single request.

1

Create a business

$curl -X POST https://api.middesk.com/v1/businesses \
> -H "Authorization: Bearer YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "name": "Acme Corporation",
> "addresses": [
> {
> "address_line1": "123 Main Street",
> "city": "San Francisco",
> "state": "CA",
> "postal_code": "94105"
> }
> ],
> "people": [
> {
> "name": "Jane Smith"
> }
> ],
> "orders": [
> { "product": "business_verification_verify" },
> { "product": "people_litigations" }
> ]
> }'
2

Wait for verification to complete

Wait for the business.updated webhook indicating the business status is in_review. Check people review tasks for search results.

Finding bankruptcies

Reviewing and monitoring bankruptcies can help determine the level of financial risk that is being taken on when onboarding and lending to businesses.

Finding bankruptcies requires that you first create a business, then request an order for that business.

  • For business bankruptcies, request a bankruptcies order
  • For associated people bankruptcies, request a people_bankruptcies order

You can do this in the Dashboard or the API.

If Middesk finds bankruptcies, the resulting details include:

  • Debtor, the individual or entity that owes money to another party.
  • Trustee, the individual responsible for the bankruptcy and all case proceedings
  • Court, the court in which the hearing takes place, including the office number, district, and case number.
  • Chapter, the chapter in the collection of types of court cases that Bankruptcy falls into.
  • Updates, a sequence of events for the case; it includes a description of the update, a reference to the update, and the event date.

A people bankruptcies order searches for bankruptcies associated with all people on the business with the required information.

How to order bankruptcies

Bankruptcy searches require a completed Verify order. You can order both together as a bundle or sequentially.

Order verify and bankruptcies together in a single request.

1

Create a business

$curl -X POST https://api.middesk.com/v1/businesses \
> -H "Authorization: Bearer YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "name": "Acme Corporation",
> "addresses": [
> {
> "address_line1": "123 Main Street",
> "city": "San Francisco",
> "state": "CA",
> "postal_code": "94105"
> }
> ],
> "orders": [
> { "product": "business_verification_verify" },
> { "product": "bankruptcies" }
> ]
> }'
2

Wait for verification to complete

Wait for the business.updated webhook indicating the business status is in_review. Check the bankruptcies review task for search results.

How to order people bankruptcies

People bankruptcy searches require a completed Verify order. You can order both together as a bundle or sequentially.

Order verify and people bankruptcies together in a single request.

1

Create a business

$curl -X POST https://api.middesk.com/v1/businesses \
> -H "Authorization: Bearer YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "name": "Acme Corporation",
> "addresses": [
> {
> "address_line1": "123 Main Street",
> "city": "San Francisco",
> "state": "CA",
> "postal_code": "94105"
> }
> ],
> "people": [
> {
> "name": "Jane Smith"
> }
> ],
> "orders": [
> { "product": "business_verification_verify" },
> { "product": "people_bankruptcies" }
> ]
> }'
2

Wait for verification to complete

Wait for the business.updated webhook indicating the business status is in_review. Check people review tasks for search results.

Looking for criminal history

A third type of legal record Middesk can pull is an individual’s criminal history. Request a people_criminal_history order on a business to trigger a search for criminal records associated with the submitted people on the business.

Once completed, the Person object includes a criminal_records array of details.

Understanding criminal records

The criminal records response contains detailed information about each criminal record found associated with the person.

Criminal records object structure

Each criminal record object includes the following key attributes:

FieldTypeDescription
criminal_records[].idstringThe criminal record id, assigned by Middesk
criminal_records[].categorystringThe category of the criminal record (e.g., Criminal/traffic)
criminal_records[].person.dobdateThe DOB on the criminal record
criminal_records[].cases[].arrest_datedateArrest date
criminal_records[].cases[].arresting_agencystringArresting agency
criminal_records[].cases[].case_numberstringThe case number for the criminal case
criminal_records[].cases[].case_typestringThe case type
criminal_records[].cases[].court_countystringThe court county of the case
criminal_records[].cases[].court_namestringThe court name
criminal_records[].cases[].file_datestringThe date when the case was filed
criminal_records[].cases[].statusstringCase status
criminal_records[].cases[].charges[].categorystringThe category of the charge
criminal_records[].cases[].charges[].charge_typestringThe type of the charge (e.g., Misdemeanor, Felony)
criminal_records[].cases[].charges[].citystringThe city where the charge occurred
criminal_records[].cases[].charges[].countystringThe county where the charge occurred
criminal_records[].cases[].charges[].descriptionstringDescription of the charge
criminal_records[].cases[].charges[].dispositionsarrayDispositions associated with the charge
criminal_records[].cases[].charges[].legal_codestringLegal code of the charge
criminal_records[].cases[].charges[].offense_datedateThe date of the offense
criminal_records[].cases[].charges[].sentencesarraySentences associated with the charge
criminal_records[].cases[].charges[].statestringThe state that the charge was filed in
criminal_records[].cases[].charges[].subcategorystringSubcategory of the charge
criminal_records[].cases[].charges[].subsubcategorystringSubsubcategory of the charge

Review tasks

Legal record searches generate review tasks that summarize findings. These tasks appear in the Business object’s review.tasks array.

bankruptcies review task

Identify bankruptcy filings associated with the business.

statuslabelsub_label
SuccessThe business has no bankruptcy filingsNone Found
FailureThe business has bankruptcy filing(s)Found

litigations review task

Identify litigation records associated with the business.

statuslabelsub_label
SuccessThe business has no related litigationsNone Found
FailureThe business has related litigation(s)Found

For people-related legal review tasks (people_bankruptcies, people_litigations, people_criminal_history), see People verification review tasks.

Get a demo
Contact your account manager or contact sales to inquire about access.