filings_list

Retrieve a paginated list of filings.

Supports filtering via query parameters defined in the FilingFilter,
searching via the 'search' parameter (searches company name and title),
and ordering via the 'ordering' parameter (allowed fields: release_datetime, added_to_platform).

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

Responses

🟢200OK

application/json

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) {13}]

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>

read-onlyrequired

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

release_datetime

string <date-time>

read-onlyrequired

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

source

object

read-onlyrequired

Source from which the filing was obtained.

document

string <uri>

read-onlyrequired

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

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",
      "processed_filing_id": 0
    }
  ]
}

Request

Request samples

Responses