Skip to Content

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.

PackPriceAPI tokensAbout this many ATS scoresFor
api_10$101,400,0003,589A solo builder
api_50$507,200,00018,461A solo builder (common choice)
api_200$20029,400,00075,384A solo builder
api_1000$1,000147,000,000376,923A product built on GetMattered
api_5000$5,000735,000,0001,884,615A 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:

OperationSpent byTypical tokensHigh tokens
ats_scorePOST /developer/ats-score390450
parsePOST /developer/parse530680
analyze_jobPOST /developer/analyze-job290410
light_cv_packPOST /developer/tailor or /developer/cv-pack, tier light1,5301,930
pro_cv_packPOST /developer/tailor or /developer/cv-pack, tier pro5,9807,240
cover_letterPOST /developer/cover-letter3,6404,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 200 spends 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/balance and GET /developer/applications/{id} are free.
  • POST /developer/tailor and POST /developer/cv-pack take a tier. The default is light. pro gives 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.

On this page