Bank statement API

curl -sS https://klarbon.app/api/v1/bank/convert \
  -H "Authorization: Bearer $KLARBON_API_KEY" \
  -H "Idempotency-Key: statement-2026-11-04-csv" \
  -F "file=@statement.xml;type=application/xml" \
  -F target=bank-csv \
  -o result.json
jq -e '.ok' result.json > /dev/null || { jq -r '.error + ": " + .message' result.json; exit 1; }
jq -e '.status == "converted"' result.json > /dev/null || { jq -r '"Klarbon needs " + .need' result.json; exit 1; }
jq -r '.files[0].content' result.json | base64 --decode > "$(jq -r '.files[0].filename' result.json)"

import { readFile, writeFile } from "node:fs/promises"

type KlarbonFile = { content: string; filename: string; mime: string; bytes: number }
type Failure = { ok: false; error: string; message: string }
type Converted = { ok: true; status: "converted"; files: KlarbonFile[]; credits: { spent: number; balance: number } }
type Need = { ok: true; status: "need"; need: string; resume: string }

const form = new FormData()
form.append("file", new Blob([await readFile("statement.xml")], { type: "application/xml" }), "statement.xml")
form.append("target", "bank-csv")

const response = await fetch("https://klarbon.app/api/v1/bank/convert", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KLARBON_API_KEY}`,
    "Idempotency-Key": "statement-2026-11-04-csv",
  },
  body: form,
})
const result = (await response.json()) as Converted | Need | Failure
if (!result.ok) throw new Error(`${response.status} ${result.error}: ${result.message}`)
if (result.status === "need") throw new Error(`Klarbon needs ${result.need}: send it with resume`)
for (const file of result.files) await writeFile(file.filename, Buffer.from(file.content, "base64"))
console.log(`${result.files.length} file(s) written, ${result.credits.balance} credits left`)

import base64
import os

import requests

with open("statement.xml", "rb") as upload:
    response = requests.post(
        "https://klarbon.app/api/v1/bank/convert",
        headers={
            "Authorization": f"Bearer {os.environ['KLARBON_API_KEY']}",
            "Idempotency-Key": "statement-2026-11-04-csv",
        },
        files={"file": ("statement.xml", upload, "application/xml")},
        data={"target": "bank-csv"},
        timeout=120,
    )
result = response.json()
if not result["ok"]:
    raise SystemExit(f"{response.status_code} {result['error']}: {result['message']}")
if result["status"] == "need":
    raise SystemExit(f"Klarbon needs {result['need']}: send it with resume")
for written in result["files"]:
    with open(written["filename"], "wb") as output:
        output.write(base64.b64decode(written["content"]))
print(len(result["files"]), "file(s) written,", result["credits"]["balance"], "credits left")

<?php
$curl = curl_init('https://klarbon.app/api/v1/bank/convert');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('KLARBON_API_KEY'),
        'Idempotency-Key: statement-2026-11-04-csv',
    ],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('statement.xml', 'application/xml', 'statement.xml'),
        'target' => 'bank-csv',
    ],
]);
$body = curl_exec($curl);
if ($body === false) {
    fwrite(STDERR, curl_error($curl) . "\n");
    exit(1);
}
$result = json_decode($body, true);
if (!$result['ok']) {
    $status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
    fwrite(STDERR, "$status {$result['error']}: {$result['message']}\n");
    exit(1);
}
if ($result['status'] === 'need') {
    fwrite(STDERR, "Klarbon needs {$result['need']}: send it with resume\n");
    exit(1);
}
foreach ($result['files'] as $written) {
    file_put_contents($written['filename'], base64_decode($written['content']));
}
echo count($result['files']) . " file(s) written, {$result['credits']['balance']} credits left\n";

using System.Net.Http.Headers;
using System.Text.Json;

using var http = new HttpClient();
var key = Environment.GetEnvironmentVariable("KLARBON_API_KEY");
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", key);

var upload = new ByteArrayContent(await File.ReadAllBytesAsync("statement.xml"));
upload.Headers.ContentType = new MediaTypeHeaderValue("application/xml");

using var request = new HttpRequestMessage(HttpMethod.Post, "https://klarbon.app/api/v1/bank/convert?target=bank-csv") { Content = upload };
request.Headers.Add("Idempotency-Key", "statement-2026-11-04-csv");
using var response = await http.SendAsync(request);
using var json = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
var result = json.RootElement;
if (!result.GetProperty("ok").GetBoolean())
{
    Console.Error.WriteLine($"{(int)response.StatusCode} {result.GetProperty("error")}: {result.GetProperty("message")}");
    return 1;
}
if (result.GetProperty("status").GetString() == "need")
{
    Console.Error.WriteLine($"Klarbon needs {result.GetProperty("need")}: send it with resume");
    return 1;
}
foreach (var written in result.GetProperty("files").EnumerateArray())
{
    await File.WriteAllBytesAsync(written.GetProperty("filename").GetString()!,
        Convert.FromBase64String(written.GetProperty("content").GetString()!));
}
Console.WriteLine($"{result.GetProperty("files").GetArrayLength()} file(s) written, {result.GetProperty("credits").GetProperty("balance")} credits left");
return 0;