残りリクエスト数

当日（JST）の日次上限に対する使用量と残数を返す。この照会自体は日次上限を消費しない。

GET/usage

Authorization

AuthorizationBearer token · headerrequired

IRBANK Connect (app.irbank.net/mcp-api) で発行した API キー

Responses

200OK

limitintegerrequired

1 日あたりの上限

usedintegerrequired

当日の使用数

remainingintegerrequired

残数

resets_atstringrequired

カウンタがリセットされる時刻（次の JST 0 時）

401API キーが無い・無効

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

Request

curl -X GET "https://api.irbank.net/v1/usage" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.irbank.net/v1/usage", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.irbank.net/v1/usage",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "limit": 200,
  "used": 12,
  "remaining": 188,
  "resets_at": "2026-07-29T00:00:00+09:00"
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}