Credits Balance

The Credits endpoint lets you check your current TryItOn API credit balance. The response shows your total credits, any credits from an active API subscription, and any custom-bought credits.

Credit Usage

• Subscription Credits: Included with your monthly API plan

• Purchased Credits: Additional tryons purchased separately

• Reserved Credits: Reserved tryons which are currently being processed

• On-demand Credits: (Subscription credits + Purchased credits) - Reserved credits

Request

Check your current credits balance by making a GET request to the credits endpoint:

GET https://tryiton.now/api/v1/credits

Call this endpoint whenever you need to know how many credits you have remaining.

Request Examples

cURL

curl -X GET https://tryiton.now/api/v1/credits \
     -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

Python

Response

200

Example response payload

Response

{
  "credits": {
    "on_demand": 149,
    "subscription": 50,
    "purchased": 100,
    "reserved": 1
  }
}

Response Fields

credits (object) Container object for all credit information.
on_demand (integer) Currently available credits (subscription + on-demand credits - reserved credits).
subscription (integer) Credits included with your current API subscription plan. These credits reset monthly based on your billing cycle.
purchased (integer) Additional credits purchased separately from your subscription. These credits do not expire.
reserved (integer) Reserved tryons which are currently being processed.

Rate Limits

The credits endpoint has its own specific rate limit:

Endpoint	Limit
/api/v1/credits	300 requests per 60 seconds

For other endpoints, see the default rate limits in API Fundamentals.