Credits & Billing

How Credits Work

Every page of every borehole log you process costs exactly 1 credit. A single-page borehole log costs 1 credit. A 5-page borehole log costs 5 credits. This applies whether you upload from the web app or submit via the API.

When you upload files, BoreholeAI counts the total number of pages across all files and shows you a cost estimate before processing begins. Credits are deducted upfront when you confirm the upload. If a job fails during processing, credits are refunded automatically.

If your credit balance is insufficient for the number of pages being submitted, the upload will be rejected with a 402 error. No partial processing occurs — either the full job is accepted or it is declined. This prevents unexpected partial charges.

Free Credits

Every new account receives free credits upon signup — no payment method required. These credits work exactly like purchased credits and can be used for both web app uploads and API processing.

Additionally, the Playground allows anonymous users to upload up to 2 files within a 24-hour window at no cost. Playground uploads do not consume credits from your account balance.

Credit Packs

Purchase credits in bulk for a lower per-page cost. Three standard packs are available, or you can enter a custom amount at the pay-as-you-go rate.

All prices are in US Dollars (USD). Payments are processed securely via Stripe. For volumes greater than 1,000 credits, contact us at support@boreholeai.com for custom pricing.

Purchasing Credits

You can buy credits from multiple places in the app:

• Credit badge: Click the credit balance in the top navigation bar to open a popover with your current balance and a “Buy Credits” button.
• Plan & Billing page: Navigate to Settings → Plan & Billing to see your plan details, current balance, and purchase credits.
• Upload estimate dialog: When uploading files, if your balance is insufficient, the estimate dialog includes a direct link to purchase credits.
• Low credit banner: When your balance drops below 10 credits, a banner appears at the top of the dashboard with a quick-purchase button.

Selecting a credit pack or entering a custom amount takes you to a Stripe-hosted checkout page. After payment completes, credits are added to your balance immediately and you are redirected back to the app.

Auto-Recharge

Auto-recharge automatically purchases a credit pack when your balance drops below a threshold you set. This is useful if you process documents regularly and want to avoid running out of credits.

Refunds

BoreholeAI automatically refunds credits in the following situations:

• Job failure: If a job fails during processing due to a system error, all credits for that job are refunded to your balance automatically. No action is required on your part.
• Job cancellation: If you cancel a queued or in-progress job from the Jobs page, credits for unprocessed pages are refunded.

Refunds appear as credit transactions in your Usage & Costs activity log with the type “Refund”. Refunded credits are available for use immediately.

Note: Credit refunds restore credits to your BoreholeAI balance. They are not monetary refunds to your payment method. For payment disputes or refund requests, contact support@boreholeai.com.

Invoices & Receipts

All payment receipts are available on the Plan & Billing page. Each receipt includes:

• Date: When the payment was processed.
• Amount: The charge in USD (receipts from before the USD switch show AUD).
• Description: Which credit pack was purchased.
• Status: Payment status (Paid, Pending, Failed).
• Receipt: A link to the Stripe-hosted receipt that you can download or print for accounting purposes.

Both manual purchases and auto-recharge charges appear in the invoices table.

Usage Tracking

The Usage & Costs page provides a detailed view of your credit consumption. It includes:

• Monthly summary cards: Total credits used, total jobs processed, and total pages processed for the selected month.
• Daily usage chart: A bar chart showing pages processed per day, with interactive tooltips for exact counts.
• Activity log: A paginated, sortable table of all credit transactions — job usage, purchases, refunds, signup bonuses, and auto-recharge events — with timestamps and descriptions.
• CSV export: Download the complete activity log as a CSV file for record-keeping, auditing, or integration with your accounting systems.

Both web app uploads and API submissions appear in the activity log. API jobs are labelled as “API request” in the description column so you can distinguish between web app and programmatic usage.

Use the month navigation at the top of the page to view historical usage. The summary cards and chart update to reflect the selected month.

Checking Your Balance via API

When using the Python SDK, the response from process_documents() includes the number of credits used for that job. You can monitor your credit consumption programmatically by tracking the credits_used field in the response.

result = client.process_documents("BH01.pdf", output_dir="./results")
print(f"Credits used: {result.credits_used}")
print(f"Pages processed: {result.num_pages}")

If you attempt to process a document without sufficient credits, the SDK will raise an InsufficientCreditsError with a message indicating how many credits are needed and your current balance.

Frequently Asked Questions