Data Portal » API Data Feeds » Entities API » Documentation

Entities API

Table of contents

Table of contents

Documentation
Overview and quick start
Authentication and authorization
Example usage
How to query
Query parameters
Data glossary
Error handling
Changelog
Version 1
Changelog

Authentication 

To access the Acuris Entities 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 Entities API key token, composed of a private key (string before the underscore) and a public key (string after the underscore): 

ar3xa1x2f4_l05zZlrRtu3d5qtAoK4cP8Rrc48zAY7S8tlhAk8U 

The public part of the API key must be passed in the request as follows: 

curl -H 'x-api-key: PUBLIC_API_KEY' https://api.acuris.com/entities/ 

Example: 

curl -H 'x-api-key: l05zZlrRtu3d5qtAoK4cP8Rrc48zAY7S8tlhAk8U' https://api.acuris.com/entities/ 

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": "Unauthorized"}