Get Credits

Send a GET request to this endpoint to see how many credits your account has left, for example before a bulk render.

You will need to authenticate to use this API. See authentication.

Request


GET https://api.ojo.so/v1/credits

cURL


curl --request GET \
  --url https://api.ojo.so/v1/credits \
  --header 'Authorization: Bearer <your API key>'

Python


import requests
 
url = "https://api.ojo.so/v1/credits"
headers = {"Authorization": "Bearer <your API key>"}
 
response = requests.get(url, headers=headers)
print(response.text)

JavaScript


const response = await fetch('https://api.ojo.so/v1/credits', {
  headers: { Authorization: 'Bearer <your API key>' },
});
 
console.log(await response.json());

Response

200

Your current credits.


{
  "left": 2741,
  "total": 3000,
  "expiresAt": "2026-11-26T09:12:44Z"
}

Field	Type	Description
left	number	Credits you can still spend
total	number	Credits your current batches held, spent ones included
expiresAt	string or null	When the last current batch expires. `null` when you have no credits

A plan adds a batch every billing period. See pricing for what a credit buys.

401

Your API key might be invalid or expired.


{
  "error": true,
  "message": "Unauthorized",
  "status": 401,
  "title": "Unauthorized",
  "detail": "Unauthorized"
}

429

You have hit your rate limit. You can view rate limit details here.


{
  "error": true,
  "message": "Credits rate limit reached: 30 requests per minute",
  "logs": ["Try again in 30 seconds."],
  "code": "rate_limited.credits",
  "retryAfter": 30,
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Credits rate limit reached: 30 requests per minute"
}

500

An unexpected error occurred. Try again later. If the issue persists, please reach out.


{
  "error": true,
  "message": "Internal Server Error",
  "status": 500,
  "title": "Internal Server Error",
  "detail": "Internal Server Error"
}