# ecourts [](https://coveralls.io/github/captn3m0/ecourts?branch=main) [](https://pypi.org/project/ecourts/) [](https://github.com/captn3m0/ecourts/releases/latest) [](https://github.com/captn3m0/ecourts/actions/workflows/test.yml) [](https://captnemo.in/ecourts/) [](https://captnemo.in/ecourts/src/) [](https://doi.org/10.5281/zenodo.13324986)
This is a information retrieval toolkit to fetch case information from the
ECourts Service. This is primarily meant for journalists, and law
researchers who need bulk access to the ECourts website to get orders,
judgements, or lists of cases that match their criteria.
The final goal is to cover all services under the `ecourts.gov.in` domain, but it currently
supports a few services covered at https://hcservices.ecourts.gov.in/ecourtindiaHC/.
It covers all the High Courts and their various benches.
Type of Query | Supported | Inputs
--------------|-----------|-------
Search for cases by Case Number | 🚧WIP | Case Type, Case Number, Year
Search for cases by FIR Number | 🚧WIP | Police Station, FIR Number†, Year†, Case Status (Pending/Disposed/Both)â€
Search for cases by Party Name | 🔜Planned | Petitioner/Respondent Name, Year†, Case Status (Pending/Disposed/Both)â€
Search for cases by Advocate Name | 🚫No
Search for cases by Filing Number | 🚧WIP | Filing Number, Year
Search for cases by Act | ✅Yes | Act Type, Status
Search for cases by Case Type | 🚧WIP | Case Type, Year†, Pending/Disposed
Search for Case Orders/Judgement by Case Number | 🚧WIP | Case Type, Case Number, Year
Search for Case Orders/Judgement by Filling Number | 🚧WIP | Filing Number, Year
Search for Case Orders/Judgement by Judge Wise | 🚫No |
Search for Case Orders/Judgement by Party Name | 🔜Planned | Petitioner/Respondent Name, Year
Search for Case Orders/Judgement by Order Date | ✅Yes | Date
Get Cause List | ✅Yes | Date|
**†- Optional**
## Case Types
Each of the individual courts use their own numbering system for various case-types. So the same type of case might have different ID depending on the court. This can even vary between various benches of the same High Court. For example, HCB (Habeas Corpus Petition) is numbered the following different ways across various courts (not exhaustive):
Court |ID
------|----
Madras High Court - Principal Bench| 22
Madras High Court - Madurai Bench | 164
High Court of Jammu and Kashmir - Jammu Wing|17
High Court of Jammu and Kashmir - Srinagar Wing|171
As such, before doing any kind of work that relies on case type (such as fetching case details, or orders by case type) - you must get the relevant case type idenfiers. You can run:
`ecourts get-case-type --state-code SC [--court-code CC]` to
get the case type identifiers for a particular court. If the
`state-code/court-code` identifiers are not provided, the case types will
be fetched for all known courts. A list of all known courts is available
at [courts.csv](courts.csv) published as part of the source code.
## Act Types
Similar to Case Types, Act idenfiers are different between courts. You can use
`ecourts get-act-type --state-code SC [--court-code CC]`
to get the act type identifiers for a particular court.
## Types
The primary two classes that most users will deal with are Court, and ECourt. A court is one of the high court benches covered at https://hcservices.ecourts.gov.in/ecourtindiaHC/,
and an ECourt is the primary class that deals with the website.
Other entities involved are more legal in nature:
- [Case](https://captnemo.in/ecourts/src/entities/case.html#src.entities.case.Case)
- [CaseType](https://captnemo.in/ecourts/src/entities/case_type.html)
- [ActType](https://captnemo.in/ecourts/src/entities/act_type.html)
- [FIR](https://captnemo.in/ecourts/src/entities/fir.html)
- [Hearing](https://captnemo.in/ecourts/src/entities/hearing.html)
- [Objection](https://captnemo.in/ecourts/src/entities/objection.html)
- [Order](https://captnemo.in/ecourts/src/entities/order.html) - An order or judgement in a case.
- [Party](https://captnemo.in/ecourts/src/entities/party.html) - Either a petitioner or a responded to a case.
- [Court](https://captnemo.in/ecourts/src/entities/court.html)
- [ECourt](https://captnemo.in/ecourts/src/ecourt.html) APIs are also documented.
## Documentation
- Canonical link for the project is <https://captnemo.in/ecourts/>.
- General guidance is available via `ecourts --help` or `ecourts cmd --help`.
- Python documentation is available at [captnemo.in/ecourts/src](https://captnemo.in/ecourts/src/).
- Coverage reports are published at [Coveralls](https://coveralls.io/github/captn3m0/ecourts).
## Guiding Principles
- Make it easy to fetch case information.
- Store information in accessible formats, for easy retrieval and querying.
- Use standard identifiers, such as ISO-3166 for state codes.
- Be nice to the ecourts website. Retry failed requests, but do not hammer the site.
In case of 5xx errors, wait for a while before retrying.
## Citation [](https://doi.org/10.5281/zenodo.13324986)
If you use this for any research purposes, please use the following
citation information.
> DOI: https://doi.org/10.5281/zenodo.13324986
You can check various citation formats on the [Zenodo Website](https://zenodo.org/records/13324986)
or on GitHub by clicking "Cite this repository". Since this is a dynamic software - it
depends on the ecourts website, please cite the Zenodo ID `13324986` as it will always
point to the latest version of the software.
## LICENSE
Licensed under `GPL3-or-later`. If you run this code, you are responsible
for the legal implications of the same. The tool is intentionally
single-threaded, and does not offer any parallelism. This is to avoid
overloading the ecourts website servers, which are already
quite slow. Please note sections 15-16 of the LICENSE, which are summarized here:
```
There is no warranty for the program, to the extent permitted by
applicable law. In no event unless required by applicable law or agreed to in
writing will any copyright holder, or any other party who modifies and/or
conveys the program as permitted above, be liable to you for damages,
including any general, special, incidental or consequential damages arising
out of the use or inability to use the program.
```
As part of GPL3 obligations:
>You may copy, distribute and modify the software as long as you track
changes/dates in source files. Any modifications to this code must also be
made available under the GPL along with build & install instructions.
Raw data
{
"_id": null,
"home_page": null,
"name": "ecourts",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ecourts, legal-research, india, judiciary, law, information-retrieval",
"author": "Abhay Rana",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c2/ac/ffa2fd1f9b964a7c465070a385d80ffe8305b375928c7017156040043694/ecourts-0.0.8.tar.gz",
"platform": null,
"description": "# ecourts [](https://coveralls.io/github/captn3m0/ecourts?branch=main) [](https://pypi.org/project/ecourts/) [](https://github.com/captn3m0/ecourts/releases/latest) [](https://github.com/captn3m0/ecourts/actions/workflows/test.yml) [](https://captnemo.in/ecourts/) [](https://captnemo.in/ecourts/src/) [](https://doi.org/10.5281/zenodo.13324986)\n\nThis is a information retrieval toolkit to fetch case information from the\nECourts Service. This is primarily meant for journalists, and law\nresearchers who need bulk access to the ECourts website to get orders,\njudgements, or lists of cases that match their criteria.\n\nThe final goal is to cover all services under the `ecourts.gov.in` domain, but it currently\nsupports a few services covered at https://hcservices.ecourts.gov.in/ecourtindiaHC/.\n\nIt covers all the High Courts and their various benches.\n\nType of Query | Supported | Inputs\n--------------|-----------|-------\nSearch for cases by Case Number | \ud83d\udea7WIP | Case Type, Case Number, Year\nSearch for cases by FIR Number | \ud83d\udea7WIP | Police Station, FIR Number\u2020, Year\u2020, Case Status (Pending/Disposed/Both)\u2020\nSearch for cases by Party Name | \ud83d\udd1cPlanned | Petitioner/Respondent Name, Year\u2020, Case Status (Pending/Disposed/Both)\u2020\nSearch for cases by Advocate Name | \ud83d\udeabNo\nSearch for cases by Filing Number | \ud83d\udea7WIP | Filing Number, Year\nSearch for cases by Act | \u2705Yes | Act Type, Status\nSearch for cases by Case Type | \ud83d\udea7WIP | Case Type, Year\u2020, Pending/Disposed\nSearch for Case Orders/Judgement by Case Number | \ud83d\udea7WIP | Case Type, Case Number, Year\nSearch for Case Orders/Judgement by Filling Number | \ud83d\udea7WIP | Filing Number, Year\nSearch for Case Orders/Judgement by Judge Wise | \ud83d\udeabNo |\nSearch for Case Orders/Judgement by Party Name | \ud83d\udd1cPlanned | Petitioner/Respondent Name, Year\nSearch for Case Orders/Judgement by Order Date | \u2705Yes | Date\nGet Cause List | \u2705Yes | Date|\n\n**\u2020 - Optional**\n\n## Case Types\n\nEach of the individual courts use their own numbering system for various case-types. So the same type of case might have different ID depending on the court. This can even vary between various benches of the same High Court. For example, HCB (Habeas Corpus Petition) is numbered the following different ways across various courts (not exhaustive):\n\nCourt |ID\n------|----\nMadras High Court - Principal Bench| 22\nMadras High Court - Madurai Bench | 164\nHigh Court of Jammu and Kashmir - Jammu Wing|17\nHigh Court of Jammu and Kashmir - Srinagar Wing|171\n\nAs such, before doing any kind of work that relies on case type (such as fetching case details, or orders by case type) - you must get the relevant case type idenfiers. You can run:\n\n`ecourts get-case-type --state-code SC [--court-code CC]` to\nget the case type identifiers for a particular court. If the\n`state-code/court-code` identifiers are not provided, the case types will\nbe fetched for all known courts. A list of all known courts is available\nat [courts.csv](courts.csv) published as part of the source code.\n\n## Act Types\n\nSimilar to Case Types, Act idenfiers are different between courts. You can use\n\n`ecourts get-act-type --state-code SC [--court-code CC]` \nto get the act type identifiers for a particular court.\n\n## Types\n\nThe primary two classes that most users will deal with are Court, and ECourt. A court is one of the high court benches covered at https://hcservices.ecourts.gov.in/ecourtindiaHC/,\nand an ECourt is the primary class that deals with the website.\n\nOther entities involved are more legal in nature:\n\n- [Case](https://captnemo.in/ecourts/src/entities/case.html#src.entities.case.Case)\n- [CaseType](https://captnemo.in/ecourts/src/entities/case_type.html)\n- [ActType](https://captnemo.in/ecourts/src/entities/act_type.html)\n- [FIR](https://captnemo.in/ecourts/src/entities/fir.html)\n- [Hearing](https://captnemo.in/ecourts/src/entities/hearing.html)\n- [Objection](https://captnemo.in/ecourts/src/entities/objection.html)\n- [Order](https://captnemo.in/ecourts/src/entities/order.html) - An order or judgement in a case.\n- [Party](https://captnemo.in/ecourts/src/entities/party.html) - Either a petitioner or a responded to a case.\n- [Court](https://captnemo.in/ecourts/src/entities/court.html)\n- [ECourt](https://captnemo.in/ecourts/src/ecourt.html) APIs are also documented.\n\n## Documentation\n\n- Canonical link for the project is <https://captnemo.in/ecourts/>.\n- General guidance is available via `ecourts --help` or `ecourts cmd --help`.\n- Python documentation is available at [captnemo.in/ecourts/src](https://captnemo.in/ecourts/src/).\n- Coverage reports are published at [Coveralls](https://coveralls.io/github/captn3m0/ecourts).\n\n## Guiding Principles\n\n- Make it easy to fetch case information.\n- Store information in accessible formats, for easy retrieval and querying.\n- Use standard identifiers, such as ISO-3166 for state codes.\n- Be nice to the ecourts website. Retry failed requests, but do not hammer the site.\n In case of 5xx errors, wait for a while before retrying.\n\n## Citation [](https://doi.org/10.5281/zenodo.13324986)\n\nIf you use this for any research purposes, please use the following\ncitation information. \n\n> DOI: https://doi.org/10.5281/zenodo.13324986\n\nYou can check various citation formats on the [Zenodo Website](https://zenodo.org/records/13324986)\nor on GitHub by clicking \"Cite this repository\". Since this is a dynamic software - it \ndepends on the ecourts website, please cite the Zenodo ID `13324986` as it will always\npoint to the latest version of the software.\n\n## LICENSE\n\nLicensed under `GPL3-or-later`. If you run this code, you are responsible\nfor the legal implications of the same. The tool is intentionally\nsingle-threaded, and does not offer any parallelism. This is to avoid\noverloading the ecourts website servers, which are already\nquite slow. Please note sections 15-16 of the LICENSE, which are summarized here:\n\n```\nThere is no warranty for the program, to the extent permitted by\napplicable law. In no event unless required by applicable law or agreed to in\nwriting will any copyright holder, or any other party who modifies and/or\nconveys the program as permitted above, be liable to you for damages,\nincluding any general, special, incidental or consequential damages arising\nout of the use or inability to use the program.\n```\n\nAs part of GPL3 obligations:\n\n>You may copy, distribute and modify the software as long as you track\n changes/dates in source files. Any modifications to this code must also be\n made available under the GPL along with build & install instructions.\n",
"bugtrack_url": null,
"license": null,
"summary": "ecourts is a information retrieval tool for Indian High Courts.",
"version": "0.0.8",
"project_urls": null,
"split_keywords": [
"ecourts",
" legal-research",
" india",
" judiciary",
" law",
" information-retrieval"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9f4e2d43d20c2fd1c0bf222268255bcbe0e28e65ae0b24c4faffd9c9ea5fcea0",
"md5": "f14bae4588c5b5440384e009cb95b1d5",
"sha256": "42eed363476e430ba59f1e052f305046e7a43aed68e976c9b9ead101a56b7453"
},
"downloads": -1,
"filename": "ecourts-0.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f14bae4588c5b5440384e009cb95b1d5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 40109,
"upload_time": "2024-12-17T07:40:16",
"upload_time_iso_8601": "2024-12-17T07:40:16.274859Z",
"url": "https://files.pythonhosted.org/packages/9f/4e/2d43d20c2fd1c0bf222268255bcbe0e28e65ae0b24c4faffd9c9ea5fcea0/ecourts-0.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c2acffa2fd1f9b964a7c465070a385d80ffe8305b375928c7017156040043694",
"md5": "dcc1871b60d6f89372abbbbe3249b3b9",
"sha256": "29909021c87364f886330c0a7117468a2351dd260dd62fd74f7ad852520f6033"
},
"downloads": -1,
"filename": "ecourts-0.0.8.tar.gz",
"has_sig": false,
"md5_digest": "dcc1871b60d6f89372abbbbe3249b3b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 280136,
"upload_time": "2024-12-17T07:40:18",
"upload_time_iso_8601": "2024-12-17T07:40:18.954244Z",
"url": "https://files.pythonhosted.org/packages/c2/ac/ffa2fd1f9b964a7c465070a385d80ffe8305b375928c7017156040043694/ecourts-0.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-17 07:40:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ecourts"
}
JSON