Skip to main content

Download client for legal opinions

Project description

A Python library for downloading and researching legal opinions using the Caselaw Access Project API.

An Ethical Open Source Project Test Coverage Percentage GitHub Actions Workflow Documentation Status


In this example, Justopinion is used to download the decision with the citation 1 Breese 34.

>>> import os
>>> from justopinion import CAPClient
>>> client = CAPClient(api_token=os.getenv("YOUR_SECRET_API_TOKEN"))
>>> thornton = client.read_cite("1 Breese 34", full_case=True)
'John Thornton and others, Appellants, v. George Smiley and John Bradshaw, Appellees.'

You can also use Justopinion to locate text in an opinion:

>>> thornton.opinions[0].locate_text("The court knows of no power in the administrator")
TextPositionSet{TextPositionSelector[22, 70)}

Or to get the text from a specified location in the opinion:

>>> selection = thornton.opinions[0].select_text([(258, 294), (312, 359)])
>>> str(selection)
'…The note was made to West alone, and…the suit should have been commenced in his name…'

And you can use Justopinion to follow citations in an opinion and download the cited cases:

>>> str(thornton.cites_to[0])
'Citation to 15 Ill., 284'
>>> cited = client.read_cite(thornton.cites_to[0], full_case=True)
>>> str(cited)
'Marsh v. People, 15 Ill. 284 (1853-12-01)'

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

justopinion-0.2.5.tar.gz (18.7 kB view hashes)

Uploaded source

Built Distribution

justopinion-0.2.5-py3-none-any.whl (8.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page