Accounts11

Alert channels6

Alert notifications1

Analytics12

Badges2

Check alerts2

Check groups11

Check results4

Check sessions7

Check status2

Checks15

Client certificates4

Dashboards5

Deployment Triggers2

Elements2

Environment variables5

Error Groups4

Heartbeats5

Incident Updates3

Incidents4

Location1

Maintenance windows12

Monitors14

Private locations8

Reporting1

Rocky AI3

Runtimes2

Secret scans1

Snippets5

Static IPs6

Status Page Incidents10

Status Page Services5

Status Pages8

Status Pages V37

Status Pages V3 Automation Rules5

Status Pages V3 Components5

Status Pages V3 Incidents11

Status Pages V3 Subscribers3

Test Session Error Groups4

Test sessions7

Triggers6

Usage8

Usage

Get usage projections

Changed on Oct 31, 2026

Project whole-term credit consumption from completed UTC days using v2 pricing rules.

get/v2/usage/terms/{id}/projections

Request

Base URL
https://api.checklyhq.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v2/usage/terms/:id/projections/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring uuid required

Query parameters

asOfstring date

Inclusive completed UTC date. Defaults to yesterday UTC; today and future dates are rejected.

Headers

x-checkly-accountstring uuid

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Response

Successful

usageTermsIdstring uuid required

asOfstring date required

Requested completed UTC date, including when it falls outside the term.

weeksSinceStartinteger required

weeksRemaininginteger required

creditsUsednumber nullable required

Credits rounded to four decimals before aggregation: once per organization-day for uptime monitors, and per resource-day and applied rate for other usage. Rules absent from configured pricing contribute zero. Null means unavailable or incompatible pricing, or uncovered dates.

remainingCreditsnumber nullable required

Term budget minus credits used. Negative when over budget.

budgetedDailyCreditsnumber nullable required

Term budget divided by inclusive days from usage start through contract end, rounded to four decimals. Null when the budget is unavailable.

Changes

Oct 31, 2026bc90d1bfa738 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 17, 20264698655f7ecd Revision changes
- info
  added the required property to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history (3 revisions)