List endpoints support pagination through two request parameters.
Request Parameters
| Parameter | Type | Default | Description |
|---|
page | integer | 1 | The page number to retrieve, starting from 1 |
perPage | integer | 20 | Number of results per page. Maximum is 100 |
POST endpoints such as /case-search, these go in the JSON body. For GET list endpoints, they go as query parameters.
Response Envelope
{
"success": true,
"response": {
"totalCount": 84,
"page": 2,
"limit": 20,
"pages": 5,
"cases": []
}
}
| Field | Description |
|---|
totalCount | Total records matching the query across all pages |
page | The page returned in this response |
limit | The page size used for this response |
pages | Total number of available pages |
page equals pages, you are on the last page.
Example
curl -X POST https://ecourts.neeved.com/api/v1/case-search \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{ "petitioner": "Reliance Industries", "page": 2, "perPage": 20 }'
Cache results locally when iterating through large result sets. Each page request for a search endpoint consumes credits.