Credits & Billing

Pricing, per-endpoint credit costs, balance API, usage reporting, and top-up flow.

Scanner uses a prepaid credit model. You’re granted credits when your key is issued (free tier or invoiced), and each scan/batch/test debits your balance. Reads are always free.

Pricing

List price: $0.05 per credit. One scan is a nickel; a synthetic shopping test is a quarter. Reads cost nothing.

Action	Credits	Price
Single scan	1	$0.05
Batch of 100 domains	50	$2.50
Batch of 500 domains	250	$12.50
Batch of 5,000 domains	2,500	$125
Synthetic shopping test	5	$0.25
All reads (shared corpus)	0	Free

Credit packs

Buy in bulk for a per-credit discount. Packs don’t expire — unused credits sit on your tenant until consumed.

Pack	Credits	Price	Effective $/credit
Starter	5,000	$200	$0.040
Growth	25,000	$750	$0.030
Scale	100,000	$2,000	$0.020
Enterprise	500,000+	Custom	~$0.015

Contact [e-mail] to purchase a pack or discuss enterprise pricing.

Design-partner program (free beta)

We’re onboarding the first 3–5 partners as design partners in exchange for product feedback and a case study. You get:

• 2,500 free credits up front (enough for ~3 months of typical usage at a small shop).
• Scale pricing ($0.020/credit) locked in for 12 months after the free credits exhaust.
• First-right-of-refusal on new scanner features before public launch.

What we ask in return:

• A logo + 1 case study we can reference on the Sly site and in sales decks.
• A 30-min monthly feedback call with your product lead for 6 months.
• An early-bird testimonial with a 2-week turnaround.

Interested? Email [e-mail] with your use case and expected monthly scan volume.

Credit costs

Endpoint	Cost
POST /v1/scanner/scan	1
POST /v1/scanner/scan/batch	0.5 per target (rounded up)
POST /v1/scanner/tests	5
GET /v1/scanner/scan/:id	0
GET /v1/scanner/scans, scans/stats, scans/protocol-adoption, scans/by-domain/:id	0
GET /v1/scanner/prospects, prospects/heat-map, prospects/export	0
GET /v1/scanner/reports/*, observatory/*, snapshots/*	0
GET /v1/scanner/credits/*, usage	0

Check your balance

curl -H "Authorization: Bearer $SCANNER_KEY" \
  https://scanner.getsly.ai/v1/scanner/credits/balance

{
  "balance": 8432,
  "grantedTotal": 10000,
  "consumedTotal": 1568
}

Insufficient-credit errors

When your balance is below the cost of a requested operation, the endpoint returns:

// HTTP 402 Payment Required
{
  "error": "insufficient_credits",
  "balance": 0,
  "required": 1,
  "docs": "https://docs.getsly.ai/scanner/credits-and-billing"
}

Handle this in your integration by falling back to cached data, queueing for later, or notifying the operator.

Ledger

Every debit and grant is recorded in an append-only ledger. Retrieve history:

curl -H "Authorization: Bearer $SCANNER_KEY" \
  "https://scanner.getsly.ai/v1/scanner/credits/ledger?from=2026-04-01&limit=100"

Each entry:

{
  "id": "uuid",
  "delta": -1,
  "reason": "consume",
  "source": "request:e4f2...",
  "balance_after": 8432,
  "metadata": { "endpoint": "POST /v1/scanner/scan", "key_id": "uuid" },
  "created_at": "2026-04-22T10:15:03Z"
}

reason is one of: grant, consume, refund, adjustment. refund appears when a batch is cancelled before workers process the remaining targets.

Usage reporting

Aggregated per-endpoint or per-day usage is available at /v1/scanner/usage:

curl -H "Authorization: Bearer $SCANNER_KEY" \
  "https://scanner.getsly.ai/v1/scanner/usage?group_by=day&from=2026-04-01"

Returns request counts, credits consumed, error counts, and total request duration per bucket. Useful for chargeback reports and tracking which endpoints dominate your spend.

Topping up

Partners can top up in two ways:

1. Invoiced — pay your Sly invoice; credits are granted against your tenant within 1 business day (source tag references the invoice).
2. Prepaid bundles — purchase credit packs in the Sly dashboard. Instant grant.

Both appear in your ledger with reason: "grant".

Cancelling a batch

curl -X DELETE -H "Authorization: Bearer $SCANNER_KEY" \
  https://scanner.getsly.ai/v1/scanner/scan/batch/<batch_id>

Unprocessed targets are refunded at 0.5 credits each. Already-processed targets are not refunded.