VERDOCK

Billing and usage

What a credit is, what is free, the plans, how credits are used up, the spend cap, the held queue at zero credits, the usage API and how to check your own bill.

On this page

You pay only for actions that end verified. Everything else is free. Every amount on this page is read from one file, landing-page/public/pricing/prices.json, when the docs are built, so this page, the pricing page and your workspace agree.

What a credit is#

One credit is one payment or record that ends VERIFIED with a signed receipt. A batch counts one credit for each record listed in its receipt.

These are always free:

  • logs and receipts
  • approvals, blocked actions and held actions
  • MISMATCH, and UNKNOWN until it reconciles (an UNKNOWN that reconciles to VERIFIED is charged once)
  • verification, exports, Monitor and the weekly proof report
  • retries with the same idempotency key

Plans#

PlanPrice a monthIncludes
Developerfree1,000 credits, 10 agents, 30 days history
Starter$49 or ₹2,99910,000 credits, unlimited agents, 1 year history
Team$199 or ₹12,99950,000 credits, 3 environments, two approver rules, weekly signed proof report, 3 years history
  • Extra credits cost $3 or ₹249 for each 1,000, only above the cap the owner sets. There are no top up packs.
  • Pay yearly and get 2 months free.
  • 30 day paid evaluation: $1,500 or ₹75,000, credited to year one.
  • Production self hosted, per environment: founding price $6,000 or ₹3,00,000 a year for the first 5 licences, then $9,000 or ₹4,50,000 a year.
  • Air gapped add on: $3,000 or ₹1,50,000 a year.
  • Banks and NBFCs: start with a 30 day paid evaluation. Annual pricing follows it.

How credits are used#

  1. Credits are used in this order: rolled over credits first, then this month's included credits, then purchased credits, oldest first.
  2. Included credits roll over one month, capped at one month's amount.
  3. Purchased credits never expire while the account is open. They are returned on request at closure.
  4. Alerts come at 50, 80 and 100 percent of included credits, with a projected run out date. The workspace shows a banner and sends one email for each threshold each month.
  5. The default spend cap equals your included credits. Auto top up is off until you turn it on. In test mode it stores the setting and takes no payment.
  6. At zero credits a running action finishes and gets its receipt. New actions are held. Verification and exports keep working.
  7. Price changes take effect only at renewal, with 30 days notice.

When credits run out#

Verdock never turns safety off and never cuts an action halfway. An action that is already running finishes, is checked and gets its receipt. New actions go to the held queue with the reason Credit limit reached. Approve, add credits, or raise the cap. They wait there. They are not dropped and they do not run unchecked. Blocked actions stay blocked.

Verification, receipts, exports and Monitor keep working at zero credits. Raising the cap or adding credits lets an owner approve the held items, or release them all from the Usage tab. Each one then runs through the same checks and gets its receipt.

The Usage tab#

The Usage tab in the workspace shows credits used, remaining, included, the purchased balance, the reset date and the projected use at the end of the period from the 7 day average. It breaks use down by agent, by action kind (payout, refund, credit change, data send, exchange) and by environment, with a chart for each day. Every row has a Why was I charged link that opens the signed receipt behind the charge. A row also shows the safety checks done for free: blocked, held, reconciled and verified receipts.

Usage is derived from your receipts. It is never a separate counter, so a recount of the receipts that ended VERIFIED in the period gives the same number. A reconciled count is the number of UNKNOWN results that were settled from the record, and a verified receipts count is the number of times you verified your chain.

Usage API#

GET /v1/usage returns the usage of the workspace that owns the key. Send Authorization: Bearer vk_test_YOUR_KEY. The optional from and to parameters are UTC dates, both included, and the window is at most 366 days. Without them the answer covers the current billing period.

Terminal
curl "https://getverdock.com/v1/usage?from=2026-11-01&to=2026-11-30" \
  -H "Authorization: Bearer vk_test_YOUR_KEY"

The key decides the workspace. Naming another workspace with workspace_id is refused with status 403, and no path reads another workspace's usage. The answer holds used, included, remaining, purchased_balance, period, projection, alerts and a window with the breakdowns, the daily series and the free events.

Exports and the signed statement#

The Usage tab exports a CSV and a signed usage statement. The statement holds counts only: credits, the breakdowns, the free events and the chain head hash. It carries no payloads, no amounts and no account identifiers. It is signed with your workspace Ed25519 key. The button Verify this statement checks the signature in your browser with no network, and one changed byte fails it.

Checking your own bill#

  1. Export the signed statement for the period, and your receipts from the Receipts tab.
  2. Verify the statement. Check that the receipt at the head position in your receipts file hashes to the chain head hash in the statement.
  3. Count the receipts in the period that ended VERIFIED, and add one for each record listed in a batch receipt. The count equals the credits in the statement.
  4. Open Why was I charged on any usage row to see the receipt that produced it.

Offline#

The offline counterpart uses the commands verdock licence, verdock usage, verdock usage export and verdock usage verify. The same rules apply: the counter is derived from the local receipt chain, new actions are held with the credit reason when the quota is used, and evidence never locks. See online and offline usage.

True up#

For licences with an offline quota, you send a quarterly signed usage statement. Verdock invoices any use above the quota at the contract rate. There is no penalty. You can read the statement before you send it.