India Search

POST /india/search

Call POST /india/search on the Corpus API.

Category: India · Search

Authentication

Send the provisioned API key in the X-API-KEY header.

Required scopes: india:read, search:read.

Request

This operation has no path, query, header, or cookie parameters.

Request body

Content type: application/json. Required: yes. Schema: IndiaSearchRequest.

{
  "query": "What were the principal risk factors?",
  "limit": 20,
  "offset": 0,
  "as_of": "2025-12-31T23:59:59Z",
  "filters": {
    "document_type": "annual_report",
    "year": 1,
    "court": "string",
    "court_level": "high_court"
  }
}

Example request

curl --request POST \
  --url 'https://corpus-api.onera.app/india/search' \
  --header "X-API-KEY: ${CORPUS_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "What were the principal risk factors?",
  "limit": 20,
  "offset": 0,
  "as_of": "2025-12-31T23:59:59Z",
  "filters": {
    "document_type": "annual_report",
    "year": 1,
    "court": "string",
    "court_level": "high_court"
  }
}'

Responses

Status	Description	Content type	Schema
200	Successful Response	application/json	IndiaSearchResponse
400	Invalid parameter combination	application/json	ErrorResponse
401	Missing or invalid API key	application/json	ErrorResponse
403	Insufficient jurisdiction or scope	application/json	ErrorResponse
404	Unknown resource	application/json	ErrorResponse
422	Request schema validation failed	application/json	ErrorResponse
429	Rate limit exceeded	application/json	ErrorResponse
503	Source content is unavailable or still processing	application/json	ErrorResponse

Representative 200 response

{
  "results": [
    {
      "artifact_id": "annual-report-example",
      "company_name": "string",
      "document_type": "annual_report",
      "bse_code": "500325",
      "nse_symbol": "RELIANCE",
      "period_year": 1,
      "snippet": "string"
    }
  ],
  "meta": {
    "jurisdiction": "IN",
    "count": 1,
    "limit": 10,
    "offset": 0,
    "next_offset": null,
    "as_of": "2025-12-31T23:59:59Z",
    "normalization_version": "string",
    "provenance": {}
  }
}