API Access

Call Paperwork tools from your own product with one API key. Get structured JSON responses, track background jobs and receive signed webhooks from supported endpoints.

Request demo

What you get

API keys

Keys for your organization, sent as a Bearer token. One key works for every tool you have enabled.

Files or links

PDFs and images, plus Excel, CSV and email files for document scenarios. Upload or pass HTTPS links; bank statements are read from your Paperwork file storage.

Signed webhooks

Fraud detection and document automation jobs post their result to your URL with an HMAC signature, and retry if your endpoint is down.

Status endpoints

Every background job has a status URL you can poll, with or without a webhook.

Dashboard

The same tools in a web dashboard for testing, manual reviews and teams that are not integrated yet.

Paper OS

AI agents that run the tools on a case and prepare the decision for your analysts.

One call to start a check

Start a background job with a file link and a webhook. The response comes back at once with a job id; the result arrives on your webhook when it is ready.

Bearer API key
JSON in, JSON out
Signed webhook
Status URL
curl -X POST https://api.paperwork.to/api/v1/fraud-detection/async \
  -H "Authorization: Bearer sk-paperwork-..." \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "url": "https://files.example.com/statement.pdf" }],
    "document_type": "auto",
    "webhook_url": "https://you.example.com/paperwork",
    "webhook_secret": "your-secret"
  }'

{
  "job_id": "c1f0...",
  "status": "pending",
  "files_count": 1,
  "status_url": "/api/v1/fraud-detection/status/c1f0..."
}

From key to production

1

Get a key

We enable the tools for your organization and you create an API key in the dashboard.

2

Try in the dashboard

Upload a few of your own files and look at the results before writing code.

3

Integrate

Call the endpoints from your backend using the examples in the API reference.

4

Go live

Add webhooks for long jobs and send real traffic.

Frequently asked questions

Have a question that is not here?

How do we authenticate?

With an API key sent as a Bearer token. Keys start with sk-paperwork- and are created per organization in the dashboard.

Do we have to wait for long jobs?

No. Long jobs run in the background and return a job ID at once. Poll the status endpoint, or, for fraud detection and document automation, pass a webhook URL and secret and the signed result is posted to you.

Which files can we send?

Supported formats depend on the tool. Bank Statement Analysis and Invoice Processing accept PDFs. Fraud Detection and Emirates ID Verification also accept images. Document Automation supports PDFs, images, spreadsheets, CSV, text and email files. See each endpoint for upload and file-link requirements.

Can we use the dashboard while an integration is being built?

Yes. Your operations team can run checks and review results in the dashboard while developers connect the API. Use representative files there to understand the output your integration needs to handle.

What if a result webhook does not reach us?

Keep the job ID and query its status to retrieve the result. Fraud Detection and Document Automation also retry failed webhook deliveries. Your integration can use both delivery methods.

Start integrating

Tell us which tools you need, and we will set up your organization and a test key.