Credits & pricing

Credits & pricing

DomScan includes 10,000 free credits per month. No credit card required. We'll give plenty of notice before any pricing changes.

Credits refresh monthly on signup anniversary. Need more credits? Purchase packs that never expire:

Credits per endpoint

Find common endpoint costs below. Some reference endpoints are free. For the complete, machine-readable rate card, use /v1/pricing.

Credit enforcement

When your credits reach zero, API requests that cost credits return HTTP 402 (Payment Required). Free browser-based tools are not affected.

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

Need more credits? Purchase packs that never expire:

Credits refresh monthly on signup anniversary.

Credit response headers

All authenticated API responses include an X-Credits-Remaining header showing your current credit balance after the request.

Every authenticated /v1 response, including errors, carries these headers:

• X-Credits-Charged: credits this request charged, net of any refund made in the same request (0 when nothing was charged).
• X-Credits-Remaining: your balance after the request. It is left out in the rare case the balance is not already known.
• X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset: your burst capacity, the requests you can still send immediately, and the Unix time in seconds when the capacity is fully refilled.
• MCP over HTTP returns X-Credits-Charged and X-Credits-Remaining for the tool calls in each request.

Estimate the cost before running

Send the method, path, query and body of a request to POST /v1/estimate to get the credits it would charge, with a breakdown and notes. Nothing is executed and the estimate costs 0 credits. When the final charge depends on the outcome, the estimate is the maximum and a note explains why.

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Requests rejected with a 4xx status or failing with a 5xx status are refunded automatically."],
  "maximum": false,
  "rejected": false
}

Bulk, compare, recipe and pricing endpoints also accept dry_run=true. The request is answered with HTTP 200 and the same estimate plus "dry_run": true, without running it or charging credits.

Credit calculator

Estimate your credit usage for bulk operations:

Credit packs

Need more credits? Purchase packs that never expire: