Skip to content

SooperKanoon API Power your website with SooperKanoon!

SooperKanoon API Documentation

Table of Contents

How to Form SooperKanoon's API Requests

API services are available via URLs. Kindly note the trailing .json at the end of each URL. JSON is returned for each URL.

Visit our Authentication section to get your GUID for authenticating your API requests.

Search Cases

Endpoint

GET /cases/search/name:<phrase>.json

Description

Search for legal cases using a specific phrase. Replace spaces with dashes (-) and remove any special characters (other than alphanumeric). The search phrase should be prefixed with name:.

Example

/cases/search/name:transfer-of-property.json

Filter by Court

You can filter search results by court:

/cases/search/name:transfer-of-property/court:<court-name>.json

Example:

/cases/search/name:transfer-of-property/court:supreme-court-of-india.json

Filter by Year

/cases/search/name:transfer-of-property/year:<year>.json

Example:

/cases/search/name:transfer-of-property/year:2015.json

Sorting

Sort the search results:

/cases/search/name:transfer-of-property/sortby:recent.json

Pagination

Access different pages of results:

/cases/search/name:transfer-of-property/page:<page-number>.json

Example:

/cases/search/name:transfer-of-property/page:2.json

Sample Response

Below is a sample JSON response when searching for cases under 'transfer of property':

{
  "json": {
      "totalno": "218650",
      "phrase": "transfer of property",
      "page": "1",
      "jids": [
          "/case/700167/ansal-properties-industries-ltd-vs-appropriate-authority.json",
          "/case/655801/pomal-kanji-govindji-vs-karsandas-purohit.json",
          "/case/675984/syndicate-bank-vs-officer-manager.json",
          "/case/638579/vasantkumar-radhakisan-vora-vs-trustees-bombay.json",
          "/case/656088/r-kempraj-vs-barton-son-co.json",
          "/case/652277/r-santhankumar-nadar-vs-indian-madras.json",
          "/case/122377/asman-ali-laskar-alias-jamir-uddin-vs-forjan-barbhuiya.json",
          "/case/656659/smt-gorabai-vs-ummed-singh.json",
          "/case/336651/jibhaoo-harisingh-rajput-vs-singh-fakira.json",
          "/case/385246/chartered-housing-bhoruka-finance-corporation-vs-appropriate-authority.json"
      ],
      "amount_remaining": "INR455"
    }
}

totalno: Total number of cases.

jids: List of case URLs. Each URL returns case details in JSON.

amount_remaining: Remaining amount in your account.

Advanced search allows you to search cases using multiple criteria. The general format is: 

/cases/advsearch/field1:<value1>/field2:<value2>.json

Replace spaces in the values with dashes (-) and remove any special characters (other than alphanumeric).

Available Fields

Field Description Example
casename Appellant's or respondent's name or both. casename:kesavananda-bharati
casenote Specific phrase within the case. casenote:suit-for-partition
act1 Relevant acts or statutes. act1:code-of-civil-procedure
judge Name of the Hon'ble Judge. judge:raveendran
citations Journal's short name where the case is reported. citations:air
subject Subject matter of the case. subject:labour
from / to Filter cases within a specific year range. from:2010/to:2020
court Name of the court. court:supreme-court-of-india
appealno Specific case number. appealno:mfa-6478-of-2012
appellant Name of the appellant. appellant:mohori-bibee
respondent Name of the respondent. respondent:dharmodas-ghose
plaintiff Name of the petitioner's/appellant's advocate. plaintiff:jethmalani
defendent Name of the defendant's advocate. defendent:holla
ddon Date of verdict (YYYY-MM-DD). ddon:2023-03-04

Advanced Search Examples

Search by Casename

/cases/advsearch/casename:kesavananda-bharati.json

Search by Judge

/cases/advsearch/judge:raveendran.json

Combining Multiple Fields

/cases/advsearch/casename:kesavananda-bharati/judge:raveendran/year:2010.json

Pagination

Access different pages of results:

/cases/advsearch/field:value/page:<page-number>.json

Example:

/cases/advsearch/casename:kesavananda-bharati/page:2.json

Sample Response

The JSON response for an advanced search includes:

{
  "json": {
      "totalno": "12345",
      "page": "1",
      "jids": [
          "/case/123456/case-name-1.json",
          "/case/234567/case-name-2.json",
          "/case/345678/case-name-3.json"
          // Additional cases...
      ],
      "amount_remaining": "INR455"
    }
}

totalno: Total number of cases found.

jids: List of case URLs. Each URL returns case details in JSON.

amount_remaining: Remaining amount in your account.

Get Latest Cases

Endpoint

GET /latest.json

Description

Retrieve a list of the most recent legal cases across all courts. The /latest.json endpoint provides quick access to the latest judgments and case details added to SooperKanoon. This is ideal for users who want to stay updated with recent legal developments without specifying a particular court.

Response

  • Status Code: 200 OK
  • Content-Type: application/json

Response Schema

The response follows the CasesListResponse schema with the following properties:

  • totalno (string): Total number of latest cases retrieved.
  • page (string): The current page number.
  • jids (array of strings): List of endpoints for detailed case information.
  • amount_remaining (string): Remaining search credit balance.

Example Response

{
  "totalno": "50",
  "page": "1",
  "jids": [
      "/case/123657/arbind-sharma-pappu-vs-ram-chander.json",
      "/case/123658/state-of-x-vs-y.json"
      // Additional cases...
  ],
  "amount_remaining": "INR9999971"
}

Notes

  • The list is sorted by the decision date in descending order, showing the most recent cases first.
  • By default, the endpoint returns the latest 50 cases.
  • Pagination parameters may be added in future updates to navigate through more cases.

Authentication

Your requests are authenticated via a GUID, which is sent securely in headers. The GUID header must be sent with each request using HTTP-GUID as the header key. 

HTTP-GUID: your-api-key

The GUID value is sent to your email at the time of sign-up.

Example Usage

curl --header "HTTP-GUID: 0ab94c4c035bfc39a602dc" https://sooperkanoon.com/cases/advsearch/judge:raveendran.json