C Corpus
CCorpus

Overview

Quick Start

Authenticate and make your first Corpus API request in a few minutes.

1. Set your API key

Every authenticated request sends the key in the X-API-KEY header.

export CORPUS_API_KEY="your_api_key"

2. Choose a country

Use /us for SEC and US market data. Use /india for Indian securities, annual reports, news, and judgments.

3. Request US filings

curl "https://corpus-api.onera.app/us/filings?ticker=AAPL&filing_type=10-K&limit=4" \
  --header "X-API-KEY: $CORPUS_API_KEY"
{
  "filings": [],
  "meta": {
    "jurisdiction": "US",
    "count": 0,
    "limit": 4,
    "offset": 0,
    "next_offset": null,
    "as_of": "2026-07-20T23:59:59Z"
  }
}

4. Request an Indian security

curl "https://corpus-api.onera.app/india/securities?limit=10" \
  --header "X-API-KEY: $CORPUS_API_KEY"

Continue with Authentication, Errors and pagination, or the country-specific API reference.