Get Plan Usage
curl --request GET \
--url https://public.reap.video/api/v1/automation/get-plan-usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://public.reap.video/api/v1/automation/get-plan-usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.reap.video/api/v1/automation/get-plan-usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public.reap.video/api/v1/automation/get-plan-usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://public.reap.video/api/v1/automation/get-plan-usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public.reap.video/api/v1/automation/get-plan-usage")
.header("Authorization", "Bearer <token>")
.asString();{
"plan": "Studio (Monthly)",
"mediaCredits": {
"total": 123,
"used": 123,
"remaining": 123
},
"aiCredits": {
"total": 123,
"used": 123,
"remaining": 123
},
"maxConcurrentProjects": 123,
"projectRetentionDays": 123,
"resetsOn": 123,
"autoTopUp": {
"enabled": true,
"creditsPerTopUp": 1000,
"minimumCredits": 123,
"monthlyLimit": 123,
"usedThisMonth": 123,
"active": true,
"turnedOffReason": "card_failed"
}
}Billing & Usage
Get Plan Usage
Check your current plan, credit balances, and limits before submitting projects
GET
/
automation
/
get-plan-usage
Get Plan Usage
curl --request GET \
--url https://public.reap.video/api/v1/automation/get-plan-usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://public.reap.video/api/v1/automation/get-plan-usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://public.reap.video/api/v1/automation/get-plan-usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public.reap.video/api/v1/automation/get-plan-usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://public.reap.video/api/v1/automation/get-plan-usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public.reap.video/api/v1/automation/get-plan-usage")
.header("Authorization", "Bearer <token>")
.asString();{
"plan": "Studio (Monthly)",
"mediaCredits": {
"total": 123,
"used": 123,
"remaining": 123
},
"aiCredits": {
"total": 123,
"used": 123,
"remaining": 123
},
"maxConcurrentProjects": 123,
"projectRetentionDays": 123,
"resetsOn": 123,
"autoTopUp": {
"enabled": true,
"creditsPerTopUp": 1000,
"minimumCredits": 123,
"monthlyLimit": 123,
"usedThisMonth": 123,
"active": true,
"turnedOffReason": "card_failed"
}
}
For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.
Overview
Get your studio’s current plan and credit usage. Use this to check remaining credits before submitting a project instead of parsing rejection errors — especially useful for agents and automated pipelines that batch work.Response
Media credit pool (clipping, captions, reframing, transcription, audiograms, editor processing)
AI credit pool (dubbing, AI voiceovers, emoji highlighter). Same
{total, used, remaining} shape.Auto top-up settings, or
null if auto top-up was never set up. An admin turns it on and changes it in the reap app.Show Auto Top-Up
Show Auto Top-Up
Media credits one automatic top-up adds. When more is needed, one charge buys several top-ups at once.
Whether auto top-up can add credits right now.
false while it is off, or while it is on but paused (the plan is inactive or its payment failed).Credit Costs
Credits are consumed per billed minute of video. The multipliers by project type:| Project type | Cost |
|---|---|
| Clipping | 1 media credit / minute |
| Captions | 1 media credit / minute |
| Transcription | 1 media credit / minute |
| Audiogram | 1 media credit / minute |
| Reframe | 2 media credits / minute |
| Editor processing | 2 media credits / minute |
| Dubbing | 0.5 AI credits / minute |
While auto top-up is on, projects keep starting when media credits run out: the saved card is charged within seconds and the credits are added. Until then
remaining shows 0. If the monthly limit is reached or a payment fails, new projects need credits again before they start.If your plan was purchased through AppSumo,
remaining may temporarily overstate spendable credits during the first 31 days after purchase (a refund-window safeguard). If a submission is rejected despite showing remaining credits, contact support.Example Request
curl -X GET "https://public.reap.video/api/v1/automation/get-plan-usage" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://public.reap.video/api/v1/automation/get-plan-usage', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const usage = await response.json();
if (usage.mediaCredits.remaining < 30) {
console.log('Low on media credits — top up before submitting');
}
import requests
response = requests.get(
'https://public.reap.video/api/v1/automation/get-plan-usage',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
usage = response.json()
print(f"{usage['plan']}: {usage['mediaCredits']['remaining']} media credits left")
Example Response
Rate Limiting
This endpoint allows 60 requests per minute per API key. Each endpoint has its own budget, so this allowance is not shared with the rest of the API — see Rate limiting.Next Steps
- Low on media credits? Get a checkout link with Top Up Media Credits
- Changing plans? Get a billing portal link with Manage Subscription
Authorizations
Response
200 - application/json
Successful response
Was this page helpful?