Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bytestack.com/llms.txt

Use this file to discover all available pages before exploring further.

ByteStack offers a free tier for getting started and paid plans for teams that need more queries, private sources, or advanced features. This page explains how billing works, what counts as a query, how failed payments are handled, and what happens to your data when you cancel.

​
Free tier

The free tier includes 1,000 queries per month against ByteStack’s public source list. There is no credit card required to sign up. If you reach your monthly limit, queries return a 429 error until the next billing cycle begins. You can upgrade to a paid plan at any time from Settings → Billing. Paid plans are billed on a monthly cycle with two components:
  • Subscription fee — billed monthly in advance at the start of each billing cycle.
  • Usage overages — any queries beyond your plan’s included allowance are metered and billed monthly in arrears at the end of the cycle.
This means your first charge when upgrading covers the subscription for the current month. Any overage from that month appears on the following month’s invoice.

​
What counts as a query

Each call to POST /v1/queries counts as one query against your monthly allowance — regardless of how many records are returned or how many sources ByteStack fetches from to fulfill it. Retries of the same request each count separately.

​
Upgrading or downgrading

You can change your plan at any time from Settings → Billing. Upgrades take effect immediately; the price difference is prorated for the remainder of the billing cycle. Downgrades take effect at the start of the next billing cycle.

​
Failed payments

If a payment fails, ByteStack enters a 7-day grace period:
1

Payment fails

Your card is declined or a charge cannot be collected. ByteStack sends an email notification and retries automatically.
2

Grace period begins

For the 7 days following the failed charge, the API continues to accept requests but returns a 402 Payment Required status on every response. Your integration will still function, but you should resolve billing as soon as possible.
3

Account becomes read-only

If payment is not resolved within 7 days, your account switches to read-only mode. You can still view your dashboard and export data, but new queries are blocked until billing is restored.
4

Restore billing

Update your payment method in Settings → Billing → Payment method to immediately restore full access.

​
Cancellation and data retention

You can cancel your subscription at any time from Dashboard → Settings → Billing → Cancel. For paid plans, ByteStack requires 30 days’ notice before termination takes effect. During that notice period, your plan remains active and you continue to have full access. After termination, your account enters a 60-day export-only window. During this period you can download your data but cannot run new queries. After 60 days, all stored data — queries, outputs, and account records — is permanently purged.
The 60-day export window is the only opportunity to retrieve your data after cancellation. Once it closes, your data cannot be recovered. Download your full archive from Settings → Privacy → Export before the window expires.

​
Data export

You can download a signed JSON archive of all your queries, account records, and audit events at any time from Settings → Privacy → Export. The archive is generated immediately — no support ticket required.
For questions about invoices, payment disputes, or billing adjustments, contact the ByteStack billing team at legal@bytestack.dev. Responses are typically sent within three business days.