eCourtsIndia

API Documentation

v4.0
Base URL: https://webapi.ecourtsindia.com|JSON|Bearer Token Auth|30 Endpoints
Pricing

Authentication

All API requests (except Court Structure) require Bearer token authentication. Include your API token in the Authorization header.

Bearer Token Format
Authorization: Bearer eci_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Prefix: eci_live_
Length: 41 characters
Format: Alphanumeric
Response Format

All successful responses follow this structure:

JSON
{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123xyz"
  }
}

Security Warning

  • Keep your API token confidential. Do not expose it in client-side code.
  • Never commit tokens to version control or share in public repositories.
  • If compromised, contact us immediately to regenerate your token.
MCP Server

Add this URL as a custom connector, then click Connect to sign in at eCourts. Do not run a local stdio server.

https://mcp.ecourtsindia.com/mcp
Free Endpoints (No Auth Required)
  • GET /api/CauseList/court-structure/* — States, districts, complexes, courts
  • GET /api/partner/enums — Live enum reference

Free but auth required: GET /api/partner/causelist/available-dates — No credits charged, but Bearer token is required.

Core Concepts

Key concepts for working with the eCourts API.

CNR (Case Number Record)

A CNR is the unique 16-character identifier for every case in the eCourts system.

Pattern: [A-Z]{4}\d{12}
Components: [Court Code: 4 letters][Case Number: 6 digits][Filing Year: 4 digits]
DLHC010351552024 → Delhi HC, case 035155, filed 2024
HCBM050012342023 → Bombay HC (Kolhapur), case 001234, filed 2023
Court Hierarchy
text
Supreme Court of India (SC)
├── High Courts (37 across states/UTs)
│   ├── Original Jurisdiction
│   └── Appellate Jurisdiction
├── District Courts
├── National Company Law Tribunal (NCLT)
├── National Company Law Appellate Tribunal (NCLAT)
└── Specialized Tribunals
Cause List

A cause list is the daily schedule of cases to be heard in a specific courtroom. Each entry shows the case number, parties, assigned judge, expected hearing time, and case status. Use the Cause List Search endpoint to query schedules across courts.

Credit-Based Pricing

Most authenticated endpoints consume credits per request. Court structure endpoints and enum reference are free. Check your account balance and see the pricing page for details.

LegalCheck Jobs and Billing

LegalCheck is asynchronous. Submit once, save the returned data.code, poll its status_url, and fetch its report_url only after the job is completed. The resource code identifies the LegalCheck;meta.request_id identifies one HTTP request for support and diagnostics.

A newly accepted job costs ₹99 on PAYG or ₹33 with an active subscription. All status, report, list, and model reads are free. A terminal processing failure is refunded once to the original credit pools.

Each partner may have up to three jobs queued or running. Use a stable Idempotency-Key when retrying a submission so network retries cannot create another job or charge.

API Endpoints

30 endpoints covering case data, orders, cause lists, court structure across all Indian courts, and LegalCheck reports.