eCourtsIndia

API Documentation

v4.0
Base URL: https://webapi.ecourtsindia.com|JSON|Bearer Token Auth|11 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": {
    "requestId": "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

Connect AI agents directly via Model Context Protocol:

https://mcp.ecourtsindia.com/mcp?token=YOUR_API_KEY
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.

API Endpoints

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