Check usage

What to send

Run the example with your API key. You don't need to send a file, review ID or any other values.

What you get back

Your current usage cycle, total allowance, units used and units remaining. All unit amounts use milli-units: 1,000 milli-units = 1 review unit.

periodobject: startsAt and endsAt are ISO 8601 timestamps for the current usage cycle.
includedUnitsMilliinteger: Review allowance included in this cycle.
consumedUnitsMilliinteger: Units settled for successfully completed reviews.
remainingUnitsMilliinteger: Included allowance minus consumed units. Pending reviews also reserve capacity, so this number alone does not guarantee admission for a new request.

The full response also includes contractId, overageUnitsMilli, overageAmountMicros, currency and unitFormulaVersion.

The job's usage.estimatedUnitsMilli is calculated at submission. usage.finalUnitsMilli records the settled amount. Failed and cancelled reviews charge zero units.

Request example

curl --fail-with-body -X GET 'https://www.steletta.com/api/v1/usage' \
  -H "Authorization: Bearer $STELETTA_API_KEY"

Example response · Usage excerpt (975 units remaining)

{
  "period": {
    "startsAt": "2026-09-01T00:00:00Z",
    "endsAt": "2026-10-01T00:00:00Z"
  },
  "includedUnitsMilli": 1000000,
  "consumedUnitsMilli": 25000,
  "remainingUnitsMilli": 975000
}