Federal Litigation Check
Federal civil cases naming a company or person, with court, status and outcome.
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"}'{
"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>requiredYour 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.
partystringrequiredParty name. Example: Northwind Logistics Inc
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour 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.
successbooleantrue when the lookup ran.
data.case_countnumberHow many federal civil cases in our coverage name the party.
data.cases[].case_namevalueThe caption of the case, showing who is suing whom.
data.cases[].courtvalueThe federal court where the case was filed.
data.cases[].case_numbervalueThe docket number you need to pull the full record from the court.
data.cases[].nature_of_suitvalueThe federal category for the dispute, such as contract, employment or patent.
data.cases[].filed_datevalueThe date the case was opened.
data.cases[].statusvalueopen or closed, with a termination date for closed cases.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote 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.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 403 | approval_required | This product has not been switched on for your account yet. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An 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