Skip to content

LegalCrystal API Power your website with LegalCrystal!

Intro

LegalCrystal API is a service used to fetch case-laws via serialized data (JSON). The relevancy and ranking algorithms are same as the default search which is visible to the public. You can power your application using this API and fetch search results, fulltext case details, total no of results, even filter results. API is authenticated via a GUID which is e-mailed to you after sign-up.

Requests

API services are available via URLs. Kindly note the trailing .json in the end of each url. JSON is retured for each url.
Search Cases :
https://www.legalcrystal.com/cases/search/name:transfer-of-property.json
Phrases should have no special characters (otherthan alphanumeric) and spaces replaced with dashes(-).

Search Cases - Filter by court :
https://www.legalcrystal.com/cases/search/name:transfer-of-property/court:supreme-court-of-india.json
For list of courts refer normal url without the trailing .json

Search Cases - Filter by year :
https://www.legalcrystal.com/cases/search/name:transfer-of-property/year:2015.json

Search Cases - Sort :
https://www.legalcrystal.com/cases/search/name:transfer-of-property/sortby:recent.json

Pagination :
https://www.legalcrystal.com/cases/search/name:transfer-of-property/page:2.json

Viewing Case : Below JSON is returned searching for cases under 'transfer of property'.
{
  "json": {
      "totalno": "218650",
      "phrase": "transfer of property",
      "page": "1",
      "jids": [
          "https://www.legalcrystal.com/case/700167/ansal-properties-industries-ltd-vs-appropriate-authority.json",
          "https://www.legalcrystal.com/case/655801/pomal-kanji-govindji-vs-karsandas-purohit.json",
          "https://www.legalcrystal.com/case/675984/syndicate-bank-vs-officer-manager.json",
          "https://www.legalcrystal.com/case/638579/vasantkumar-radhakisan-vora-vs-trustees-bombay.json",
          "https://www.legalcrystal.com/case/656088/r-kempraj-vs-barton-son-co.json",
          "https://www.legalcrystal.com/case/652277/r-santhankumar-nadar-vs-indian-madras.json",
          "https://www.legalcrystal.com/case/122377/asman-ali-laskar-alias-jamir-uddin-vs-forjan-barbhuiya.json",
          "https://www.legalcrystal.com/case/656659/smt-gorabai-vs-ummed-singh.json",
          "https://www.legalcrystal.com/case/336651/jibhaoo-harisingh-rajput-vs-singh-fakira.json",
          "https://www.legalcrystal.com/case/385246/chartered-housing-bhoruka-finance-corporation-vs-appropriate-authority.json"
      ],
      "amount_remaining": "INR455"
    }
}
'totalno' is the total number of cases. 'jids' is the list of first page case urls. Each jid returns case details in json. amount_remaining is the remaining amount in your account.

Authentication

Your requests are authenticated via GUID which is sent in headers. GUID header has to be sent with each url with 'HTTP_GUID' as the param.
curl --header "HTTP_GUID: 0ab94c4c035bfc39a602dc" https://www.legalcrystal.com/cases/search/name:transfer-of-property.json
GUID is sent to you at the time of sign-up.