# Pricing (/docs/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 [#free-trial]

Your account gets 100,000 free API tokens once, when it creates its first key.

## API token packs [#api-token-packs]

After the trial, buy a pack on the [Developers](https://getmattered.com/dashboard/developers#api-balance) 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.

<PackTable />

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 [#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](/docs/guides/apply-to-a-job).

- 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 [#read-your-balance]

`GET /developer/balance` returns the API tokens your account can spend now.

```bash
curl https://api.getmattered.com/api/v1/developer/balance \
  -H "Authorization: Bearer $GETMATTERED_API_KEY"
```

```json
{
  "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 [#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:

```json
{
  "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](https://getmattered.com/dashboard/developers#api-balance) page, then call again.
See [Errors](/docs/errors).

## Usage [#usage]

The [Developers](https://getmattered.com/dashboard/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.

```bash
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.