---
title: "Reset chances"
method: GET
path: "/resets"
tags: ["Billing"]
---

# Reset chances

`GET /resets`

## Request

- Base URL: `https://console-api.blockvectra.com/v1`
- URL: `https://console-api.blockvectra.com/v1/resets`
- Auth: HTTP bearer

List active reset chances ordered by expiration, including fully used but unexpired chances. items is empty when no chances apply. available is the sum of remaining chances; next_expires_at is null when none remain. reset_to_units is the target balance for the next use.

## Response `200`

Reset chances.

- ResetsResponse
  - `available` integer, required: Sum of remaining chances across all active rounds.
  - `next_expires_at` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
  - `reset_to_units` integer, required: Target balance replenished to by next use (units).
  - `items` ResetChanceView[], required
    - `round` string, required: Round identifier; monthly rounds formatted as `<id>-YYYY-MM` (e.g. `monthly-2026-10`).
    - `available_from` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
    - `expires_at` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
    - `total` integer, required: Number of chances granted to this account in this round.
    - `used` integer, required: Number of chances used.
    - `remaining` integer, required: `max(0, total - used)`.

## Other responses

- `401`: Missing or invalid session (without distinguishing cause).
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

[API](https://skmtc.dev/blockvectra/apis/blockvectra-console-api.md) · [All operations](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/revisions/28c91298f433?raw)