---
title: "Payg Availability"
method: GET
path: "/api/v1/payg/availability"
tags: ["payg"]
---

# Payg Availability

`GET /api/v1/payg/availability`

## Request

- Base URL: `https://qcode.cc` (the document declares no server; this is the origin it was published from)
- URL: `https://qcode.cc/api/v1/payg/availability`
- Auth: none declared

公开：各档今天是否售罄（只有状态，不含件数）与下一次 10:00。公开页是边缘快照，前端拉这个接口。
?me=1：已登录再叠加本人状态（今日已买 / 续买锁定）与 renew 三个数，取 /status 的同一份缓存，不另读 CRS。

## Query parameters

- `me` integer

## Response `200`

Successful Response

- PaygAvailabilityResponse: GET /availability：公共 = 各档 available / sold_out；?me=1 且已登录 = 本人四态 + renew。
  - `success` boolean, required
  - `packs` object, required
  - `next_reset_in_s` integer, required
  - `reset_is_today` boolean, required
  - `renew` PaygRenewInfo: payg_renew_usage_low：本期额度已用百分比、需要的百分比、还差多少美元（不含任何库存信息）。
    - `locked` boolean, required
    - `used_pct` integer, nullable
    - `need_pct` integer, nullable
    - `need_usd` number, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `2175943cc01f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qcode/apis/qcode-web/changes/api/v1/payg/availability/get.md)

---

[API](https://skmtc.dev/qcode/apis/qcode-web.md) - [All operations](https://skmtc.dev/qcode/apis/qcode-web/llms.txt) - [OpenAPI document](https://skmtc.dev/qcode/apis/qcode-web/revisions/9632b29aa008?raw)
