DEVELOPERS

From file to verified JSON in one request.

Clean REST APIs, signed webhooks, predictable errors, and a sandbox that behaves like production.

POST /v1/documents

{
  "file_url": "https://…/invoice.pdf",
  "document_type": "invoice",
  "workflow": "ap-review"
}

202 Accepted

QUICKSTART

Three steps to structured data.

Send a document, receive a completed event, and use the extracted fields or review URL in your workflow.

1

Authenticate

Create a sandbox key in the portal and pass it as a bearer token.

Authorization: Bearer sun_test_••••
2

Submit

Upload a file or provide a signed URL with optional workflow context.

POST /v1/documents
3

Consume

Receive a webhook when extraction and configured decision rules complete.

document.completed

A FRIENDLY API

Useful defaults, full control.

The same endpoint supports invoices, receipts, statements, and custom documents. Add workflow context when you want matching, risk rules, or review.

curl https://api.sunofia.com/v1/documents \
  -H "Authorization: Bearer $SUNOFIA_API_KEY" \
  -F "file=@invoice.pdf" \
  -F "document_type=invoice" \
  -F "workflow=ap-review"

PLATFORM SURFACES

Everything needed for production.

API reference

Documents

Submit, retrieve, list, and delete documents and structured outputs.

View reference →
Events

Webhooks

Subscribe to processing, review, decision, and export lifecycle events.

Check status →
Operations

Review workspace

Inspect source documents, correct fields, and resolve exceptions.

Open portal →

RELIABLE BY DEFAULT

Ship with confidence.

Idempotency keys, retry-safe webhooks, explicit rate-limit headers, request IDs, and consistent error objects make failure modes predictable.

99.9% production uptime target<60s standard document target256-bit encryption at rest24/7 automated monitoring