Links

Authentication

We are no longer updating this site. For user documentation, please go to User Docs. For developer documentation, please go to Developer Docs. If you have any questions or feedback, please submit a ticket.

Public vs. Private API Keys

Zaius provides two forms of authentication: Public and Private.
Keys are scoped at the account level
If you have multiple accounts within Zaius, the data within one account is not accessible to the others, you must utilize the appropriate API key.
  • Public API Keys (sometimes referred to as a Tracker ID) are used for most API calls that send data to Zaius and for a limited number of API calls that request data from Zaius and may be exposed publicly on the Internet.
  • Private API Keys can be used for querying data from Zaius for backend services and integrations.
When you revoke a private API key, your existing key is available for 12 hours as a grace period to ease any transitions.

Locate API Keys

To view your API Keys, go to Account Settings -> APIs. The screen displays a table of all available APIs:
Table Column
Description
API Name
The name of the API
Usage Plan
The usage plan for the API will be Default, No Access or the name of a Custom Plan / Package that your company has access to.
Limits
The limits placed upon the API including rate limits and quotas (if applicable)
Public API Key and Tracker ID are synonymous within Zaius

Using API Keys

To use your API key, include it in the headers of your REST API request. For example:
Example Request
curl -iX GET \
'https://api.zaius.com/v3/[email protected]' \
-H 'x-api-key: example.apiKey'
Last modified 10mo ago