# 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.

<br>

## Rate Limits

---

| Plan             | Rate Limit           |
| ---------------- | -------------------- |
| Hobby            | 5 requests / day     |
| [Plus](/pricing) | 10 requests / minute |
| [Pro](/pricing)  | 60 requests / minute |

**Note:** The `force_update` flag is limited to 5 requests per day on Plus and 25 requests per day on Pro.

<br>

## Request

---

`GET` `/api/filings/{company_symbol}`

| Parameter                                         | Description                                                               | Priority                                 | Type    |
| ------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------- | ------- |
| api_key                                           | User Generated API Key. [Generate Here](/dashboard)                       | <span style="color:red;">required</span> | string  |
| force_update <br> **Possible Values** true, false | Force a fresh fetch of the latest filings                                 | optional                                 | boolean |

<br>

## 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  |
| <span style="padding:0 0 0 25px;">**data**.announcements</span>                         | Latest corporate announcements (up to 5)                            | array   |
| <span style="padding:0 0 0 50px;">**announcements[].title**</span>                      | Announcement title as published by the exchange                     | string  |
| <span style="padding:0 0 0 50px;">**announcements[].category**</span>                   | Category parsed from the title, e.g. `Press Release / Media Release` | string  |
| <span style="padding:0 0 0 50px;">**announcements[].url**</span>                        | Original filing link (BSE PDF)                                      | string  |
| <span style="padding:0 0 0 50px;">**announcements[].published_at**</span>               | Publication timestamp in ISO 8601 with the exchange timezone        | string  |
| <span style="padding:0 0 0 50px;">**announcements[].summary**</span>                    | Short description when the exchange publishes one                   | string  |
| <span style="padding:0 0 0 50px;">**announcements[].is_revised**</span>                 | `true` when the title marks the filing as revised or restated       | boolean |
| <span style="padding:0 0 0 25px;">**data**.annual_reports</span>                         | Annual report PDFs, newest first                                    | array   |
| <span style="padding:0 0 0 50px;">**annual_reports[].title**</span>                     | Label, e.g. `Annual Report 2025`                                    | string  |
| <span style="padding:0 0 0 50px;">**annual_reports[].year**</span>                      | Financial year of the report                                        | string  |
| <span style="padding:0 0 0 50px;">**annual_reports[].url**</span>                       | Original annual report link                                         | string  |
| <span style="padding:0 0 0 25px;">**data**.fetched_at</span>                            | Timestamp of when the filings were last refreshed                   | string  |

<br>

## 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.

<br>

## 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.

<br>

## Example

---

<section class="codeTabs">

<div class="codeTabContent bash">

```bash
curl -X GET \
     -H "Content-Type: application/json" \
     --url 'https://api.fincrux.org/api/filings/FSL?api_key={api_key}'
```

</div>

<div class="codeTabContent python">

```bash
pip install fincrux
```

```python
import fincrux
fincrux = fincrux.Fincrux(api_key="YOUR_API_KEY")
print(fincrux.get_company_filings("FSL"))
```

</div>

<div class="codeTabContent javascript">

```bash
npm install fincrux
```

```javascript
import { Fincrux } from "fincrux";

const fc = new Fincrux({ api_key: "YOUR_API_KEY" });
console.log(await fc.getCompanyFilings("FSL"));
```

</div>

</section>

```json
{
  "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"
  }
}
```