API Version 1.0 - Live

API Documentation

Complete technical reference for integrating with the Vakeel360 Court Case API. Access real-time data from 25+ Indian courts with simple REST endpoints.

Get API Key View Endpoints

Overview

The Vakeel360 API provides programmatic access to Indian court case data including case status, hearing details, orders, and cause lists. All responses are returned in JSON format with real-time data fetched directly from court servers.

Real-Time Data

All data is fetched in real-time from official court servers. Response times vary between 2-10 seconds depending on court server availability.

Quick Facts

25+
Courts Supported
REST
API Architecture
JSON
Response Format

Authentication

All API requests require authentication using an API key. Include your key in the request header for every API call.

Request Header 
X-API-Key: your_api_key_here
Keep Your API Key Secure

Never expose your API key in client-side code, public repositories, or share it with unauthorized users. If compromised, contact us immediately for key rotation.

To obtain an API key, contact our team with your requirements and use case.

Base URL

All API endpoints are relative to the following base URL:

Production Base URL 
https://vakeel360.com/api/v1/protected

API Endpoints

Complete reference for all available API endpoints with request/response examples.

POST /case-search

Search for case status across all supported courts. Returns detailed case information including parties, hearings, orders, and next hearing date.

Request Parameters

Parameter Type Description
courtRequired string Court identifier (e.g., "allahabad-high-court-case-status", "nclt-new-delhi-case-status")
case_typeRequired string Type of case (e.g., "WRIT-C", "CP", "ITA", "OA")
case_numberRequired string Case number
case_yearRequired string Case filing year (e.g., "2024")
cnrOptional string CNR number (if provided, other fields except court can be omitted)

Code Examples

import requests

response = requests.post(
    "https://vakeel360.com/api/v1/protected/case-search",
    headers={"X-API-Key": "your_api_key"},
    json={
        "court": "allahabad-high-court-case-status",
        "case_type": "WRIT-C",
        "case_number": "12345",
        "case_year": "2024"
    }
)

data = response.json()
print(data)

Response

200 OK 
{
  "success": true,
  "data": {
    "case_number": "WRIT-C/12345/2024",
    "case_type": "WRIT-C",
    "filing_date": "2024-01-15",
    "petitioner": "ABC Pvt Ltd",
    "respondent": "State of UP",
    "petitioner_advocate": "Adv. Sharma",
    "respondent_advocate": "Govt. Counsel",
    "status": "Pending",
    "next_date": "2024-02-15",
    "court_name": "Allahabad High Court",
    "bench": "Division Bench",
    "hearings": [
      {
        "date": "2024-01-20",
        "purpose": "Admission",
        "result": "Adjourned"
      }
    ],
    "orders": [
      {
        "date": "2024-01-20",
        "order_url": "https://..."
      }
    ]
  }
}
POST /order-search/{bench}/advocate

Search for orders by advocate name from the last 17 days. Available for Allahabad and Lucknow benches of Allahabad High Court.

Path Parameters

Parameter Type Description
benchRequired string Bench name: "allahabad" or "lucknow"

Request Body

Parameter Type Description
advocate_nameRequired string Name of the advocate (partial match supported)

Code Example

response = requests.post(
    "https://vakeel360.com/api/v1/protected/order-search/allahabad/advocate",
    headers={"X-API-Key": "your_api_key"},
    json={"advocate_name": "Sharma"}
)
POST /order-search/{bench}/case

Search for orders by case number from the last 17 days. Returns all orders passed for the specified case.

Request Body

Parameter Type Description
case_typeRequired string Case type (e.g., "WRIT-C")
case_numberRequired string Case number
case_yearRequired string Case year
GET /courts

Get a list of all supported courts with their identifiers, case types, and bench information.

Code Example

Python 
response = requests.get(
    "https://vakeel360.com/api/v1/protected/courts",
    headers={"X-API-Key": "your_api_key"}
)
POST /dcourts/case-search

Search cases in Delhi District Courts. Supports all 10 districts including Saket, Patiala House, Tis Hazari, etc.

Request Body

Parameter Type Description
districtRequired string District code: south, central, north, east, west, newdelhi, southwest, northeast, northwest, shahdara
case_typeRequired string Case type
case_numberRequired string Case number
case_yearRequired string Case year
POST /rera/{type}/find

Search RERA (Real Estate Regulatory Authority) cases for UP and Haryana.

Path Parameters

Parameter Type Description
typeRequired string "up" for UP RERA, "haryana" for Haryana RERA

Request Body (UP RERA)

Parameter Type Description
complaint_numberRequired string Full complaint number (e.g., "LKO162/03/125092/2025")

Request Body (Haryana RERA)

Parameter Type Description
case_typeRequired string RERA-GRG, RERA-PKL, or H-REAT
case_numberRequired string Case number
case_yearRequired string Case year
GET /health

Check API health status and validate your API key. Use this endpoint to verify connectivity and authentication.

Rate Limits

Rate limits are applied per API key based on your subscription plan to ensure fair usage and optimal performance.

Limit Type Description
Requests per minute (RPM) Based on your plan (typically 60-1000 RPM)
Concurrent requests Maximum 10 simultaneous requests
Daily limit Based on your subscription plan

Rate Limit Headers

Every API response includes rate limit information in the headers:

Response Headers 
X-RateLimit-Limit: 1000          # Your plan's limit
X-RateLimit-Remaining: 999      # Requests remaining
X-RateLimit-Reset: 1699999999   # Unix timestamp for reset
Rate Limit Exceeded

When you exceed the rate limit, the API returns a 429 status code. Wait for the reset time before making more requests.

Error Codes

The API uses standard HTTP status codes to indicate success or failure of requests.

Code Status Description
400 Bad Request Invalid request parameters or malformed JSON
401 Unauthorized Missing or invalid API key
403 Forbidden API key doesn't have permission for this resource
404 Not Found Case or resource not found
429 Too Many Requests Rate limit exceeded
500 Internal Server Error Server error - please retry
502 Bad Gateway Court server unavailable
503 Service Unavailable API temporarily unavailable
504 Gateway Timeout Court server timeout - please retry

Error Response Format

Error Response 
{
  "success": false,
  "error": {
    "code": "INVALID_CASE_NUMBER",
    "message": "Case number format is invalid",
    "details": "Expected format: numeric value"
  }
}

Supported Courts

We support 25+ courts across India including High Courts, Tribunals, RERA, and District Courts. Need a court that's not listed? Contact us for priority integration.

High Courts

  • Allahabad High Court (Main Bench)
  • Allahabad High Court (Lucknow Bench)
  • Delhi High Court
  • Patna High Court
  • Madras High Court
  • Punjab & Haryana High Court
  • Kolkata High Court

NCLT

  • New Delhi (Principal) 15 benches
  • Mumbai
  • Chennai
  • Kolkata
  • Bengaluru
  • Ahmedabad
  • Hyderabad
  • + 8 more benches

CAT

  • Delhi 18 benches
  • Mumbai
  • Chennai
  • Kolkata
  • Lucknow
  • Allahabad
  • Bangalore
  • + 11 more benches

ITAT

  • Delhi 23 benches
  • Mumbai
  • Bangalore
  • Chennai
  • Kolkata
  • Pune
  • Ahmedabad
  • + 16 more benches

CESTAT

  • Delhi 10 benches
  • Mumbai
  • Chennai
  • Kolkata
  • Bangalore
  • Ahmedabad
  • Hyderabad
  • + 3 more benches

RERA & District

  • UP RERA
  • Haryana RERA (Gurugram)
  • Haryana RERA (Panchkula)
  • H-REAT (Appellate)
  • Delhi District Courts 10 districts
  • eCourts District Courts

Terms & Conditions

By using the Vakeel360 API, you agree to be bound by the following terms and conditions.

1 Acceptance of Terms

By accessing or using the Vakeel360 API ("API"), you agree to be bound by these Terms and Conditions. If you do not agree, do not use the API. These terms constitute a legally binding agreement between you and Vakeel360.

2 API License

Subject to these Terms, Vakeel360 grants you a limited, non-exclusive, non-transferable, revocable license to access and use the API solely for your internal business purposes as permitted by your subscription plan.

3 Permitted Use

You may use the API to:

  • Query case status information for legitimate legal, business, or research purposes
  • Integrate court data into your internal applications and systems
  • Provide services to your clients using the data obtained through the API
  • Build applications that add value on top of the raw data
4 Prohibited Use

You agree NOT to:

  • Resell, redistribute, or sublicense raw API access to third parties
  • Use the API to build a competing service or database
  • Scrape, harvest, or bulk download data for creating derivative databases
  • Share your API key with unauthorized users or expose it publicly
  • Circumvent rate limits or use automated tools to exceed your quota
  • Use the API for any unlawful purpose or to harass individuals
  • Misrepresent data source or claim data as your own proprietary information
  • Overload court servers through excessive or abusive API calls
5 Data Accuracy Disclaimer

THE API DATA IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. Vakeel360 does not guarantee the accuracy, completeness, or timeliness of court data. Data is sourced from official court websites which may contain errors or delays.

  • Always verify critical information directly from official court records
  • Do not rely solely on API data for legal decisions without verification
  • Court servers may be temporarily unavailable affecting data retrieval
6 Service Availability

Vakeel360 strives to maintain high API availability but does not guarantee uninterrupted service. The API depends on third-party court servers which may experience downtime. We reserve the right to:

  • Perform scheduled maintenance with reasonable notice
  • Modify, suspend, or discontinue any part of the API
  • Implement rate limiting to ensure fair usage
7 Payment Terms
  • API access is provided on a monthly subscription basis
  • Payments are due in advance for each billing period
  • No refunds for partial month usage or unused quota
  • We reserve the right to modify pricing with 30 days notice
  • Failure to pay may result in API access suspension
8 Termination

Either party may terminate API access with 7 days written notice. Vakeel360 may immediately terminate access if you violate these Terms. Upon termination:

  • Your API key will be deactivated
  • You must cease all use of data obtained through the API
  • No refunds will be provided for the current billing period
9 Limitation of Liability

TO THE MAXIMUM EXTENT PERMITTED BY LAW, VAKEEL360 SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES ARISING FROM YOUR USE OF THE API, INCLUDING BUT NOT LIMITED TO:

  • Loss of profits, data, or business opportunities
  • Decisions made based on API data
  • Service interruptions or data inaccuracies
  • Any claims from third parties
10 Indemnification

You agree to indemnify, defend, and hold harmless Vakeel360, its officers, directors, employees, and agents from any claims, damages, losses, or expenses (including reasonable attorney fees) arising from:

  • Your use of the API
  • Your violation of these Terms
  • Your violation of any applicable law
  • Any third-party claims related to your use of the data
11 Privacy & Data Protection
  • We log API requests for security, debugging, and analytics purposes
  • Your API key and usage data are treated confidentially
  • We do not sell or share your usage data with third parties
  • Case data queried through API may be cached temporarily for performance
  • You are responsible for complying with data protection laws in your jurisdiction
12 Intellectual Property

The API, documentation, software, and Vakeel360 branding are proprietary and protected by intellectual property laws. Court data obtained through the API remains public information. You may not:

  • Use Vakeel360 trademarks without written permission
  • Reverse engineer or decompile the API
  • Remove any proprietary notices from the documentation
13 Modifications to Terms

We may update these Terms from time to time. We will notify you of material changes via email or through the API dashboard. Continued use of the API after changes constitutes acceptance of the modified terms. If you disagree with changes, you must stop using the API.

14 Governing Law & Jurisdiction

These Terms are governed by and construed in accordance with the laws of India. Any disputes arising from these Terms or your use of the API shall be subject to the exclusive jurisdiction of courts in New Delhi, India. You consent to personal jurisdiction in these courts.

15 Contact Information

For questions about these Terms, the API, or to report issues:

Frequently Asked Questions

How do I get an API key?

Contact us through our contact form with your requirements and use case. We'll set up your account and send you the API key within 24 hours. Include details about your expected usage volume and the courts you need access to.

Is the data real-time?

Yes, all data is fetched in real-time directly from official court servers. We don't maintain a cached database of case information. Response times typically range from 2-10 seconds depending on court server availability.

Can you add a court that's not listed?

Yes! Contact us with the court you need and we'll prioritize its integration. Most courts can be added within 1-2 weeks depending on the complexity of the court's website. Enterprise plans include priority court integration at no extra cost.

What formats do you support?

All API responses are in JSON format for easy integration with any programming language. Cause lists can also be exported to XLS/Excel format through specific endpoints.

What happens when a court server is down?

When a court server is unavailable, the API returns a 502 or 504 error with details. We recommend implementing retry logic with exponential backoff. Court servers typically become available again within a few hours.

Do you offer SLA guarantees?

Enterprise plans include SLA guarantees with defined uptime commitments and priority support. Contact our sales team for details on enterprise plans and custom SLA requirements.

Support

Need help with the API? Our support team is here to assist you.

Contact Support

Get help from our technical team

Response Time

Within 24 business hours

API Overview

Back to API landing page
Last Updated: January 2026  |  API Version: 1.0