List Filings

GET

/filings/

Filings

Retrieve a paginated list of regulatory filings.
This endpoint supports extensive filtering via query parameters, including:

Company Identification: Filter by internal company ID, company_isin (case-insensitive), or company lei.

Company Location: Filter by countries using comma-separated ISO Alpha-2 codes (e.g., US,GB).

Filing Attributes: Filter by source ID, language (single ISO 639-1 code), languages (comma-separated ISO 639-1 codes), or filing type code.

Date Ranges: Filter by various date fields. All datetime filters expect an ISO 8601 format (e.g., YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD):

added_to_platform_from / added_to_platform_to: Date the filing was added to the platform.

dissemination_datetime_from / dissemination_datetime_to: Original dissemination date/time of the filing.

release_datetime_from / release_datetime_to: Actual release date/time of the filing.

Additionally, you can use the search parameter to perform a text search across the company name and filing title.
Results can be ordered using the ordering parameter with the fields: release_datetime and added_to_platform (e.g., ?ordering=-release_datetime).

Request

Query Params

added_to_platform_from

string <date-time>

optional

Filter by date added to platform (inclusive start date, YYYY-MM-DDTHH:MM:SSZ format).

added_to_platform_to

string <date-time>

optional

Filter by date added to platform (inclusive end date, YYYY-MM-DDTHH:MM:SSZ format).

company

integer

optional

Filter by internal Company ID.

company_isin

string

optional

Filter by Company ISIN. Case-insensitive.

countries

string

optional

Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values (e.g., US,GB,DE).

dissemination_datetime_from

string <date-time>

optional

Filter by dissemination datetime (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

dissemination_datetime_to

string <date-time>

optional

Filter by dissemination datetime (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

language

string

optional

Filter by a single filing language ISO 639-1 code (e.g., en).

languages

string

optional

Filter by filing language ISO 639-1 code(s). Comma-separated for multiple values (e.g., en,de).

lei

string

optional

Filter by Company Legal Entity Identifier (LEI).

ordering

string

optional

Which field to use when ordering the results.

page

integer

optional

A page number within the paginated result set.

page_size

integer

optional

Number of results to return per page.

release_datetime_from

string <date-time>

optional

Filter by release datetime (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

release_datetime_to

string <date-time>

optional

Filter by release datetime (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

string

optional

A search term.

source

integer

optional

type

string

optional

Filter by Filing Type code (e.g., ANNREP).

Header Params

x-api-key

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successfully retrieved the list of filings.

Body

count

integer

required

Example:

123

string <uri> | null

optional

Example:

http://api.example.org/accounts/?page=4

string <uri> | null

optional

Example:

http://api.example.org/accounts/?page=2

results

array[object (Filing) {14}]

required

integer

read-onlyrequired

Unique identifier for the filing.

company

object

read-onlyrequired

Basic details of the company that made the filing.

filing_type

object

read-onlyrequired

Details of the filing type.

language

object

read-onlyrequired

Language of the filing document.

filing_date

string <date>

read-onlyrequired

The official date the document was filed.

title

string

read-onlyrequired

Title of the filing document.

added_to_platform

string <date-time>

read-onlyrequired

Timestamp when the filing was added to our system (UTC).

updated_date

string <date-time>

read-onlyrequired

Timestamp when the filing record was last updated (UTC).

dissemination_datetime

string <date-time> | null

read-onlyrequired

Timestamp when the filing was disseminated by the source (UTC).

release_datetime

string <date-time> | null

read-onlyrequired

Timestamp when the filing was released (e.g., for press releases) (UTC).

source

null | allOf {1}

read-onlyrequired

Source from which the filing was obtained.

document

string <uri> | null

read-onlyrequired

Absolute URL link to the primary filing document (e.g., PDF, HTML).

extracted_kpis

null

read-onlyrequired

Stores the structured financial KPIs extracted as JSON.

processed_filing_id

integer | null

read-onlyrequired

ID of the processed version of this filing, if available. Null otherwise.

Example

{
    "count": 123,
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2",
    "results": [
        {
            "id": 0,
            "company": {
                "id": 0,
                "name": "string",
                "lei": "string",
                "sub_industry_code": "string",
                "country_code": "string"
            },
            "filing_type": {
                "code": "string",
                "name": "string",
                "description": "string"
            },
            "language": {
                "code": "string",
                "name": "string"
            },
            "filing_date": "2019-08-24",
            "title": "string",
            "added_to_platform": "2019-08-24T14:15:22Z",
            "updated_date": "2019-08-24T14:15:22Z",
            "dissemination_datetime": "2019-08-24T14:15:22Z",
            "release_datetime": "2019-08-24T14:15:22Z",
            "source": {
                "name": "string",
                "url": "http://example.com",
                "description": "string"
            },
            "document": "http://example.com",
            "extracted_kpis": null,
            "processed_filing_id": 0
        }
    ]
}

🟠401Unauthorized

Modified at 2025-05-24 05:59:30

Retrieve Company Details

Retrieve Filing Details