# API credit balance: GET /v1/credits

Your organization's API credits: the balance, what running jobs hold, and what is available.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (any key)
- Cost: free
- Answers at once.

## Request

```bash
curl https://api.magistermarketing.com/v1/credits \
  -H "Authorization: Bearer $MAGISTER_API_KEY"
```

## Response (a real call, 2026-11-12, trimmed)

```json
{
  "data": {
    "balance": 300,
    "held": 0,
    "available": 300,
    "price_per_credit_usd": 0.02
  },
  "credits_charged": 0,
  "request_id": "aa3cd5b7-e17a-4535-9bf5-432fa1a80357"
}
```

The whole API reference, for an agent: https://magistermarketing.com/docs/api.md