Credits

Understand how credits work and manage your balance.

What Are Credits?

Credits are the currency for API calls in agntdata. Each API request consumes credits based on the endpoint’s cost. Your workspace has two credit sources:

1. Subscription allowance — Monthly credits included with your plan
2. Purchased balance — Additional credits you’ve purchased

How Credits Work

1. Make API Calls

   Each successful API call deducts credits based on the endpoint cost.

2. Plan Discount Applied

   Your plan tier discount is applied to the base cost.

3. Credits Deducted

   Credits are first taken from your subscription allowance, then from purchased balance.

Understanding Credit Costs

Each endpoint has a base cost in cents. The actual cost depends on your plan’s discount percentage:

Actual Cost = Base Cost × (100 - Discount %) / 100

The response includes your remaining balance:

{
  "success": true,
  "data": { ... },
  "meta": {
    "costCents": 1,
    "purchasedBalanceCents": 949,
    "subscriptionRemainingCents": 500,
    "cached": false,
    "latencyMs": 245
  }
}

Field	Description
costCents	Credits charged for this request
purchasedBalanceCents	Remaining purchased credits
subscriptionRemainingCents	Remaining subscription credits this month

Checking Your Balance

Via Dashboard

Your credit balance is displayed in the dashboard.

Via API

Check programmatically:

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

Purchasing Credits

Add credits to your workspace from the dashboard:

1. Go to Settings → Billing
2. Select a credit amount
3. Complete payment via Stripe
4. Credits are added immediately

Subscription vs Purchased Credits

Type	Description
Subscription	Monthly allowance that resets each billing cycle
Purchased	One-time purchase, used after subscription allowance is depleted

Credits are consumed in this order:

1. Subscription allowance first
2. Purchased balance second

Workspace Credit Sharing

Credits belong to workspaces, not individual users:

• All API keys in a workspace share the same credit pool
• Team members see the same balance
• Usage is aggregated at the workspace level

Insufficient Credits

When you don’t have enough credits, requests return an error:

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits to complete this request"
  }
}

Next Steps

Usage Monitoring

Track your API usage over time.

Rate Limits

Understand request limits.