Company Filings
Fetches a company's latest exchange filings: recent corporate announcements and annual reports. Each filing includes the original source link, its publication timestamp, and a revised-result indicator.
Rate Limits
Note: The force_update flag is limited to 5 requests per day on Plus and 25 requests per day on Pro.
Request
GET /api/filings/{company_symbol}
| Parameter | Description | Priority | Type |
|---|---|---|---|
| api_key | User Generated API Key. Generate Here | required | string |
| force_update Possible Values true, false | Force a fresh fetch of the latest filings | optional | boolean |
Response
| Field | Description | Type |
|---|---|---|
| success | Indicates if the API call was successful or not | string |
| company | Name of the company | string |
| trading_symbol | Unique stock symbol of the company | string |
| data | Contains the latest filings | object |
| data.announcements | Latest corporate announcements (up to 5) | array |
| announcements[].title | Announcement title as published by the exchange | string |
| announcements[].category | Category parsed from the title, e.g. Press Release / Media Release | string |
| announcements[].url | Original filing link (BSE PDF) | string |
| announcements[].published_at | Publication timestamp in ISO 8601 with the exchange timezone | string |
| announcements[].summary | Short description when the exchange publishes one | string |
| announcements[].is_revised | true when the title marks the filing as revised or restated | boolean |
| data.annual_reports | Annual report PDFs, newest first | array |
| annual_reports[].title | Label, e.g. Annual Report 2025 | string |
| annual_reports[].year | Financial year of the report | string |
| annual_reports[].url | Original annual report link | string |
| data.fetched_at | Timestamp of when the filings were last refreshed | string |
Revised results
is_revised is derived from the filing title: it is true when the title contains "Revised", "Restated", "Re-stated", or "Recast". The raw title is always returned alongside it, so you can audit the flag. A false value means no revision marker was present in the title, not that the exchange has certified the result as final.
Coverage
The filings feed exposes the latest 5 announcements and all annual report PDFs available for a company. Older announcements are not exposed by our current data integration, so full historical announcement coverage is not yet included.
Example
curl -X GET \ -H "Content-Type: application/json" \ --url 'https://api.fincrux.org/api/filings/FSL?api_key={api_key}'
{ "success": "true", "company": "Firstsource Solutions Ltd", "trading_symbol": "FSL", "data": { "announcements": [ { "title": "Announcement under Regulation 30 (LODR)-Press Release / Media Release", "category": "Press Release / Media Release", "url": "https://www.bseindia.com/stockinfo/AnnPdfOpen.aspx?Pname=68c4d308-abcc-4120-b511-605929ce696f.pdf", "published_at": "2026-11-05T16:35:01+05:30", "summary": "Firstsource named Leader in three ISG Provider Lens 2026 quadrants for GenAI and Agentic AI services.", "is_revised": false } ], "annual_reports": [ { "title": "Annual Report 2026", "year": "2026", "url": "https://www.bseindia.com/xml-data/corpfiling/AttachHis/5b7a626b-80a1-4f85-b139-1c53f1aa6922.pdf" } ], "fetched_at": "2026-11-14T10:12:31.412238" } }