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. abstract V1DocketResponsedocket(V1DocketParams params, RequestOptions requestOptions)V1DraftResponsedraft(V1DraftParams params)Generate a legal document with structured inputs. abstract V1DraftResponsedraft(V1DraftParams 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 court IDs (slugs) and names for use with the docket search endpoint. 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)V1SecFilingResponsesecFiling(V1SecFilingParams params)Search SEC EDGAR full-text filings via efts.sec.gov or fetch a filer's structured filing history via data.sec.gov. abstract V1SecFilingResponsesecFiling(V1SecFilingParams 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. Use legal.listCourts() to resolve court slugs for filtering.
-
docket
abstract V1DocketResponse docket(V1DocketParams params, RequestOptions requestOptions)
-
draft
V1DraftResponse draft(V1DraftParams params)
Generate a legal document with structured inputs. Powered by an agent that handles research, formatting, citation verification, and vault upload. Returns a run ID for polling.
-
draft
abstract V1DraftResponse draft(V1DraftParams 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 court IDs (slugs) and names for use with the docket search endpoint. Use the returned court ID as the
courtparameter in legal.docket().
-
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)
-
secFiling
V1SecFilingResponse secFiling(V1SecFilingParams params)
Search SEC EDGAR full-text filings via efts.sec.gov or fetch a filer's structured filing history via data.sec.gov. Returns direct SEC archive URLs with filing metadata and match snippets when available.
-
secFiling
abstract V1SecFilingResponse secFiling(V1SecFilingParams 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)
-
-
-
-