Filings API

Table of contents

Overview

The Acuris Filings API enables you to search for regulatory filings, annual reports, interim results, investor presentations, and prospectuses using the Perfect Information taxonomy.

It is delivered over HTTPs, conforms to RESTful principles, and returns JSON objects.

Quick Start

You can call the Filings API endpoint and run a simple document search:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://www.filingsexpert.com/api/v1/fe/documents?highlighting=true&limit=100&query=isin:GB0033874545&sort=Date&start=0

The response includes the ‘defaultDownloadLink’ URL for downloading a given document, which can be copied and pasted into your browser. These URLs expire so do not hardcode them – you will need to treat this as a dynamic call sequence of query, response, parse for url, and download document.

Other useful information, such as ‘title’, ‘issueDate’, ‘pageCount’ and ‘isin’, are returned in the response. You can use these for tracking and providing context for each document.

Generating calls via the web product

You can generate API calls using Perfect Information web product. Perform a search, tap the menu icon to the left of your criteria, then click the ‘View API Link’ button. The web product also has a lightweight client built into the page, so you can see the response, or copy the query and paste it into an external RESTful development client like Postman.

Full documentation

Detailed technical information for the Acuris Filings API is available and will be provided when you start your trial.