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

# Check Usage

> Get credit balance and usage statistics

Returns your current plan, credit balance, and monthly usage breakdown by capability.

### Response (200 OK)

<ResponseField name="plan_tier" type="string">
  Current plan: `free`, `starter`, `growth`, or `scale`.
</ResponseField>

<ResponseField name="credits_remaining" type="integer">
  Credits available for use.
</ResponseField>

<ResponseField name="credits_monthly" type="integer">
  Total monthly credit quota for your plan.
</ResponseField>

<ResponseField name="credits_reset_at" type="string">
  ISO 8601 timestamp of next monthly credit reset.
</ResponseField>

<ResponseField name="footage_health" type="object">
  Defect rates across the videos you have already processed — how many were
  measured, how many had something wrong, and which defects, most common first.

  **Measurements, not a verdict.** Whether any of these matter depends on what
  you do with the footage, which is what [Check Readiness](/api-reference/check-readiness)
  answers for a given use. A clip stored sideways is a defect for frame
  extraction and a non-event for an editor.

  Jobs that ran without diagnostics are excluded rather than counted as clean —
  counting an unmeasured video as healthy would report better footage than you
  have. `share_with_defects` is `null` rather than `0` when nothing has been
  measured yet, for the same reason.

  Only counts jobs processed since this began being recorded; it says nothing
  about older ones.
</ResponseField>

<ResponseField name="usage_this_month" type="object">
  Monthly usage breakdown.

  <Expandable title="Usage fields">
    <ResponseField name="total_credits" type="integer">
      Total credits consumed this month.
    </ResponseField>

    <ResponseField name="total_requests" type="integer">
      Total API requests this month.
    </ResponseField>

    <ResponseField name="by_capability" type="object">
      Credits consumed per capability: `classify`, `thumbnails`, `diagnostics`, `duplicates`, `clips`, `transcribe`.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.fastdrop.io/api/v1/usage \
    -H "X-API-Key: fd_live_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "plan_tier": "starter",
    "credits_remaining": 126,
    "credits_monthly": 150,
    "credits_reset_at": "2026-04-01T00:00:00Z",
    "footage_health": {
      "videos_measured": 120,
      "videos_with_defects": 17,
      "share_with_defects": 0.14,
      "by_defect": { "vfr": 11, "hevc": 6, "rotation_metadata": 4 },
      "note": "Measurements from videos you already processed, not a verdict."
    },
    "usage_this_month": {
      "total_credits": 24,
      "total_requests": 8,
      "by_capability": {
        "classify": 16,
        "thumbnails": 4,
        "diagnostics": 4,
        "duplicates": 0,
        "clips": 0,
        "transcribe": 0
      }
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.