curl -X POST https://win.oneshotagent.com/v1/tools/find/record-court-cases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-court-cases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}),
});
const result = await agent.tool('find/record-court-cases', {
query: 'patent',
court: 'cafc',
case_name: 'Merck',
docket_number: '23-1027',
filed_after: '2025-01-01',
filed_before: '2025-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_court_cases_find",
"result": {
"total": 1,
"total_is_approximate": false,
"cases": [
{
"case_name": "Cqv Co., Ltd. v. Merck Patent Gmbh",
"court": "Court of Appeals for the Federal Circuit",
"date": "2025-03-10",
"citation": "130 F.4th 1344",
"docket_number": "23-1027",
"excerpt": "Case: 23-1027 Document: 77 Page: 1 Filed: 03/10/2025 United States Court of Appeals for the Federal Circuit ______________________ CQV CO., LTD., Appellant v. MERCK PATENT GMBH, Appellee ______________________ 2023-1027 ______________________ Appeal from the United States Patent an",
"url": "https://www.courtlistener.com/opinion/10353022/cqv-co-ltd-v-merck-patent-gmbh/"
}
]
},
"evidence": {
"source": "US federal and state courts (public court records)",
"source_kind": "public",
"retrieved_at": "2026-10-14T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Court Cases
Find court decisions and dockets by search words, court, date, case name or docket number.
POST
/
v1
/
tools
/
find
/
record-court-cases
curl -X POST https://win.oneshotagent.com/v1/tools/find/record-court-cases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-court-cases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}),
});
const result = await agent.tool('find/record-court-cases', {
query: 'patent',
court: 'cafc',
case_name: 'Merck',
docket_number: '23-1027',
filed_after: '2025-01-01',
filed_before: '2025-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_court_cases_find",
"result": {
"total": 1,
"total_is_approximate": false,
"cases": [
{
"case_name": "Cqv Co., Ltd. v. Merck Patent Gmbh",
"court": "Court of Appeals for the Federal Circuit",
"date": "2025-03-10",
"citation": "130 F.4th 1344",
"docket_number": "23-1027",
"excerpt": "Case: 23-1027 Document: 77 Page: 1 Filed: 03/10/2025 United States Court of Appeals for the Federal Circuit ______________________ CQV CO., LTD., Appellant v. MERCK PATENT GMBH, Appellee ______________________ 2023-1027 ______________________ Appeal from the United States Patent an",
"url": "https://www.courtlistener.com/opinion/10353022/cqv-co-ltd-v-merck-patent-gmbh/"
}
]
},
"evidence": {
"source": "US federal and state courts (public court records)",
"source_kind": "public",
"retrieved_at": "2026-10-14T12:00:00.000Z",
"as_of": null
}
}
}
Search a public archive of published US federal and state court opinions, or choose kind=dockets to search federal cases and their filings. Returns case names, courts, filing dates, citations when available, docket numbers, short excerpts and links, ordered by relevance. For opinions, the filing date is the decision date; for dockets, it is when the case was filed. Coverage varies by court and does not include every case or filing. Only the first page is read, with at most limit matches returned. Docket totals above 2,000 are approximate, with up to 6% error. An excerpt is the start of an opinion or a matching filing, at most 500 characters; it is not a case summary. Open the URL for the source record. The source’s terms prohibit using this data for credit, insurance, employment, housing or other eligibility decisions covered by the Fair Credit Reporting Act.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Search words, with quotes for an exact phrase and AND, OR or NOT between terms, for example patent. 1 to 500 characters.
string
opinions searches published federal and state decisions; dockets searches federal cases and their filings. Default opinions. One of
opinions, dockets. Defaults to "opinions".string
Only this court, by its short court ID, for example scotus, cafc or txed.
string
Only cases filed on or after this date, YYYY-MM-DD; for opinions, this is the decision date.
string
Only cases filed on or before this date, YYYY-MM-DD; for opinions, this is the decision date.
string
Search within case names, for example Merck. 1 to 200 characters.
string
Search within docket numbers, for example 23-1027. 1 to 100 characters.
integer
The most matches to return from the first page, from 1 to 20. Default 10. From 1 to 20. Defaults to
10.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
record_court_cases_findobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US federal and state courts (public court records).string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
integer
Matching cases, including those beyond limit; docket counts above 2,000 are approximate.
boolean
True for docket counts above 2,000, which may differ by up to 6%.
object[]
Matching cases in relevance order.
string
The case name.
string
The court name, or null if absent.
string
Decision date for opinions, case filing date for dockets, YYYY-MM-DD; null if absent.
string
Citations joined with semicolons, or null if absent.
string
The docket number, or null if absent.
string
Up to 500 characters from an opinion or matching filing, or null if unavailable.
string
The opinion or docket at its source, or null if unavailable.
curl -X POST https://win.oneshotagent.com/v1/tools/find/record-court-cases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-court-cases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "patent",
"court": "cafc",
"case_name": "Merck",
"docket_number": "23-1027",
"filed_after": "2025-01-01",
"filed_before": "2025-12-31",
"limit": 1
}),
});
const result = await agent.tool('find/record-court-cases', {
query: 'patent',
court: 'cafc',
case_name: 'Merck',
docket_number: '23-1027',
filed_after: '2025-01-01',
filed_before: '2025-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_court_cases_find",
"result": {
"total": 1,
"total_is_approximate": false,
"cases": [
{
"case_name": "Cqv Co., Ltd. v. Merck Patent Gmbh",
"court": "Court of Appeals for the Federal Circuit",
"date": "2025-03-10",
"citation": "130 F.4th 1344",
"docket_number": "23-1027",
"excerpt": "Case: 23-1027 Document: 77 Page: 1 Filed: 03/10/2025 United States Court of Appeals for the Federal Circuit ______________________ CQV CO., LTD., Appellant v. MERCK PATENT GMBH, Appellee ______________________ 2023-1027 ______________________ Appeal from the United States Patent an",
"url": "https://www.courtlistener.com/opinion/10353022/cqv-co-ltd-v-merck-patent-gmbh/"
}
]
},
"evidence": {
"source": "US federal and state courts (public court records)",
"source_kind": "public",
"retrieved_at": "2026-10-14T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.01 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}