---
title: "Check verification credit balance"
method: GET
path: "/v1/credits"
tags: ["Keys & Billing"]
---

# Check verification credit balance

`GET /v1/credits`

## Request

- Base URL: `https://api.insumermodel.com`
- URL: `https://api.insumermodel.com/v1/credits`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `Authorization`

Returns the verification credit balance, tier, and daily rate limit for the authenticated account. Authentication: this endpoint accepts EITHER the X-API-Key header OR the Authorization: Wallet header (SIWE envelope from a wallet that holds the Insumer Access pass).

## Response `200`

Credit balance

- object
  - `ok` true
  - `data` object
    - `apiKeyCredits` integer
    - `tier` 'free' | 'pro' | 'enterprise' | 'paid' | 'x402': "paid" is the tier of wallet-native keys purchased with crypto via POST /v1/keys/buy. "x402" is the pay-per-call identity tier: the key record auto-created for a wallet that pays per call via x402 (0 stored credits; each call is paid at the transport layer).
    - `dailyLimit` integer
  - `meta` Meta
    - `version` string
    - `timestamp` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `429`: Rate limit exceeded. API-key requests count against the key's daily limit; every authenticated response carries X-RateLimit-Limit and X-RateLimit-Remaining headers, and a 429 additionally carries Retry-After (seconds until the window resets).
- `500`: Unexpected server error. Safe to retry; no credits are charged on a 500. Router endpoints return the standard error envelope; standalone endpoints (the ones whose 200 is a flat object) return a flat {"error": "..."} object.
- `503`: Transient service condition on wallet-auth calls (for example the wallet-auth nonce store being temporarily unavailable). Retryable after a short delay.

---

[API](https://skmtc.dev/insumermodel/apis/insumerapi.md) · [All operations](https://skmtc.dev/insumermodel/apis/insumerapi/llms.txt) · [OpenAPI document](https://skmtc.dev/insumermodel/apis/insumerapi/revisions/91f56fe9e3d8?raw)