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