canonical: https://jentic.com/apis/aironline.in/aironline # Aironline In AIRonline The AIRonline API retrieves Indian reported case law, letting you look up case citations by journal name, year, volume, page, and court. It returns citation lists, full judgement text, and case digests, and it exposes acts with their section lists for statutory research. A nominal index lets you find cases by court name, making it a focused source for Indian legal citation lookups. ## For AI agents Look up Indian reported case citations, acts and their sections, judgement text, and case digests. Filter cases by journal name, year, volume, page, and court name. ## Scope Does not handle case filing, e-filing, or legal document drafting. Use for Indian case law citation lookup only. ## Capabilities - Look up reported case citations by journal name, year, volume, and page number - Retrieve the full citation list for a court or publication segment - Browse Indian acts and the section lists contained within them - Fetch the judgement text for a specific reported case - Search the nominal index to find cases by court name - Pull a case digest to review a judgement's holdings quickly ## Use cases ### AI Legal Research Assistant An AI agent connected to AIRonline through Jentic can answer legal research questions by resolving a citation reference into the reported case, pulling the judgement text, and summarising the holdings from the digest. The agent filters by journal, court, and year to find the right authority, then returns the citation list and judgement for review. Example prompt: Look up the citation list for the Supreme Court in a given journal year, then fetch the judgement text for the first matching case ### Citation Verification Verify a legal citation by resolving its journal name, volume number, and page number against AIRonline's reported case records. The citation lookup confirms the court and case the reference points to, so a brief or memo cites the correct authority. Example prompt: Resolve a citation given its journal name, volume number, and page number and confirm the court name it belongs to ### Statute and Section Lookup Retrieve Indian acts and the section lists within them so an agent can quote the correct statutory provision alongside case law. AIRonline returns the act list and the sections under a chosen act for statutory research. Example prompt: List the acts available, then retrieve the section list for a chosen act ### Case Digest Review Pull a case digest to review a judgement's key holdings without reading the full text first. The digest view gives a condensed account of a reported case, letting an agent triage which judgements are worth retrieving in full. Example prompt: Retrieve the digest for a reported case and extract its key holdings ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/aironline/api/citation/citationList` | Retrieve a list of case citations | | GET | `/aironline/api/citation/journalName` | List available journal names | | GET | `/aironline/api/citation/courtName` | List court names for citation filtering | | GET | `/aironline/act/act_list` | List Indian acts | | GET | `/aironline/act/section_list` | List sections under an act | | GET | `/aironline/api/judgement` | Retrieve judgement text for a case | ## Key resources - **Citations** — Reported case citations filtered by journal name, year, volume, page, and court - **Acts and Sections** — Indian acts and the section lists contained within them - **Judgements** — Full judgement text and condensed digests for reported cases - **Nominal Index** — Case lookups by court name through the nominal index ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 0 / 100 - **Maturity:** Non-Ready - **Dimensions:** - Foundational Compliance: 99 / 100 - Developer Experience & Jentic Compatibility: 70 / 100 - AI-Readiness & Agent Experience: 30 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 0 / 100 - **View full report:** https://jentic.com/apis/aironline.in/aironline/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring AIRonline by hand means handling its bearer token auth and learning its citation, act, and judgement endpoints yourself. Through Jentic you install once, import AIRonline from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** AIRonline exposes read operations across citations, acts, and judgements. You choose which operations your agent may call, so a rule can allow citation and act lookups while leaving the judgement retrieval out unless you add it. - **Credential handling:** Your AIRonline bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'look up a case citation' or 'find a judgement', and Jentic returns the matching AIRonline operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **PACER** — US federal court case and docket records, where AIRonline covers Indian reported case law. - **BCLaws** — British Columbia statutes and regulations, where AIRonline covers Indian acts and case citations. - **App4Legal** — Legal practice and matter management, complementing AIRonline's case law research. ## FAQ ### Is there an AIRonline MCP server? You don't need an MCP server to give your agent the AIRonline API. Jentic connects it directly from the API Directory: import it, store your bearer token once, and your agent can look up citations, acts, and judgements. Operations are discovered on demand, so your agent's context stays lean. ### Can I limit what my agent is allowed to do with the AIRonline API? Yes. Write a rule that allows only the citation and act lookup operations, so your agent can search reported cases and browse statutes but cannot pull full judgement text unless you add that operation, and every call it makes is logged. ### What authentication does the AIRonline API use? The AIRonline API authenticates with a bearer token per its OpenAPI spec, sent in the Authorization header. The judgement endpoint requires the token, while several citation lookups accept requests without it. With Jentic, the token is stored encrypted by your own Jentic One instance and injected at call time. ### Can I look up a case by its citation with the AIRonline API? Yes. The citation endpoints let your agent filter reported cases by journal name, year, volume number, page number, and court name, and return a citation list. From there your agent can fetch the matching judgement text or a digest of its holdings. ### What are the rate limits for the AIRonline API? The OpenAPI spec does not specify rate limits. Check the AIRonline website at https://www.aironline.in for current limits before running high-volume citation lookups. ### How do I look up a case citation with the AIRonline API through Jentic? Import the AIRonline API from the Jentic API Directory, store your bearer token once, and have your agent search by intent such as 'look up a case citation'. Jentic returns the citation lookup operation with its input schema, and your agent passes the journal and court filters. To run it on your own infrastructure, install Jentic One from its GitHub repo.