Skip to main content

Notifications and Credit Alerts

Written by Kadri - RichAPI Support Team

RichAPI warns you about credits by email, not in the dashboard. RichAPI sends one alert at 90% of credits used and one alert at a zero balance, to the organization owner only. When auto-reload is on, RichAPI sends neither email.

This article names the automatic messages RichAPI sends about credits and usage, and every failure it stays silent about. Read the silent list before you put a RichAPI integration into production.

Which automatic messages does RichAPI send?

RichAPI sends the automatic emails below. The dashboard has no notification bell and no in-app inbox, so no alert about credits, usage, or billing appears there.

Message

Channel

What starts it

Who receives it

Credit alert at 90%

Email

The balance falls to 10% or less of the balance at the last top-up.

The organization owner

Credit alert at 0

Email

The balance reaches zero.

The organization owner

Monthly usage report

Email

The 1st of each month, at 09:00 UTC.

The organization owner

Usage CSV export

Email

A member requests an export on the Usage & Credits page.

The address that requested the export

The organization owner is one person: an Owner of the oldest workspace in the organization. Credits belong to the organization, so these emails cover every workspace in it.

A workspace invitation is one more email. A member starts it by hand, and the invited address receives it. Read Managing Workspace Members and Permissions.

When does RichAPI email a credit warning?

RichAPI checks the credit balance after every API call that succeeds and charges credits. RichAPI compares the balance against the cycle baseline. The cycle baseline is the balance right after the last credit top-up, not the lifetime total of credits ever bought.

Alert

Condition

Subject line

90%

Credits used reach 90% of the cycle baseline.

You've used 90% of your RichAPI credits

100%

The balance reaches zero or below.

Your RichAPI credits have run out

RichAPI sends each alert one time per cycle. A credit top-up raises the cycle baseline to the new balance and clears both alert markers. The next cycle can then send both alerts again.

A worked example

An organization buys 1,000 credits. The cycle baseline becomes 1,000 credits.

Credits used

Balance

What happens

900

100

RichAPI sends the 90% alert. The email states the remaining balance.

999

1

RichAPI sends nothing. The 90% alert already went out this cycle.

1,000

0

RichAPI sends the 0-balance alert. Further calls return 402.

One credit costs $0.02, so 1,000 credits cost $20.00.

CAUTION: A single large call can take the balance from 500 credits to zero. In that case RichAPI sends the 0-balance alert only. The 90% alert never arrives, because the balance passed both thresholds in one step.

The alert depends on traffic, not on the clock

RichAPI runs the credit check inside the API call path. If a workspace sends no API calls, RichAPI runs no check and sends no alert. The alert arrives on the call that crosses the threshold, and not before.

Why does auto-reload stop the credit alerts?

Auto-reload switches off both credit alert emails. RichAPI reads the auto-reload setting first. When auto-reload is on, RichAPI stops the check and sends no email at 90% and no email at zero.

CAUTION: Turn auto-reload on and both credit alert emails stop at once. RichAPI gives no warning that the emails stopped, and the dashboard shows no change.

This is a deliberate design. RichAPI treats an auto-reload workspace as a workspace that refills itself, so it sends no depletion warning. The design holds only while the saved card works.

Read Enabling Auto-Reload for Credits for the threshold, the reload pack, and the 24-hour cooldown.

What happens after an auto-reload charge fails?

When an auto-reload charge fails, RichAPI sends no message. RichAPI records the failure in its own logs and returns the API response as normal. No email reaches the owner, and the dashboard shows nothing.

WARNING: A workspace with auto-reload on and a declined card receives no warning of any kind. The credit alert emails are off, and the failed charge is silent. The first signal is a 402 error on live API calls.

These four auto-reload failures are all silent:

Failure

What RichAPI does

The card is declined.

RichAPI logs the failure and adds no credits.

The workspace has no default card in Stripe.

RichAPI logs the failure and adds no credits.

Stripe returns an error.

RichAPI logs the failure and adds no credits.

A reload already ran inside the 24-hour cooldown.

RichAPI skips the reload.

How to protect an auto-reload workspace

  1. Open Usage & Billing > Plans & Billing.

  2. Select Manage Payment Method > Open Billing Portal.

  3. Confirm that a card is present and set as the default card.

  4. Confirm that the card expiry date is later than your renewal date.

  5. Add a second check of your own. Read credits_remaining from GET /usage on a schedule and raise your own alarm.

  6. Repeat step 3 after each card change.

Read Tracking Credit Usage and Billing for the GET /usage endpoint and the usage dashboard.

Does the dashboard show notifications?

No. The dashboard has no notification bell and no in-app inbox. RichAPI delivers every credit warning by email, so watch the inbox of the organization owner, not the dashboard.

What is in the monthly usage report email?

The monthly usage report is one email per organization per month. RichAPI sends it on the 1st of the month at 09:00 UTC, to the organization owner. The report covers the month before and adds up every workspace in the organization. The subject line reads RichAPI usage — July 2026, with the real month.

RichAPI sends no report to an organization that made zero API calls in that month.

Section of the email

What it holds

Header

The organization name, the rate tier, and the date range of the month.

Totals

API calls, records returned, and credits used.

Empty results line

The count of calls that came back empty and cost 0 credits.

Rejected requests line

The count of 4xx requests that RichAPI rejected and charged 0 credits.

Endpoint table

The 8 endpoints that used the most credits, with calls, records, credits, and hit rate.

Endpoint overflow line

The count of further endpoints, which appear in the CSV only.

Credit ledger

Opening balance, top-ups, credits consumed, adjustments, and the balance at the close of the month.

Links

Add credits, open the usage dashboard, download the CSV, the docs, and invoices.

All figures in the report are aggregated in UTC. If your own records use a local time zone, expect an off-by-one-day difference at the edges of the month.

What is in the attached CSV?

The report carries a CSV attachment. The file is named richapi-usage-<workspace>-<year>-<month>.csv. The file holds one row for each combination of date, endpoint, and API key. The file carries no totals row.

Column

Meaning

date

The UTC date of the calls in the row.

team

The organization name.

api_key_label

The name of the API key that sent the calls.

endpoint

The endpoint path.

endpoint_name

The display name of the endpoint.

unit_type

match, search, or hybrid. How the endpoint charges.

calls

The count of calls.

successful_calls

The count of calls that consumed credits.

failed_calls

calls minus successful_calls.

records_returned

The count of records returned. Meaningful for per-record endpoints.

credits_consumed

The credits charged to the credit balance.

plan_credits_used

The plan credits charged. 0 when the organization has no plan.

A very large month produces more than 50,000 rows. In that case RichAPI replaces the attachment with a download link inside the email. That link works for 7 days.

When the figures do not reconcile, the credit ledger section disappears. The usage totals stay correct in that case. Read the balance on the Usage & Credits page instead.

What does RichAPI not tell you about?

Plan your own monitoring around this list. Each row is a real event that produces no email and no in-app notification.

Event

What RichAPI sends

An auto-reload charge fails.

Nothing.

The saved card expires.

Nothing.

Credits run low while auto-reload is on.

Nothing.

An API call returns 402 because credits ran out.

Nothing. The error reaches your code only.

An API call returns 429 because of the rate limit.

Nothing.

An API call returns a 5xx error.

Nothing.

A run of calls returns no data.

Nothing until the monthly report.

An asynchronous job finishes.

Nothing by email. RichAPI can call an outbound webhook instead.

An API key is created, or an API key is deleted.

Nothing.

A member joins the workspace or leaves it.

Nothing to the owner.

How to build your own credit alarm

  1. Open the Usage & Credits page at /home/<workspace-slug>/usage.

  2. Read the Org Credit Balance card. A workspace with a monthly spend limit also shows a Credit Balance card for that workspace.

  3. Note the balance at which you want your own warning.

  4. Call GET /usage with an API key from a scheduled job in your own system.

  5. Read credits_remaining in the response. It holds the organization balance at the time of the call.

  6. When credits_remaining falls below your number, raise the alarm in your own paging tool.

Troubleshooting

Problem

Cause

Correction

The credit alert emails stopped.

Auto-reload is on. RichAPI stops both alerts while auto-reload is on.

Turn auto-reload off to restore the alerts, or build your own alarm on GET /usage.

Credits ran out with no email.

Auto-reload is on, and the card charge failed.

Open the billing portal and fix the default card. Add your own balance check.

The owner receives no credit alert.

The alert already went out this cycle, or the balance never crossed a threshold on a billable call.

Buy credits to start a new cycle. A top-up clears both alert markers.

A member receives no credit alert.

RichAPI sends credit alerts to the organization owner only.

Ask the owner to forward the email, or set a forwarding rule on the owner mailbox.

The monthly usage report never arrived.

The organization made zero API calls that month, or no workspace in it has an active Owner.

Confirm the Owners on the Organization page, Members tab. If calls exist and no report arrived, write to [email protected].

The report totals disagree with your records.

The report aggregates in UTC.

Convert your own records to UTC before you compare them.

The credit ledger is missing from the report.

The ledger figures did not reconcile, so RichAPI removed the section.

Read the balance on the Usage & Credits page. Write to [email protected] for a reconciliation.

Frequently asked questions

Who receives the RichAPI credit alert emails?

RichAPI sends the credit alert emails to one person: an Owner of the oldest workspace in the organization. RichAPI uses the email address on that account. Other members receive no credit alert.

Does RichAPI warn me before my credits run out?

RichAPI emails the organization owner at 90% of credits used and again at a zero balance. When auto-reload is on, both emails stop. The dashboard shows no in-app warning.

Does RichAPI warn me about a failed auto-reload payment?

No. When an auto-reload charge fails, RichAPI sends no email and shows no in-app notification. The first visible signal is a 402 error on your API calls.

Does the RichAPI dashboard show notifications?

No. The dashboard has no notification bell and no in-app inbox. RichAPI sends every credit alert by email.

When does the monthly usage report arrive?

RichAPI sends the monthly usage report on the 1st of the month at 09:00 UTC. The report covers the month before and goes to the organization owner. An organization with zero API calls in that month receives no report.

Can I change the 90% credit alert threshold?

No. The 90% and 100% thresholds are fixed and are not configurable in the dashboard. To warn yourself at a different level, read credits_remaining from GET /usage on a schedule.

Can I send the credit alerts to a second address?

No. RichAPI has no billing-contact field and no per-member email preference, so every credit alert goes to the owner address alone. Set a forwarding rule on the owner mailbox to copy a shared inbox.

Related articles

Did this answer your question?