API
Connect AI clerks to your own systems
Send documents from your ERP, mailbox robot or scanner and get the same checked rows you see in the cabinet. Results can also be pushed to you by a signed webhook.
https://rowcert.com/api/v1
1.Authenticate
Create a token in Settings → API and webhooks. Send it as a Bearer token. List the AI clerks available to your company:
curl https://rowcert.com/api/v1/workflows \
-H "Authorization: Bearer ack_your_token"2.Process documents
Send one or more files with the clerk's identifier (a ready clerk's slug or your own clerk's id). The call returns when the table is ready, usually within seconds.
curl https://rowcert.com/api/v1/runs \
-H "Authorization: Bearer ack_your_token" \
-F workflow=accounting-invoice-line-item-extractor \
-F files=@invoice-0412.pdf
# 200 OK
{
"id": "6f1c…",
"status": "completed",
"pages": 1,
"summary": { "vendor_name": "Northwind Office Supplies", "total_gross_amount": 649.76 },
"rows": [ { "sku_or_code": "A-221", "quantity": 10, "unit_price": 24, "line_total_net": 240 } ]
}3.Read a run
Every run is kept in your archive. Read it again at any time, including corrections your team made in the grid.
curl https://rowcert.com/api/v1/runs/6f1c… \
-H "Authorization: Bearer ack_your_token"4.Receive results by webhook
Set an https URL in Settings. After each completed run, from the cabinet or the API, we send the result and sign it. Verify the signature before you trust the payload:
// POST to your URL after every completed run
// Header: X-Rowcert-Signature: sha256=<hex>
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(rawBody: string, header: string, secret: string) {
const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}
// Body: { "event": "run.completed", "id": "…", "workflow": "…", "files": [...], "pages": 1, "summary": {...}, "rows": [...] }Limits
- Up to 10 files and 4 MB per API call; up to 60 pages.
- PDF, JPG, PNG, WEBP and CSV.
- Pages are billed like cabinet runs: your own AI key or platform credits.
- Original files are deleted after 24 hours; the extracted data stays in your archive.
- Up to 30 runs per minute per company (HTTP 429 with Retry-After above that).