Skip to main content

Understanding API Usage Metrics

Robb Clarke avatar
Written by Robb Clarke
Updated over a month ago

Overview

Each RB2B API includes a stacked bar chart on your dashboard that visualizes usage trends and performance over the past 60 days. This chart breaks down requests into three key categories:

Understanding these categories will help you evaluate performance, monitor data coverage, and troubleshoot integration behavior.

Requests with Data

These are successful API requests that returned valid data. In most cases, this means RB2B APIs successfully found a match in its identity or enrichment graph.

Examples:

  • A Fingerprint to HEM request returns a valid hashed email.

  • An HEM to Business Profile request returns company details for that hashed email address.

What it means:

Your API call worked as expected and returned usable information.

Requests without Data

These are successful API requests that did not return any records.

The API processed your request correctly but didn’t find a match in the dataset.

Examples:

  • A Fingerprint to HEM request for an unknown fingerprint.

  • A Fingerprint to MAID request for an unknown MAID.

What it means:

No data was available for that specific input.


This can occur when:

  • The visitor or identifier has not been observed recently.

  • The query input is malformed, outdated, or incomplete.

  • The data type requested isn’t available for that record.

💡 Tip: Requests without data do not consume credits.

Failed Requests

These represent unsuccessful API calls that resulted in an error response.

Common causes:

  • Invalid or missing API key

  • Incorrect request format or parameters

  • Temporary service interruption

What to do:

  • Verify your authentication header is correctly formatted (Authorization: API-Key {{api_key}}).

  • Double-check your endpoint's required parameters in RB2B's Postman documentation.

  • Retry later if the failure was temporary.

💡 Tip: Failed requests do not consume credits.

Viewing Metrics in the Dashboard

The stacked bar chart displays the daily volume of each request type for the past 60 days.

  • Green: Requests with Data

  • Yellow: Requests without Data

  • Red: Failed Requests

Hover over any bar to see totals for that day. This visualization helps you track success rates, identify unusual spikes in failures, and monitor API adoption over time.

Did this answer your question?