> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Blob アカウント統計

> このドキュメントでは、SquareCloud Blob API の GET /v1/account/stats エンドポイントの概要を包括的に説明します。

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  アカウントの API キーです。これは[アカウント設定](https://squarecloud.app/ja/account/security)で確認できます。
</ParamField>

<Warning>ステータスは 1 分ごとに更新されます。</Warning>

### レスポンス

<ResponseField name="status" type="string">
  呼び出しが成功したかどうかを示します。成功した場合は "success"、失敗した場合は "error" です。
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="オブジェクトを展開">
    <ResponseField name="usage" type="object">
      <ResponseField name="objects" type="number">
        アカウント内のオブジェクトの総数。
      </ResponseField>

      <ResponseField name="storage" type="number">
        アカウント内のすべてのオブジェクトの合計サイズ (バイト単位)。
      </ResponseField>
    </ResponseField>

    <ResponseField name="plan" type="object">
      <ResponseField name="included" type="number">
        プランに含まれるストレージの合計サイズ (バイト単位)。
      </ResponseField>
    </ResponseField>

    <ResponseField name="billing" type="object">
      <ResponseField name="extraStorage" type="number">
        使用した追加の容量 (バイト単位)。
      </ResponseField>

      <ResponseField name="storagePrice" type="number">
        アカウント内のすべてのオブジェクトのストレージ合計金額 (BRL 単位)。
      </ResponseField>

      <ResponseField name="objectsPrice" type="number">
        アカウント内のすべてのオブジェクトの合計金額 (BRL 単位)。
      </ResponseField>

      <ResponseField name="totalEstimate" type="number">
        アカウント内のすべてのオブジェクトの合計金額 (BRL 単位)。
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response - [1m cache] theme={null}
  {
    "status": "success",
    "response": {
      "usage": {
        "objects": 0,
        "storage": 0
      },
      "plan": {
        "included": 0
      },
      "billing": {
        "extraStorage": 0,
        "storagePrice": 0,
        "objectsPrice": 0,
        "totalEstimate": 0
      }
    }
  }
  ```
</ResponseExample>

### トラブルシューティング

<Tabs>
  <Tab title="401 ステータスコード">
    ### 認証エラー

    <CodeGroup>
      ```json ACCESS_DENIED theme={null}
      // The API key is missing or invalid. Set a valid key in the Authorization header.
      {
          "status": "error",
          "code": "ACCESS_DENIED"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="429 ステータスコード">
    ### レート制限

    <CodeGroup>
      ```json RATELIMIT theme={null}
      // Stats rate limit reached (20 requests per 60s window).
      {
          "status": "error",
          "code": "RATELIMIT"
      }
      ```
    </CodeGroup>
  </Tab>
</Tabs>