---
title: "This key's credits and the billing rule"
method: GET
path: "/api/v1/credits"
---

# This key's credits and the billing rule

`GET /api/v1/credits`

## Request

- Base URL: `https://macfax.com`
- URL: `https://macfax.com/api/v1/credits`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

Balance, tier and what is billable, for the key on the request. Read it before starting a batch rather than discovering the wall mid-job. One credit answers one distinct serial, any Apple device and any year, and the same serial again within 24 hours is free. Answers that come back retry or unsupported, and every endpoint other than lookup, are never charged. Credits are prepaid and do not expire. Rate limits: 20/min and 500/day per anonymous IP; 200/min and 5000/day with a free key.

## Response `200`

Balance, billing rule and the price list.

## Other responses

- `401`: No key on the request; credits belong to a key.
- `429`: Rate limited.

---

[API](https://skmtc.dev/macfax/apis/macfax-api.md) · [All operations](https://skmtc.dev/macfax/apis/macfax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/macfax/apis/macfax-api/revisions/ce892dbbd7d5?raw)