Developers · API
The US company record, as an API
The same rows these pages show, for your own code: financial statements, revenue by segment, every 8-K event, insider trades, planned sales, large holders, House trades and short interest. The API is in development. Every table on these pages already opens as JSON in the shape it will return.
A request and what comes back
The request shows the planned address. The response is real rows from Apple's record.
curl https://api.shikshannivesh.com/v1/companies/AAPL/insider-trades?limit=2 \ -H "Authorization: Bearer $SN_API_KEY"
{
"company": {
"symbol": "AAPL",
"name": "Apple Inc.",
"cik": 320193
},
"dataset": "insider-trades",
"count": 46,
"rows": [
{
"date": "2026-10-20",
"filed": "2026-10-22",
"who": "Newstead Jennifer",
"role": "SVP, GC and Government Affairs",
"kind": "Sale under a trading plan",
"shares": 2399,
"price": 339.62,
"value": 814748,
"after": 34795,
"url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126040540/"
},
{
"date": "2026-10-16",
"filed": "2026-10-19",
"who": "Borders Ben",
"role": "Principal Accounting Officer",
"kind": "Sale under a trading plan",
"shares": 151,
"price": 343.08,
"value": 51805,
"after": 39417,
"url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126040127/"
}
]
}Planned endpoints
Each returns JSON. Dates are written year-month-day, money is in US dollars, and a row read from a filing carries that filing's address.
| Method | Address | Returns |
|---|---|---|
| GET | /v1/companies | Every company covered, with its ticker, name, exchange, industry and CIK. |
| GET | /v1/companies/{ticker} | One company's identity and its latest figures. |
| GET | /v1/companies/{ticker}/financials | Income statement, balance sheet and cash flow, every quarter and year, with the filing each came from. |
| GET | /v1/companies/{ticker}/segments | Revenue by business, by product and by region, each year. |
| GET | /v1/companies/{ticker}/events | Every 8-K, sorted by the event it reports, with the SEC acceptance time. |
| GET | /v1/companies/{ticker}/insider-trades | Form 4 trades, with the type, shares, price, value and shares held after. |
| GET | /v1/datasets/{dataset} | One dataset across every company, filtered by date, kind or ticker. |
curl https://api.shikshannivesh.com/v1/events?kind=results&since=2026-10-01 \ -H "Authorization: Bearer $SN_API_KEY"
{
"filed": "2026-09-01",
"accepted": null,
"form": "8-K/A",
"items": [
"5.02"
],
"kinds": [
"Leadership change"
],
"url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/"
}Schemas
The fields each dataset returns, from the real records: name, type, whether it can be empty, and an example.
/v1/datasets/insider-trades23 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "BOX" |
| name | string | No | "Box Inc." |
| date | date | No | "2026-10-21" |
| filed | date | No | "2026-10-23" |
| who | string | No | "Nottebohm Olivia" |
| role | string | No | "Chief Operating Officer" |
| type | string | No | "Sale" |
| plan | string | Yes | "dividend reinvestment" |
| shares | number | No | 5293 |
| price | number | Yes | 41.58 |
| value | number | Yes | 220083 |
| url | string | No | "https://www.sec.gov/Archives/edgar/data/1372612/000119312526430695/" |
| held | string | Yes | "see Footnote" |
| sec_title | string | Yes | "Class A Common Stock" |
| after | number | Yes | 481466 |
| tplan | boolean | Yes | true |
| security | string | Yes | "Class A Common Stock" |
| note | string | Yes | "The RSUs were granted to the Reporting Person in lieu of quarterly cash retainers, at the election of the Reporting Person, under the Issuer's Outside Director Compensation Policy." |
| pays_cash | boolean | Yes | false |
| chosen | boolean | Yes | false |
| same_day | number | Yes | 2 |
| pay | string | Yes | "routine" |
| paired_buy | date | Yes | "2026-08-13" |
/v1/datasets/planned-insider-sales18 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "BBY" |
| name | string | No | "Best Buy Co., Inc." |
| issuer_cik | number | No | 764478 |
| issuer | string | No | "BEST BUY CO INC" |
| who | string | No | "Bilunas Matthew M" |
| relationship | string | No | "Former Officer" |
| security | string | No | "Common" |
| broker | string | No | "Fidelity Brokerage Services LLC" |
| shares | number | No | 10287 |
| value | number | No | 1033335.33 |
| outstanding | number | No | 209727698 |
| planned | date | No | "2026-10-23" |
| exchange | string | No | "NYSE" |
| acquired | array | No | ["Restricted Stock Vesting"] |
| sold_3m | array | No | [] |
| filed | date | No | "2026-10-23" |
| accn | string | No | "0001959173-26-007479" |
| url | string | No | "https://www.sec.gov/Archives/edgar/data/764478/000195917326007479/" |
/v1/datasets/large-holders15 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "BBT" |
| name | string | No | "Beacon Financial Corp." |
| form | string | No | "SCHEDULE 13G/A" |
| kind | string | No | "13G" |
| amendment | boolean | No | true |
| filed | date | No | "2026-10-23" |
| accn | string | No | "0001104659-26-118529" |
| url | string | No | "https://www.sec.gov/Archives/edgar/data/1108134/000110465926118529/" |
| who | string | No | "Integrated Core Strategies (US) LLC" |
| others | number | No | 7 |
| pct | number | Yes | 4.2 |
| shares | number | Yes | 3515942 |
| event | date | No | "2026-09-30" |
| rule | string | Yes | "Rule 13d-1(c)" |
| purpose | string | Yes | "The Reporting Person and the EdgePoint Funds acquired the shares of Common Stock to which this Schedule 13D relates for investment purposes in the ordinary course of business. The Reporting Person and the EdgePoint Funds acquired the shares of Common Stock because they believed that the shares of Common Stock reported herein, when purchased, represented an attractive investment opportunity. Subject to the terms and conditions of the Cooperation Agreement (as defined below), the Reporting Person intends to review its investment in the Issuer on a continuous basis to maximize the value of the" |
/v1/datasets/short-interest9 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "A" |
| name | string | No | "Agilent Technologies, Inc." |
| settlement | date | No | "2026-09-30" |
| short | number | No | 5240309 |
| prev | number | No | 5078629 |
| change_pct | number | No | 3.18 |
| adv | number | No | 2950874 |
| days_to_cover | number | No | 1.78 |
| issue | string | No | "Agilent Technologies Inc." |
/v1/datasets/congress-trades13 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "NVDA" |
| name | string | No | "NVIDIA Corp." |
| member | string | No | "Cleo Fields" |
| state | string | No | "LA06" |
| owner | string | Yes | "JT" |
| type | string | No | "Purchase" |
| asset_type | string | No | "ST" |
| amount | string | No | "$1,001 - $15,000" |
| tx | date | No | "2026-10-01" |
| disclosed | date | No | "2026-10-22" |
| url | string | No | "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20035669.pdf" |
| description | string | Yes | "083057" |
| exercise | boolean | Yes | true |
/v1/datasets/events6 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "ANDE" |
| name | string | No | "Andersons, Inc." |
| form | string | No | "8-K" |
| items | array | No | ["5.02","9.01"] |
| kinds | array | No | ["Leadership change"] |
| accepted | datetime | Yes | "2026-10-23T21:28:36Z" |
/v1/datasets/financial-statements2 fields
| Field | Type | Can be empty | Example, from a real row |
|---|---|---|---|
| symbol | string | No | "ALV" |
| name | string | No | "Autoliv Inc." |
How paying for it will work
Prices are not set yet, and they will be in US dollars. The way you pay is decided.
01
A free allowance every month
A set number of free credits each month, so you can try the API before you pay for anything.
02
Pay as you go after it
You buy credits and each call uses some. A light call, like a company's identity, uses fewer credits than a company's whole financial history.
03
A daily cap you set
Calls stop at the cap you choose, so a script that runs away cannot run up a bill.
Questions
Is the API live?+
What does it cost?+
Can I use the data in my own product?+
Can AI tools read these pages?+
For teams · API · Licence
Tell us what you need
For the full history of the data, API access, files or a licence for your product or team: tell us who you are, which data and what it is for. We reply from info@shikshannivesh.com.
Free for your personal research, with credit and a link. For API access, bulk files or commercial use, tell us what you need. The data licence