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% | The balance falls to 10% or less of the balance at the last top-up. | The organization owner | |
Credit alert at 0 | The balance reaches zero. | The organization owner | |
Monthly usage report | The 1st of each month, at 09:00 UTC. | The organization owner | |
Usage CSV export | 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. |
|
100% | The balance reaches zero or below. |
|
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 |
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
Open Usage & Billing > Plans & Billing.
Select Manage Payment Method > Open Billing Portal.
Confirm that a card is present and set as the default card.
Confirm that the card expiry date is later than your renewal date.
Add a second check of your own. Read
credits_remainingfromGET /usageon a schedule and raise your own alarm.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 |
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 |
| The UTC date of the calls in the row. |
| The organization name. |
| The name of the API key that sent the calls. |
| The endpoint path. |
| The display name of the endpoint. |
|
|
| The count of calls. |
| The count of calls that consumed credits. |
|
|
| The count of records returned. Meaningful for per-record endpoints. |
| The credits charged to the credit balance. |
| The plan credits charged. |
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 | Nothing. The error reaches your code only. |
An API call returns | Nothing. |
An API call returns a | 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
Open the Usage & Credits page at
/home/<workspace-slug>/usage.Read the Org Credit Balance card. A workspace with a monthly spend limit also shows a Credit Balance card for that workspace.
Note the balance at which you want your own warning.
Call
GET /usagewith an API key from a scheduled job in your own system.Read
credits_remainingin the response. It holds the organization balance at the time of the call.When
credits_remainingfalls 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 |
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
