SUPREME COURT API

Supreme Court API reference

The API matches the latest published Supreme Court snapshot. If the public page shows a number, the JSON can expose it; if it is still in operator review, it stays private.

Routes available on this page

GET /v1/supreme-court/stats

Supreme Court metadata plus aggregate registered, unregistered, civil, criminal, institution, and disposal fields for the active publication.

Sample response

{
  "snapshot": {
    "courtTier": "supreme_court",
    "courtCode": "SCI",
    "courtSlug": "supreme-court",
    "courtName": "Supreme Court of India",
    "referenceDateAt": "2025-03-01T00:00:00.000Z",
    "referenceDateKind": "captured_at",
    "publishedAt": "2025-03-12T14:22:00.000Z",
    "methodologyVersion": "v1.3.0",
    "qualityState": "complete"
  },
  "stats": {
    "pendingCivilRegisteredCases": 40120,
    "pendingCivilUnregisteredCases": 3410,
    "pendingCivilTotalCases": 43530,
    "pendingCriminalRegisteredCases": 33121,
    "pendingCriminalUnregisteredCases": 3480,
    "pendingCriminalTotalCases": 36601,
    "pendingRegisteredCases": 73241,
    "pendingUnregisteredCases": 6890,
    "pendingTotalCases": 80131,
    "institutedLastMonthTotalCases": 3240,
    "disposedLastMonthTotalCases": 3108,
    "institutedCurrentYearTotalCases": 9720,
    "disposedCurrentYearTotalCases": 9324
  },
  "trends": [
    { "referenceDateAt": "2025-01-01T00:00:00.000Z", "referenceDateKind": "captured_at", "pendingTotalCases": 78440, "institutedLastMonthTotalCases": 3180, "disposedLastMonthTotalCases": 3090 },
    { "referenceDateAt": "2025-02-01T00:00:00.000Z", "referenceDateKind": "captured_at", "pendingTotalCases": 80131, "institutedLastMonthTotalCases": 3240, "disposedLastMonthTotalCases": 3108 }
  ]
}

GET /v1/supreme-court/trends

Published trend points only. No unpublished operator runs leak through this surface.

Sample response

{
  "trends": [
    {
      "referenceDateAt": "2025-01-01T00:00:00.000Z",
      "referenceDateKind": "captured_at",
      "pendingTotalCases": 78440,
      "institutedLastMonthTotalCases": 3180,
      "disposedLastMonthTotalCases": 3090
    },
    {
      "referenceDateAt": "2025-03-01T00:00:00.000Z",
      "referenceDateKind": "captured_at",
      "pendingTotalCases": 80131,
      "institutedLastMonthTotalCases": 3240,
      "disposedLastMonthTotalCases": 3108
    }
  ]
}

What this API guarantees

Published only

The API stays pinned to the active published Supreme Court snapshot. Newer internal fetches remain private until a publish succeeds.

Tier-aware semantics

This API is Supreme Court-specific. It does not pretend to be a national all-courts leaderboard or a cross-tier ranking framework.