Pricing
API calls spend prepaid API tokens, apart from the GetMattered app plans.
Every call spends API tokens from the account that owns the key. API tokens are a balance of their own, the API balance. They are separate from the GetMattered app plans: a call never spends plan tokens, and the app never spends API tokens. You do not need a subscription to use the API.
Free trial
Your account gets 100,000 free API tokens once, when it creates its first key.
API token packs
After the trial, buy a pack on the Developers page in the dashboard. A pack is a one-time payment, in US dollars, before tax. API tokens never expire, and they cannot move to the app.
| Pack | Price | API tokens | About this many ATS scores | For |
|---|---|---|---|---|
api_10 | $10 | 1,400,000 | 3,589 | A solo builder |
api_50 | $50 | 7,200,000 | 18,461 | A solo builder (common choice) |
api_200 | $200 | 29,400,000 | 75,384 | A solo builder |
api_1000 | $1,000 | 147,000,000 | 376,923 | A product built on GetMattered |
api_5000 | $5,000 | 735,000,000 | 1,884,615 | A product built on GetMattered |
The two largest packs are sized for a team that runs its own product on the API. For more volume or custom terms, send an enterprise request from the Developers page.
What a call spends
A call spends what its work costs, plus a flat request fee of 160 tokens. The table shows what each resume call usually spends, and the high end:
| Operation | Spent by | Typical tokens | High tokens |
|---|---|---|---|
ats_score | POST /developer/ats-score | 390 | 450 |
parse | POST /developer/parse | 530 | 680 |
analyze_job | POST /developer/analyze-job | 290 | 410 |
light_cv_pack | POST /developer/tailor or /developer/cv-pack, tier light | 1,530 | 1,930 |
pro_cv_pack | POST /developer/tailor or /developer/cv-pack, tier pro | 5,980 | 7,240 |
cover_letter | POST /developer/cover-letter | 3,640 | 4,170 |
POST /developer/apply spends the tokens the application uses, plus the request fee.
See Apply to a job by API.
- A resume call that answers
200spends its work and the request fee. - Every resume call answer has
data.usage.tokens: the tokens that call spent. - A call that fails on our side after its work started spends the work it used and the request fee.
- A call refused before any work (
401,422,429) spends nothing. GET /developer/usage,GET /developer/balanceandGET /developer/applications/{id}are free.POST /developer/tailorandPOST /developer/cv-packtake atier. The default islight.progives a deeper rewrite and spends more.
Read your balance
GET /developer/balance returns the API tokens your account can spend now.
curl https://api.getmattered.com/api/v1/developer/balance \
-H "Authorization: Bearer $GETMATTERED_API_KEY"{
"success": true,
"data": { "balance": 1250000, "currency": "tokens" },
"meta": { "requestId": "...", "timestamp": "2026-11-19T12:00:00.000Z", "version": "v1" }
}The balance can be below zero. An application that is already running always finishes, even when it spends past the end of the balance. The next call is refused until you top up.
At zero tokens
An account with no API tokens left gets 402 with the limit_reached body.
The call runs no work and spends nothing:
{
"success": false,
"error": "limit_reached",
"limit": { "action": "ai_tokens", "current": 0, "max": 560, "period": "balance", "planTier": null },
"message": "This account is out of API tokens. Buy API tokens at https://getmattered.com/dashboard/developers#api-balance, then call again."
}limit.current is what the account could spend. limit.max is what the call needed to start.
limit.planTier is always null: an app plan never pays for an API call.
Buy a pack on the Developers page, then call again.
See Errors.
Usage
The Developers page in the dashboard shows your API balance and the tokens your keys spent each day.
GET /developer/usage?month=YYYY-MM returns your calls and the tokens they spent, per key and per operation.
Months run on UTC.
curl "https://api.getmattered.com/api/v1/developer/usage?month=2026-11" \
-H "Authorization: Bearer $GETMATTERED_API_KEY"Leave out month to get the current month.