API reference & guide

Overview

Base URL: https://tool.accohub.in/api/v1. All requests use HTTPS and return JSON (except file downloads). Conversion is asynchronous:

1. Upload a statement → you get an id.
2. Poll its status until it is done (usually a few seconds; scanned statements take longer).
3. Fetch the transactions as JSON, or download Excel / CSV. Credits are used once, on the first fetch.

Authentication

Create a key on your Account page (needs an active Saver Combo). The full key is shown once — store it in a secret manager. Send it in the Authorization header:

Authorization: Bearer acc_1a2b3c4d5e6f_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

You can have up to 3 active keys and revoke any of them instantly. Never put a key in a browser, mobile app or public repository — call the API from your server.

Quick start

# 1. upload
curl -X POST https://tool.accohub.in/api/v1/statements \
  -H "Authorization: Bearer $ACCOHUB_KEY" \
  -F "file=@statement.pdf" -F "password=" -F "doc_type=auto"
# → {"id":"Gx7…","status":"queued"}

# 2. poll
curl https://tool.accohub.in/api/v1/statements/Gx7… -H "Authorization: Bearer $ACCOHUB_KEY"

# 3. transactions as JSON (uses credits once)
curl https://tool.accohub.in/api/v1/statements/Gx7…/transactions -H "Authorization: Bearer $ACCOHUB_KEY"

import os, time, requests

API = "https://tool.accohub.in/api/v1"
H = {"Authorization": f"Bearer {os.environ['ACCOHUB_KEY']}"}

with open("statement.pdf", "rb") as f:
    job = requests.post(f"{API}/statements", headers=H, files={"file": f}).json()

while True:
    s = requests.get(f"{API}/statements/{job['id']}", headers=H).json()
    if s["status"] in ("done", "error"):
        break
    time.sleep(2)

data = requests.get(f"{API}/statements/{job['id']}/transactions", headers=H).json()
print(len(data["transactions"]), "rows")

import fs from "node:fs";

const API = "https://tool.accohub.in/api/v1";
const H = { Authorization: `Bearer ${process.env.ACCOHUB_KEY}` };

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("statement.pdf")]), "statement.pdf");
const job = await (await fetch(`${API}/statements`, { method: "POST", headers: H, body: form })).json();

let s;
do {
  await new Promise((r) => setTimeout(r, 2000));
  s = await (await fetch(`${API}/statements/${job.id}`, { headers: H })).json();
} while (s.status === "queued" || s.status === "running");

const data = await (await fetch(`${API}/statements/${job.id}/transactions`, { headers: H })).json();
console.log(data.transactions.length, "rows");

Limits

Need higher limits? Email us.

Credits & billing

One credit converts one statement page (spreadsheet/CSV statements: one credit per 60 rows). A conversion is charged once, the first time you fetch its transactions or file — failed conversions are never charged. Credits are the same ones you buy on the pricing page; with an active Saver Combo they cost ₹1 each. Free statements are for the website only.

Errors

Errors return a JSON body {"error": {"code": "…", "message": "…"}}.

Security best practices

• Keep keys on your server; rotate them by creating a new key and revoking the old one.
• Use one key per system so you can revoke one without touching the others.
• Retry 429 and 503 with exponential back-off; don't hammer the API.
• Delete results you've stored as soon as you've imported them.

Data retention

Uploaded files are deleted as soon as reading finishes. Results are kept only for 30 minutes (or until you call DELETE) so you can fetch them, then erased. We don't keep statement contents. See our Privacy Policy.