Skip to main content

Usage tab

The Usage tab is on the left-hand side of your screen. Here, you can see all the actions that used credits on your account, both from the platform and the API.

1. Credit Overview (Top Left)

  • Shows how many credits you’ve used and how many are left.

  • You can click “Add more credits” anytime if you need more.

  • Resets:

    • Pay-as-you-go credits do not reset.

    • Monthly subscriptions reset each month.

    • Annual subscriptions reset once per year.

2. 24-Hour Rate Limit (Left Side)

The 24-Hour Rate Limit shows the maximum number of API actions (like searches or contact pulls via the API) you can perform in a single day.

  • The circular bar fills as you use your daily API allowance.

  • If you reach the limit, API requests will be temporarily blocked until the next day when it resets.

  • You can also upgrade your plan to increase your daily API limit.

Note: This 24-hour limit applies only to API usage and is designed to prevent system overload. It does not affect your total credits, but it does limit how many API calls you can make in a day.

API rate limits control how many requests you can make to the API in a set period to keep the system stable.

  • Default limit: 1,000 actions per day (for standard plans)

  • How it works: Each API call counts as one action. If you exceed the limit, additional requests will be blocked until the limit resets.

  • Where to check: Admin users can view their API rate limit in Usage → 24-Hour Rate Limit.

  • Response headers: When a rate limit is surpassed, the API will include the following headers in the response::

    • X-RateLimit-Limit – maximum requests in the current window

    • Retry-After – seconds to wait before sending another request

3. Manage Tokens (Left Side)

  • Click “Manage Tokens” to go to the API tokens page.

  • Here you can create, delete, or manage your API tokens for using Ocean.io via API.

4. Credit Usage Breakdown (Middle)

This section shows how your credits were used in detail.

Tabs at the top:

  • All / API / Platform – See all credits, only API usage, or only platform usage.

  • 24 hours / 7 days / 30 days / 12 months – Pick how far back you want to see your credit history. Default is 7 days.

Grouping your usage (radio buttons above the chart):

  • Total – See all credit usage combined.

  • Action – See which actions used how many credits.

  • Source – See if usage came from API or Platform.

When choosing the Platform tab, you can further filter usage by selecting the User option, and when viewing the API tab, you can drill down by selecting the Token option to see credit usage in full detail.

The Usage gives you full visibility into credit consumption. View credit usage by individual users in the Platform view, or drill down by API token in the API view, perfect for tracking activity across multiple tokens per user.

5. Example API Request (Bottom)

  • Select an action from the dropdown (different API actions you can test).

  • See the request body example (with a sample company).

  • Check the response example next to it.

  • Click Explore the Documentation to read the full API docs.

Tip: This tab helps you track your credits and understand how they’re used, so you can plan your actions and avoid hitting limits.

Note: Only admins can see the Usage tab.

Did this answer your question?