Knowledge base

    How can we help?

    Guides and answers for J Gene Billing, your J Gene account, and connecting your own software.

    API & integrations

    Connect J Gene Billing to your own software, reports and accounting tools.

    How do I get an API key?

    API access is part of the Enterprise plan, and only the account owner can create keys.

    1. Sign in to J Gene Billing and open Settings.
    2. Find the API access section.
    3. Type a name for the key, such as "Accounting sync", and choose Create key.
    4. Copy the key immediately and store it somewhere safe. It is shown only once.

    Keys start with "jgb_". You can have up to 10 active keys at a time.

    API quickstart
    I lost my API key. Can I see it again?

    No. For your security we store only a fingerprint of each key, never the key itself, so nobody (including us) can show it again.

    Create a new key in Settings → API access, update your integration to use it, then revoke the old one.

    Why does the API answer "401 unauthorized"?

    The API could not match your request to an active key. Check that:

    • The header is exactly "Authorization: Bearer <your key>", with the word Bearer and one space.
    • The key starts with "jgb_" and was copied whole, without extra spaces or line breaks.
    • The key has not been revoked in Settings → API access.
    Authentication
    Why does the API answer "403 plan_required"?

    The account the key belongs to is no longer on the Enterprise plan, which includes API access. Your keys and data are kept: renew Enterprise and the same keys work again.

    See plans
    What are the API's rate limits?

    Each key can make up to 120 requests a minute. Beyond that the API answers 429 rate_limited; wait a minute and retry.

    For large exports, request 100 rows per page (perPage=100) so you need fewer requests.

    Can I create or change data through the API?

    Not yet. The API is read-only: it can list products, customers, invoices, transactions and expenses, and fetch a single invoice with its items. It cannot create, change or delete anything.

    To bring data in, use Import CSV/Excel inside the app (Business plan and above). If your integration needs to write data, tell us what you are building.

    Contact us
    How do I sync new invoices to my accounting software?

    Poll the invoices endpoint for anything created since your last sync:

    GET https://sherut.j-gene.com/api/v1/invoices?from=2026-10-01T00:00:00Z&perPage=100
    • Save the time of each successful sync and use it as the next from value.
    • Add status=PAID to sync only settled invoices; paidAt tells you when each was paid.
    • List results don't include line items. Fetch /invoices/{id} for each invoice that needs them.
    • Keep requesting pages until page equals pagination.totalPages.
    List invoices reference
    How should I keep my API key safe?
    • Use the key only from a server, never in a website, mobile app or browser extension.
    • Store it in an environment variable or secret manager, not in code or a shared document.
    • Use one key per integration so you can revoke them separately.
    • If a key may have leaked, revoke it in Settings → API access straight away. It stops working immediately.
    Best practices

    Plans & payments

    What each J Gene Billing plan includes, and how upgrading and renewals work.

    What does the Free plan include?
    • 50 bills and invoices a month
    • 5 quotations a month
    • Up to 50 products and 25 customers
    • GST-ready billing (CGST/SGST)
    • Expense tracker and dashboard
    • "Made with J-Gene Billing" on your invoices

    Free is free for as long as you need it. You can see every paid feature in the app and upgrade whenever you need one.

    Compare plans
    Which plan do I need for a feature?
    • Standard: unlimited products, customers and quotations, 3,000 bills and invoices a year, low-stock email alerts, no J-Gene branding.
    • Business: everything in Standard plus unlimited bills, reports and analytics, advanced inventory, Excel/CSV import, customer ledger and payment reminders, sharing by link, WhatsApp and email, and up to 3 users.
    • Enterprise: everything in Business plus unlimited users with an activity log, multiple branches, daily backups and API access.
    Full plan comparison
    Will I lose my data if I upgrade?

    No. Upgrading only changes what your account can do. Your products, customers, bills, invoices, quotations and expenses stay exactly as they are.

    What happens when my paid plan ends?

    Your account moves to the Free plan. Nothing is deleted: all your records stay and you can still view them. Free plan limits apply to adding new things, and paid features ask you to upgrade again.

    Is there a free trial?

    Instead of a time-limited trial, J Gene Billing has a Free plan you can keep using, and a live demo pre-loaded with sample data where you can try every paid feature without signing up.

    About J Gene Billing
    How do payments and renewals work?

    Paid plans are billed yearly through Razorpay's secure checkout, and renew automatically each year. We never see or store your card details.

    Refund policy

    Account & team

    Signing in, passwords and working with your team.

    Do I need a separate account for each J Gene product?

    No. One J Gene account signs you in to J Gene Billing and J Gene Sign.

    How do I reset my password?
    1. Go to auth.j-gene.com/forgot-password.
    2. Enter the email address you sign in with.
    3. Use the code we email you to choose a new password.
    Reset password
    How do I add team members?

    Team members are on the Business plan (up to 3 users, including you) and Enterprise (unlimited). The account owner invites them from Settings → Team.

    • Each person signs in with their own email and sees only what their role allows.
    • Roles are Manager and Cashier.
    • On Enterprise you can also limit a team member to one branch, and see who did what in the activity log.
    How do I contact support?

    Email or WhatsApp us, Monday to Friday, 9:00 AM to 6:00 PM IST, or send a message from the contact page. Tell us which product you're using and what you need.

    Help & support