Filings API

Table of contents

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."}