Watchlist: monitor any company or person for new court cases in India

Litigation involving the entities you depend on rarely makes headlines the day it starts. It usually surfaces months later, as a frozen contract, a failed audit or a liability you never saw coming. The watchlist closes that gap. It checks every entity you add against India's court system every day, including nights, weekends and public holidays, so you find out first, not last.

An entity is a company (BUSINESS) or an individual (PERSON). You can add one from the dashboard or through the API. Both do the same thing.

In the dashboard

1. Open Watchlist and add an entity. Choose whether it is a company or a person.
2. Enter the name. Use the legal name where you have it, for example “MakeMyTrip India Private Limited”.
3. Add identifying details: a registration number and address for companies; father's name and date of birth for people.
4. Choose the courts to monitor. ALL is the recommended default.
5. Optionally turn on the historical lookup, which finds cases filed before you added the entity.
6. Save. Monitoring starts straight away.

With the API

Send a POST request to /watchlist/entities with your API key. The response contains the new entity's _id.

BASE="https://api.caseprimus.ai/api/caseprimus/v1"

curl -X POST "$BASE/watchlist/entities" \
  -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Traders Pvt Ltd",
    "entityType": "BUSINESS",
    "monitoredCourts": [
      "ALL"
    ],
    "fetchHistoricalCases": false
  }'

const BASE = "https://api.caseprimus.ai/api/caseprimus/v1";

const res = await fetch(BASE + "/watchlist/entities", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY,
  },
  body: JSON.stringify({
    "name": "Acme Traders Pvt Ltd",
    "entityType": "BUSINESS",
    "monitoredCourts": [
      "ALL"
    ],
    "fetchHistoricalCases": false
  }),
});

const data = await res.json();

import os
import requests

BASE = "https://api.caseprimus.ai/api/caseprimus/v1"

res = requests.request(
    "POST",
    BASE + "/watchlist/entities",
    headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]},
    json={
        "name": "Acme Traders Pvt Ltd",
        "entityType": "BUSINESS",
        "monitoredCourts": ["ALL"],
        "fetchHistoricalCases": False,
    },
)

data = res.json()

Full field list and responses: Add entity to watchlist.

CasePrimus.ai covers India's court system through the eCourts network and our verification data partners. When you add an entity you pass monitoredCourts: either ALL, or a list of the codes below.

Many Indian companies and people share similar names. The more you tell us, the fewer false matches you will see.

For a company

Give the legal name, and add the registrationNumber and the registered location if you have them. For companies, our AI also searches likely spelling variations of the name, so a case filed under a slightly different spelling is not missed.

For a person

Give the full name, plus fatherName and birthDate (in DD-MM-YYYY format, for example 15-08-1990), and a location. These fields apply to people only and are ignored for companies.

Alerts appear in your dashboard. If you would rather have the data flow into a system you already run, subscribe a webhook to the events you care about. These are the ones most teams start with.

See all 13 webhook events and their payloads, or read how deliveries are signed and retried.

Everything above is available over a REST API. Here is the call that adds an entity, and the other watchlist endpoints you will use with it.