Skip to content
Compliance & Registries

Federal Litigation Check

Federal civil cases naming a company or person, with court, status and outcome.

POST/v1/federal-litigation-check
2 credits / checkBulk supportedApprovalUS federal courts
Request
curl -X POST https://api.1lookup.dev/v1/federal-litigation-check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"party":"Northwind Logistics Inc"}'
Response
{
  "success": true,
  "data": {
    "party": "Northwind Logistics Inc",
    "case_count": 2,
    "open_count": 1,
    "cases": [
      {
        "case_name": "Contoso Roasters LLC v. Northwind Logistics Inc",
        "court": "U.S. District Court, Western District of Texas",
        "case_number": "1:25-cv-00142",
        "nature_of_suit": "190 Other Contract",
        "filed_date": "2025-02-11",
        "status": "open",
        "terminated_date": null
      },
      {
        "case_name": "Bell v. Northwind Logistics Inc",
        "court": "U.S. District Court, Northern District of Illinois",
        "case_number": "1:22-cv-03318",
        "nature_of_suit": "710 Fair Labor Standards Act",
        "filed_date": "2022-06-24",
        "status": "closed",
        "terminated_date": "2023-09-05"
      }
    ],
    "coverage": "partial"
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

partystringrequired

Party name. Example: Northwind Logistics Inc

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.case_countnumber

How many federal civil cases in our coverage name the party.

data.cases[].case_namevalue

The caption of the case, showing who is suing whom.

data.cases[].courtvalue

The federal court where the case was filed.

data.cases[].case_numbervalue

The docket number you need to pull the full record from the court.

data.cases[].nature_of_suitvalue

The federal category for the dispute, such as contract, employment or patent.

data.cases[].filed_datevalue

The date the case was opened.

data.cases[].statusvalue

open or closed, with a termination date for closed cases.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
403approval_requiredThis product has not been switched on for your account yet.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

2 credits / check. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge. This product needs approval before it is enabled on your account.

Product overview and use cases