Data Portal » API Data Feeds » Filings API » Documentation

Filings API

Table of contents

Table of contents

Documentation
Overview and quick start
Authentication and authorization
Example usage
How to query
Query parameters
Data glossary

Authentication

To access the Acuris Filings API, you need a valid API key. If you don’t have an API key, then you can obtain one by requesting a trial or contacting our sales team.

This is an example of an Acuris Filings API key token:

eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6IlprS1JOdlhFeWNGQmkxN1QzYlZhX2VtLVJMZyIsImtpZCI6IlprS1JOdlhFeWNGQmkxN1QzYlZhX2VtLVJMZyJ9.eyJpc3MiOiJodHRwczovL2F1dGgucGVyZmVjdGluZm8uY29tIiwiYXVkIjoiaHR0cHM6Ly9hdXRoLnBlcmZlY3RpbmZvLmNvbS9yZXNvdXJjZXMiLCJleHAiOjE1OTM1MzY3OTQsIm5iZiI6MTU4NDcwNTk5NCwiY2xpZW50X2lkIjoiZGVsb2l0dGVBcGkiLCJzY29wZSI6WyJwaUFwaSIsInBpUHJvZHVjdHMiXSwic3ViIjoiMjM0NDU3IiwiYXV0aF90aW1lIjoxNTg0NzA1OTkzLCJpZHAiOiJpZHNydiIsInByb2R1Y3QiOlsiRkUiLCJTRUMiXSwiYW1yIjpbInBhc3N3b3JkIl19.ldgt9dmzrG1kUuZmIw3Ans3RmyFtAup7j626w6RQo0VG-lEGb9U_evJ66RHlQsYbyyqAbRE2Zv-s5ZfGiCUTvvSGSTOuyqnzsFEfoiQrp8B7Oz7DDFBhmBXomfekY97TjMRfzPJAQSQq78CJGVH5hHuz9wqiE4efKgQ210_Msg9apRjvqR41OZwkmq7ybQHkVn1saF37-i9fpjURF8U63OnyfBXXrr9GG8fL04Si86jgHZaswtOqQvsvdImCqbmA5SXyYvSPRMvvJT0xRSMno6QIr-Zob8joLN_GcHgT31EV-_OkrwndvbFv4mQFDJRYeHd9iXykgVPH287oDddpNrqoPeOu6i-JjPY8jMrP7ffE9p3IlcGTgLoFDiU21vFBQfceC9GgppNBAYoyx9zY-1VHajrQjjPtDhdkFNaRM7iNsT0oQmKx6UqVy0JB62BmhsaVy6qOJWwb1PMpV8WK8bWb510VbwAw1BkCf2_MbyFKZkxXQqurwuu-Mto92yJgt2ianTCys24b-6evA2xPxGviHI1X-jxt5Tfx0bViuv7KXx2hUNxJ7REgx29PskhtTlZryYNg18p6KgbWgM_KT-qIR1qkeEw4D_QaqjXbacfxgiEYtefdlS829NP5XXdhJ1hwTLrdXoE3JvmTiuOYj0H25Yv6-Bbw2tWXaZT6P4U

The API key must be passed in the request as Bearer token:

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

Authentication tokens can be refreshed on demand, it’s worth bearing this in mind should you wish to make your consuming agent dynamic. The current token has a two-months time-to-live (TTL) period.

Authorization

If your API subscription is valid and there are no errors in your query, then you’ll receive a ‘200 OK’ response back with the matching payload.

If your API key is not authorized for the API you are calling, then you will receive a ‘401 Unauthorized’ error:

{"message": "Authorization has been denied for this request."}