DEVELOPER ACCESS

API reference

The API matches what's currently on the public site. If a number is public on the site, you can fetch it here; if it hasn't been published yet, the API doesn't expose it.

Public routes available today

GET /v1/states/karnataka/stats

Statewide backlog, disposal pace, wait estimate, and count of districts to watch for the active publication.

Sample response

{
  "snapshot": {
    "stateCode": "HP",
    "stateName": "Himachal Pradesh",
    "sourceSnapshotAt": "2025-03-15T00:00:00.000Z",
    "publishedAt": "2025-03-20T11:42:00.000Z",
    "methodologyVersion": "v1.3.0",
    "qualityState": "complete",
    "freshnessDays": 5,
    "sourceAttribution": "NJDG — March 2025"
  },
  "stats": {
    "pendingCases": 94158,
    "filedLastMonthCases": 10420,
    "clearedLastMonthCases": 9820,
    "disposalRate": 74.3,
    "medianCaseAgeDays": 847,
    "flaggedDistricts": 9,
    "oldCaseBurden": {
      "fivePlusYearsCases": 18430,
      "fivePlusYearsShare": 19.6
    },
    "backlogMovementShare": 0.6,
    "breakEvenClearancesNeeded": 600,
    "catchUpClearancesPerMonth": 1385,
    "backlogConcentration": {
      "topFiveDistrictsShare": 57.8
    }
  },
  "trends": [
    { "snapshotDate": "2025-01-15T00:00:00.000Z", "pendingCases": 91240, "filedLastMonthCases": 10120, "clearedLastMonthCases": 9460, "disposalRate": 71.8 },
    { "snapshotDate": "2025-02-15T00:00:00.000Z", "pendingCases": 94158, "filedLastMonthCases": 10420, "clearedLastMonthCases": 9820, "disposalRate": 74.3 }
  ]
}

GET /v1/states/karnataka/districts

District-level rows with rankings, queue size, disposal pace, wait estimate, and flag explanations.

Sample response

{
  "districts": [
    {
      "districtId": "kangra",
      "districtName": "Kangra",
      "rank": 1,
      "backlogCases": 12453,
      "filedLastMonthCases": 1520,
      "clearedLastMonthCases": 1360,
      "disposalRate": 68.2,
      "medianAgeDays": 912,
      "filingVsDisposalGap": 8.4,
      "oldCaseBurden": {
        "fivePlusYearsCases": 3210,
        "fivePlusYearsShare": 25.8
      },
      "backlogMovementShare": 1.3,
      "breakEvenClearancesNeeded": 160,
      "watchlistPersistence": {
        "flaggedInLastSix": 5,
        "lastSixWindow": 6
      },
      "flagReason": "High file-clear gap with growing backlog.",
      "summary": "Kangra shows a widening backlog …"
    },
    {
      "districtId": "shimla",
      "districtName": "Shimla",
      "rank": 2,
      "backlogCases": 10421,
      "filedLastMonthCases": 1210,
      "clearedLastMonthCases": 1240,
      "disposalRate": 71.5,
      "medianAgeDays": 874,
      "filingVsDisposalGap": 5.9,
      "oldCaseBurden": {
        "fivePlusYearsCases": 2240,
        "fivePlusYearsShare": 21.5
      },
      "backlogMovementShare": -0.3,
      "breakEvenClearancesNeeded": 0,
      "watchlistPersistence": {
        "flaggedInLastSix": 3,
        "lastSixWindow": 6
      },
      "flagReason": "Backlog remains above the state median.",
      "summary": "Shimla remains a high-volume district in this snapshot."
    }
  ]
}

GET /v1/states/karnataka/trends

Published snapshot history for the statewide trend surface.

Sample response

{
  "trends": [
    { "snapshotDate": "2025-01-15T00:00:00.000Z", "pendingCases": 91240, "filedLastMonthCases": 10120, "clearedLastMonthCases": 9460, "disposalRate": 71.8 },
    { "snapshotDate": "2025-03-15T00:00:00.000Z", "pendingCases": 94158, "filedLastMonthCases": 10420, "clearedLastMonthCases": 9820, "disposalRate": 74.3 }
  ]
}

What the API guarantees

CSV parity

The /data downloads stay aligned with the same published read model, so the CSV columns and the JSON fields mean the same thing.

Published only

The API never exposes fresher unpublished data than the public pages themselves. Operator captures in review stay private.