Documentation
Account and billing
Signing up, confirming your email, the trial and Spark, the free plan, paying by Razorpay, Stripe or PayPal, GST invoices, plan changes, refunds, and where to see service levels.
Signing up
Create an account with email and password, or with Google when the Google button is shown. The form asks for:
| Detail | Required | Notes |
|---|---|---|
| Name, email, password | Yes | The password is 10 to 128 characters |
| Country | Yes | Sets your billing currency (see Paying) |
| Individual or company | Yes | A company name is required for a company |
| Phone | No | With the country code, for example +919876543210 |
| Website | No | |
| GSTIN | No | Indian accounts only; checked for its structure and check character when you save |
| What you plan to build | No | One of a short list; helps us support you |
| Terms and privacy policy | Yes | You must accept both. A marketing opt-in is separate and optional |
Confirm your email. We send a confirmation link and you cannot sign in until you open it. If it does not arrive within a few minutes, check your spam folder. Opening the link activates the account.
Onboarding. Signing up with Google skips the password and email steps, but the same details are collected once on a short page before the dashboard opens. Accounts created before these details existed see that page once too. Your trial starts when you continue.
Signing in. Use your email and password, Google, or a one-time code by email: on the sign-in page choose Email me a sign-in code instead and enter the 6-digit code we send (valid for 10 minutes, 5 tries). Codes only sign in an existing account. An account with two-factor sign-in cannot use email codes; it signs in with its password and authenticator code.
Your session lasts 7 days. You can add two-factor sign-in (an authenticator app with backup codes) to your account; it is optional for customers. Passwords are reset from Forgot password. Changing your email asks you to confirm the link sent to your current address first, then the one sent to the new address.
What you start with
| Trial | Spark (the free plan) | |
|---|---|---|
| When | The first 14 days, no card | After the trial, or after a paid plan ends |
| Live credits | 5,000, expiring with the trial | 1,000 on the 1st of every month (UTC); unused credits do not carry over |
| Sandbox | 500 calls a day | 500 calls a day |
| AI readings, and PDF and audio jobs | Yes | No on live keys (403 plan_upgrade_required); sandbox keys can still test them |
Details of limits and headers are in Credits and rate limits. Choosing a paid plan replaces Spark at once. Plans and what they include has every plan and way to pay.
Organizations, teams and data
Every account has an organization that owns the plan, credits, invoices and keys; you can invite teammates with roles and split keys into projects: see Teams and projects. Under Your data in the dashboard you can ask for an export of your data or for your account to be deleted.
Paying
Plans are monthly, or yearly at ten months' price. See pricing for the plans, the credits each grants and the top-up packs; prices exclude GST.
- Providers. Checkout can use Razorpay, Stripe or PayPal, depending on which are switched on. Buyers in India are offered Razorpay first, then Stripe, then PayPal; everyone else Stripe, then PayPal, then Razorpay. When more than one is offered you choose under Pay with. A provider is hidden when it cannot charge your currency.
- Currency. Accounts in India pay in INR and all others in USD. PayPal charges USD only. The country cannot be changed while a plan is active.
- A browser "success" grants nothing. Credits and plans are granted only when the provider confirms the payment to us, so a closed tab or a slow redirect never loses or doubles a payment. Payments you make twice for the same thing are detected and the second is refunded automatically.
- Test mode. While payments are in test mode, checkout is open only to testers, uses the provider's test cards, and moves no real money. Its invoices are numbered
TEST-and are not tax invoices.
GST and invoices
- GST is added at checkout. In India the invoice splits it as CGST and SGST for a buyer in the seller's state, and IGST for any other state; the place of supply is the state of your GSTIN, or your billing-address state without one. Buyers outside India are invoiced for an export of services; where we do not hold the required undertaking the invoice charges IGST and says so.
- Add your GSTIN and billing address under Billing for a B2B tax invoice. Only an active GSTIN is accepted.
- Every payment gets a numbered GST invoice, a refund gets a credit note, and both are under Billing as PDFs. We email you when one is issued.
- Owners pay and change plans, and members with the Billing role manage the billing profile and invoices; admins and viewers can see billing but not change it (roles).
Plan changes, renewals and cancelling
- Credits are granted at the start of each monthly period, also on a yearly plan (twelve monthly grants). Plan credits expire at the end of their period.
- Upgrade: takes effect now; the price difference is charged pro rata and the extra credits for the rest of the month are granted. Downgrade: takes effect at the next renewal. Monthly to yearly (or back): cancel and subscribe again. A plan paid through PayPal cannot be changed in place either: cancel it and subscribe to the new plan.
- Cancel from Billing. The plan and its credits stay until the end of the paid period, then the account moves to Spark, the free plan.
- Top-ups add credits on a paid plan and last until the end of the current billing term. Plan credits are used first, then top-ups, then overage if you turned it on.
- If a renewal payment fails, the plan gets 7 days of grace in which live calls still work, and we email you; plans with webhooks also get a webhook (
billing.payment_failed). After that, live calls answer402 payment_requireduntil the payment goes through; sandbox keys keep working. - Refunds follow the refunds and cancellation policy: they go back to the original payment method, with a credit note, and remove the unused credits they paid for.
Reliability and support
- Status shows the live state of the API and its history.
- The service levels page states each plan's uptime target, how uptime is measured and when service credits apply.
- Support is by email and the support form; quote the
request_idof a failing call. - Maintenance windows and switched-off capabilities answer
503withmaintenanceortemporarily_unavailableand are never charged: see Errors.


