---
title: "Get Plan Usage"
method: GET
path: "/automation/get-plan-usage"
---

# Get Plan Usage

`GET /automation/get-plan-usage`

## Request

- Base URL: `https://public.reap.video/api/v1`
- URL: `https://public.reap.video/api/v1/automation/get-plan-usage`
- Auth: HTTP bearer

Get the current plan and credit usage so you can check remaining credits before submitting projects

## Response `200`

Successful response

- PlanUsageResponse
  - `plan` string: User-friendly plan label, e.g. "Studio (Monthly)"
  - `mediaCredits` CreditPool
    - `total` integer: Effective spendable cap, including active top-ups
    - `used` integer: Credits consumed this cycle. Can exceed total when overage occurred.
    - `remaining` integer: max(0, total - used)
  - `aiCredits` CreditPool
    - `total` integer: Effective spendable cap, including active top-ups
    - `used` integer: Credits consumed this cycle. Can exceed total when overage occurred.
    - `remaining` integer: max(0, total - used)
  - `maxConcurrentProjects` integer: How many automation projects can process at once on this plan
  - `projectRetentionDays` integer: How long completed projects are kept before expiry
  - `resetsOn` integer: Unix timestamp when the usage counters reset

## Changes

- **2026-11-03** `4dd80bac4a44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reap/apis/reap-automation-api/changes/automation/get-plan-usage/get.md)

---

[API](https://skmtc.dev/reap/apis/reap-automation-api.md) - [All operations](https://skmtc.dev/reap/apis/reap-automation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reap/apis/reap-automation-api/revisions/7aa7efa065a5?raw)