---
title: "International Filings"
method: GET
path: "/stock/international-filings"
tags: ["Default"]
---

# International Filings

`GET /stock/international-filings`

## Request

- Base URL: `https://finnhub.io/api/v1`
- URL: `https://finnhub.io/api/v1/stock/international-filings`
- Auth: API key in query parameter `token`

List filings for international companies. Limit to 500 documents at a time. These are the documents we use to source our fundamental data. Enterprise clients who need access to the full filings for global markets should contact us for the access.

## Query parameters

- `symbol` string
- `country` string
- `from` string, date
- `to` string, date

## Response `200`

successful operation

- InternationalFiling[]
  - `symbol` string: Symbol.
  - `companyName` string: Company name.
  - `filedDate` string: Filed date <code>%Y-%m-%d %H:%M:%S</code>.
  - `category` string: Category.
  - `title` string: Document's title.
  - `description` string: Document's description.
  - `url` string: Url.
  - `language` string: Language.
  - `country` string: Country.

## Changes

- **2024-11-05** `fb7e94c545be`: 2 info
  - added the new optional `query` request parameter `from`
  - added the new optional `query` request parameter `to`
- **2023-10-17** `916ab58ae589`: 1 info
  - endpoint added
- **2023-03-31** `fe3acff4e0d7`: 1 breaking
  - api path removed without deprecation
- **2021-07-26** `0f755a71e903`: 1 breaking
  - the `items/filedDate` response's property format changed from `date-time` to no format for status `200`
- **2021-07-23** `a148c0b2d583`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/stock/international-filings/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) - [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/revisions/415b27331384?raw)