NyayaKoshन्यायकोश
HomeProductsDemoPricingAPIAboutBlogContactLoginBook a demoGet started
HomeAPI

The corpus,
over REST.

Search, analysis, notice replies and trends from your own application. JSON in, JSON out, citations attached.

bash — nyayakosh
$ 
Endpoints

77 endpoints. One key. Credits only on success.

GET/v1/search

Search & Discovery · 3 endpoints · 1 live, 2 coming soon

GET/v1/judgments/{doc_id}

Judgments & Documents · 6 endpoints · 3 live, 3 coming soon

GET/v1/judgments/{doc_id}/citations

Citations & Precedent Mapping · 6 endpoints · coming soon

POST/v1/ai/search

AI Research (RAG) · 6 endpoints · coming soon

GET/v1/cases/search

Case Status & Litigation Tracking · 7 endpoints · 6 live, 1 coming soon

GET/v1/acts

Acts, Rules & Notifications · 5 endpoints · coming soon

GET/v1/analytics/judges/{judge_id}

Analytics · 5 endpoints · 4 live, 1 coming soon

GET/v1/courts

Master / Reference Data · 3 endpoints · live

GET/v1/feeds/updates

Bulk Data, Feeds & Webhooks · 4 endpoints · live

GET/v1/account/usage

Account & Platform · 3 endpoints · live

POST/api/client/register

Monetization · Client · 16 endpoints · live

GET/api/admin/dashboard

Monetization · Admin · 12 endpoints · live

POST/api/webhooks/payments/{provider}

Monetization · Payments · 1 endpoint · live

53 of 77 endpoints are live today. Endpoints marked coming soon are routed with their contracts and answer 501 NOT_AVAILABLE - never billed - until judgment text, citations and statutes are indexed. Full reference, code samples and playground →

Authentication & limits

How it behaves in production.

Bearer tokens

Authorization: Bearer or X-API-Key. nk_test_ sandbox keys are never billed; nk_live_ keys use your plan's credits. Scopes, IP allowlists, expiry and rotation with an overlap window.

Rate limits & credits

Limits are reported on every response in X-RateLimit-Remaining; a limited call returns 429 with Retry-After. Only successful calls consume credits; X-Credits-Remaining shows what is left this month.

Idempotency

Send an Idempotency-Key on any POST. A retry with the same key returns the original response instead of doing the work twice.

StatusCodeMeaning
400INVALID_PARAMA field is missing or malformed. The response names the field.
401API_KEY_MISSING / API_KEY_INVALID / API_KEY_REVOKED / API_KEY_EXPIRED / IP_NOT_ALLOWEDMissing or invalid credentials.
402SUBSCRIPTION_EXPIRED / SUBSCRIPTION_PAST_DUE / INSUFFICIENT_CREDITSPayment or plan action needed.
403PRODUCT_NOT_IN_PLAN / ENDPOINT_NOT_PERMITTED / ACCOUNT_SUSPENDEDNot authorised for this API.
404NOT_FOUNDNo case or document with that id.
422INVALID_FILTERValid request, unknown or not-yet-available filter value.
429RATE_LIMITED / QUOTA_EXCEEDEDSlow down; respect Retry-After.
501NOT_AVAILABLEDocumented, data not indexed yet. Not billed.
5xxINTERNAL / SOURCE_UNAVAILABLEOur side. Safe to retry with backoff and the same Idempotency-Key.
Webhooks

Be told when the law moves.

Watch cases and parties. When a hearing date moves, an order is uploaded, a status changes or a new case names a watched party, we post the event — signed with HMAC-SHA256 and retried with backoff for 24 hours.

Webhook reference
case.hearing_updated
{
  "event": "case.hearing_updated",
  "id": "evt_5f2c9a1b7e3d4c60",
  "created_at": "2026-10-19T06:12:44Z",
  "data": {
    "cnr": "DLHC011234562025",
    "title": "ABC Infra Pvt. Ltd. v. XYZ Engineering Ltd.",
    "previous": "2026-10-27",
    "next_hearing": "2026-11-04"
  }
}

Building on it?

Pick an API plan, pay online and create your keys in minutes from your developer dashboard. Need higher volume? Talk to us.

Get an API key