Quick start

Upload a document, then poll status_url until it completes.

Terminal

pip install kita

Python

import os, time, requests

BASE = "https://api.kita.ai/api/v1"
headers = {"Authorization": f"Bearer {os.environ['KITA_API_KEY']}"}

# 1. Upload
res = requests.post(
  f"{BASE}/documents",
  headers=headers,
  files={"file": open("statement.pdf", "rb")},
  data={"document_type": "bank_statement"},
).json()

# 2. Poll until it finishes
while True:
  job = requests.get(f"{BASE}/documents/jobs/{res['document_id']}", headers=headers).json()
  if job["status"] in ("completed", "failed"):
      break
  time.sleep(3)

print(job["status"], job.get("result"))

The upload returns 202 Accepted:

{
  "success": true,
  "document_id": 42,
  "job_id": "a1b2c3d4-...",
  "status": "pending",
  "status_url": "/api/v1/documents/jobs/42"
}

Prefer webhooks over polling

Pass webhook_url on upload and Kita will POST to it when processing completes or fails. See Webhooks.