How Monthly Quotas Work
Learn how your monthly enrichment quota is counted, when it resets, and how credit packs extend it.
What Counts Against Your Quota
Your monthly quota is the number of lead rows you can enrich in a calendar month. Each row in a successfully processed job counts as one lead against your quota. If a job fails before processing begins (file validation error), no quota is consumed. If a job fails mid-processing due to a server error, the consumed quota is refunded automatically within 1 hour.
Quota is tracked at the organisation level, not the individual user level. All team members share the same monthly pool. Admins can view current usage at /usage — the page shows total quota, leads used, leads remaining, and a day-by-day usage chart for the current month.
When Does the Quota Reset
Quotas reset at midnight UTC on the first day of each calendar month, regardless of when you signed up or upgraded. If you sign up on January 20th, your full quota is available immediately and resets on February 1st. You do not receive a pro-rated quota for partial months.
You will see a countdown to the next reset date on the Usage page. If you are approaching your quota limit, you will receive email warnings when you reach 80% and 95% of your monthly allocation.
Tip
Plan large enrichment runs at the start of the month to take full advantage of your fresh quota. If you have leftover quota at month end, it does not carry over — use it or lose it.
How Credit Packs Work with Quotas
Credit packs are one-time purchases of additional enrichment capacity that sit on top of your monthly quota. When your monthly quota is exhausted, the system automatically draws from your credit balance to continue processing jobs. Credits never expire and carry over month to month.
Credits are consumed before monthly quota on a first-in-first-out basis. For example: if you have 200 credits remaining in your balance and 50 monthly quota remaining, and you submit a 100-row job, Trust Leads will consume 50 credits and 50 monthly quota to complete the job.
Warning
Credits are consumed from your balance automatically when your quota runs out. If you have 0 credits and 0 quota remaining, the job will fail with a QUOTA_EXCEEDED error.
Checking Your Current Usage
Navigate to /usage at any time to see a detailed breakdown of your current month's enrichment activity. The page shows your plan's monthly quota, leads enriched today, this week, and this month, plus a bar chart of daily usage.
API users can check quota programmatically using the GET /api/usage endpoint, which returns a JSON object with quota_total, quota_used, quota_remaining, credits_remaining, and reset_date fields.
GET /api/usage
Authorization: Bearer lfk_your_api_key
Response:
{
"quota_total": 2000,
"quota_used": 1543,
"quota_remaining": 457,
"credits_remaining": 150,
"reset_date": "2024-02-01T00:00:00Z"
}Was this guide helpful?