Interface V1Service
-
- All Implemented Interfaces:
public interface V1ServiceLegal research tools including citation verification
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public interfaceV1Service.WithRawResponseA view of V1Service that provides access to raw HTTP responses for each method.
-
Method Summary
Modifier and Type Method Description abstract V1Service.WithRawResponsewithRawResponse()Returns a view of this service that provides access to raw HTTP responses for each method. abstract V1ServicewithOptions(Consumer<ClientOptions.Builder> modifier)Returns a view of this service with the given option modifications applied. V1DocketResponsedocket(V1DocketParams params)Search federal court dockets or retrieve a specific docket with optional filing entries via CourtListener RECAP data. abstract V1DocketResponsedocket(V1DocketParams params, RequestOptions requestOptions)V1FindResponsefind(V1FindParams params)Search for legal sources including cases, statutes, and regulations from authoritative legal databases. abstract V1FindResponsefind(V1FindParams params, RequestOptions requestOptions)V1GetCitationsResponsegetCitations(V1GetCitationsParams params)Parses legal citations from text and returns structured Bluebook components (case name, reporter, volume, page, year, court). abstract V1GetCitationsResponsegetCitations(V1GetCitationsParams params, RequestOptions requestOptions)V1GetCitationsFromUrlResponsegetCitationsFromUrl(V1GetCitationsFromUrlParams params)Extract all legal citations and references from a document URL. abstract V1GetCitationsFromUrlResponsegetCitationsFromUrl(V1GetCitationsFromUrlParams params, RequestOptions requestOptions)V1GetFullTextResponsegetFullText(V1GetFullTextParams params)Retrieve the full text content of a legal document. abstract V1GetFullTextResponsegetFullText(V1GetFullTextParams params, RequestOptions requestOptions)V1ListCourtsResponselistCourts()Returns CourtListener court IDs and names for docket filtering. abstract V1ListCourtsResponselistCourts(V1ListCourtsParams params, RequestOptions requestOptions)V1ListCourtsResponselistCourts(V1ListCourtsParams params)V1ListCourtsResponselistCourts(RequestOptions requestOptions)V1ListJurisdictionsResponselistJurisdictions(V1ListJurisdictionsParams params)Search for a jurisdiction by name. abstract V1ListJurisdictionsResponselistJurisdictions(V1ListJurisdictionsParams params, RequestOptions requestOptions)V1PatentSearchResponsepatentSearch(V1PatentSearchParams params)Search the USPTO Open Data Portal for US patent applications and granted patents. abstract V1PatentSearchResponsepatentSearch(V1PatentSearchParams params, RequestOptions requestOptions)V1ResearchResponseresearch(V1ResearchParams params)Perform comprehensive legal research with multiple query variations. abstract V1ResearchResponseresearch(V1ResearchParams params, RequestOptions requestOptions)V1SimilarResponsesimilar(V1SimilarParams params)Find cases and documents similar to a given legal source. abstract V1SimilarResponsesimilar(V1SimilarParams params, RequestOptions requestOptions)V1TrademarkSearchResponsetrademarkSearch()Look up trademark status and details from the USPTO Trademark Status & Document Retrieval (TSDR) system. abstract V1TrademarkSearchResponsetrademarkSearch(V1TrademarkSearchParams params, RequestOptions requestOptions)V1TrademarkSearchResponsetrademarkSearch(V1TrademarkSearchParams params)V1TrademarkSearchResponsetrademarkSearch(RequestOptions requestOptions)V1VerifyResponseverify(V1VerifyParams params)Validates legal citations against authoritative case law sources (CourtListener database of ~10M cases). abstract V1VerifyResponseverify(V1VerifyParams params, RequestOptions requestOptions)-
-
Method Detail
-
withRawResponse
abstract V1Service.WithRawResponse withRawResponse()
Returns a view of this service that provides access to raw HTTP responses for each method.
-
withOptions
abstract V1Service withOptions(Consumer<ClientOptions.Builder> modifier)
Returns a view of this service with the given option modifications applied.
The original service is not modified.
-
docket
V1DocketResponse docket(V1DocketParams params)
Search federal court dockets or retrieve a specific docket with optional filing entries via CourtListener RECAP data.
-
docket
abstract V1DocketResponse docket(V1DocketParams params, RequestOptions requestOptions)
-
find
V1FindResponse find(V1FindParams params)
Search for legal sources including cases, statutes, and regulations from authoritative legal databases. Returns ranked candidates. Always verify with legal.verify() before citing.
-
find
abstract V1FindResponse find(V1FindParams params, RequestOptions requestOptions)
-
getCitations
V1GetCitationsResponse getCitations(V1GetCitationsParams params)
Parses legal citations from text and returns structured Bluebook components (case name, reporter, volume, page, year, court). Accepts either a single citation or a full text block.
-
getCitations
abstract V1GetCitationsResponse getCitations(V1GetCitationsParams params, RequestOptions requestOptions)
-
getCitationsFromUrl
V1GetCitationsFromUrlResponse getCitationsFromUrl(V1GetCitationsFromUrlParams params)
Extract all legal citations and references from a document URL. Returns structured citation data including case citations, statute references, and regulatory citations.
-
getCitationsFromUrl
abstract V1GetCitationsFromUrlResponse getCitationsFromUrl(V1GetCitationsFromUrlParams params, RequestOptions requestOptions)
-
getFullText
V1GetFullTextResponse getFullText(V1GetFullTextParams params)
Retrieve the full text content of a legal document. Use after verifying the source with legal.verify(). Returns complete text with optional highlights and AI summary.
-
getFullText
abstract V1GetFullTextResponse getFullText(V1GetFullTextParams params, RequestOptions requestOptions)
-
listCourts
V1ListCourtsResponse listCourts()
Returns CourtListener court IDs and names for docket filtering. Use these IDs in legal.docket() as the court parameter.
-
listCourts
abstract V1ListCourtsResponse listCourts(V1ListCourtsParams params, RequestOptions requestOptions)
-
listCourts
V1ListCourtsResponse listCourts(V1ListCourtsParams params)
-
listCourts
V1ListCourtsResponse listCourts(RequestOptions requestOptions)
-
listJurisdictions
V1ListJurisdictionsResponse listJurisdictions(V1ListJurisdictionsParams params)
Search for a jurisdiction by name. Returns matching jurisdictions with their IDs for use in legal.find() and other legal research endpoints.
-
listJurisdictions
abstract V1ListJurisdictionsResponse listJurisdictions(V1ListJurisdictionsParams params, RequestOptions requestOptions)
-
patentSearch
V1PatentSearchResponse patentSearch(V1PatentSearchParams params)
Search the USPTO Open Data Portal for US patent applications and granted patents. Supports free-text queries, field-specific search, filters by assignee/inventor/status/type, date ranges, and pagination. Covers applications filed on or after January 1, 2001. Data is refreshed daily.
-
patentSearch
abstract V1PatentSearchResponse patentSearch(V1PatentSearchParams params, RequestOptions requestOptions)
-
research
V1ResearchResponse research(V1ResearchParams params)
Perform comprehensive legal research with multiple query variations. Uses advanced deep search to find relevant sources across different phrasings of the legal issue.
-
research
abstract V1ResearchResponse research(V1ResearchParams params, RequestOptions requestOptions)
-
similar
V1SimilarResponse similar(V1SimilarParams params)
Find cases and documents similar to a given legal source. Useful for finding citing cases, related precedents, or similar statutes.
-
similar
abstract V1SimilarResponse similar(V1SimilarParams params, RequestOptions requestOptions)
-
trademarkSearch
V1TrademarkSearchResponse trademarkSearch()
Look up trademark status and details from the USPTO Trademark Status & Document Retrieval (TSDR) system. Supports lookup by serial number or registration number. Returns mark text, status, owner, goods/services, Nice classification, filing/registration dates, and more.
-
trademarkSearch
abstract V1TrademarkSearchResponse trademarkSearch(V1TrademarkSearchParams params, RequestOptions requestOptions)
-
trademarkSearch
V1TrademarkSearchResponse trademarkSearch(V1TrademarkSearchParams params)
-
trademarkSearch
V1TrademarkSearchResponse trademarkSearch(RequestOptions requestOptions)
-
verify
V1VerifyResponse verify(V1VerifyParams params)
Validates legal citations against authoritative case law sources (CourtListener database of ~10M cases). Returns verification status and case metadata for each citation found in the input text. Accepts either a single citation or a full text block containing multiple citations.
-
verify
abstract V1VerifyResponse verify(V1VerifyParams params, RequestOptions requestOptions)
-
-
-
-