Usage tracking

When using Event Registry through the API, your actions consume so-called tokens. Different queries can use a different number of tokens. The tokens and their use are described in detail on the pricing page.

Access to the data in Event Registry depends on your account. If you are a free user without a paid licence, you can perform a limited number of requests and are allowed to use a limited set of functionalities (for example, data is limited to the last month only). The users without a paid licence are also not allowed to use the obtained data for commercial purposes. The terms of service are described on the Terms of Service page. In order to avoid these restrictions please contact us about the available plans.

Checking your usage from the SDK

The SDK provides several methods for tracking how many tokens/requests you have used:

• EventRegistry.getUsageInfo() returns the number of used and total available tokens for your account. It can be called at any time.
• EventRegistry.getRemainingAvailableRequests() and EventRegistry.getDailyAvailableRequests() return the remaining and the total number of requests for the day. The values are populated from the response headers, so they are available only after at least one request has been made.
• EventRegistry.printLastReqStats() prints how many tokens were used by the last executed request and whether the archive was used.